yotascale/yotascale-kubernetes-agent

Yotascale Kubernetes Agent 镜像文档

镜像概述和主要用途

Yotascale Kubernetes Agent 是一款轻量级Docker镜像，专为从Kubernetes集群中摄取指标数据设计。该Agent通过集成Kubernetes API或kubelet接口，采集集群中的节点、Pod、容器等多层级指标，并支持将格式化后的指标数据转发至指定目标（如监控平台、分析系统），为Kubernetes集群的监控、性能分析和资源优化提供数据支撑。

核心功能和特性

核心功能

• 多维度指标采集：支持采集Kubernetes集群的节点指标（CPU/内存使用率、磁盘IO）、Pod指标（资源请求/限制、网络流量）、容器指标（CPU使用率、内存占用）等关键数据。
• Kubernetes原生集成：通过Kubernetes API或kubelet API获取数据，适配各类Kubernetes环境（包括托管集群如EKS/GKE/AKS及自建集群）。
• 数据转发能力：支持将采集的指标数据格式化后转发至外部系统（如Yotascale平台、Prometheus、日志分析工具等）。

关键特性

• 轻量级设计：镜像体积小，运行时资源占用低（默认CPU < 100m，内存 < 256Mi），适合资源受限环境。
• 灵活配置：支持通过环境变量或配置文件自定义采集规则（如指标类型、采集间隔）及数据输出目标。
• 多认证方式：兼容kubeconfig文件认证和集群内Service Account认证，适配不同部署场景。

使用场景和适用范围

典型使用场景

• 企业级Kubernetes监控：作为监控系统的数据源，为集群健康状态监控提供实时指标。
• 性能分析与优化：通过采集的资源使用数据，识别集群性能瓶颈并优化资源配置。
• 合规审计：记录集群资源使用历史数据，满足合规性审计需求。

适用范围

• 集群类型：支持AWS EKS、Google GKE、Azure AKS、阿里云ACK及自建Kubernetes集群（版本1.18+）。
• 部署模式：可通过Docker直接运行（适用于测试/边缘环境）或作为DaemonSet部署（适用于生产集群）。

使用方法和配置说明

Docker快速启动

通过docker run命令直接运行Agent（需提前准备Kubernetes配置文件）：

bash
docker run -d \
  --name yotascale-k8s-agent \
  -v /path/to/local/kubeconfig:/etc/yotascale/kubeconfig \  # 挂载kubeconfig文件
  -e KUBE_CONFIG=/etc/yotascale/kubeconfig \  # 指定kubeconfig路径
  -e METRIC_INTERVAL=30s \  # 指标采集间隔（默认30s）
  -e OUTPUT_DEST=https://your-yotascale-platform.example.com \  # 数据输出目标地址
  -e LOG_LEVEL=info \  # 日志级别
  yotascale/k8s-agent:latest

Docker Compose部署

通过docker-compose.yml配置文件管理部署（适用于多实例或依赖管理场景）：

yaml
version: '3.8'
services:
  yotascale-k8s-agent:
    image: docker.xuanyuan.run/yotascale/k8s-agent:latest
    container_name: yotascale-k8s-agent
    volumes:
      - ./kubeconfig:/etc/yotascale/kubeconfig  # 挂载本地kubeconfig
    environment:
      - KUBE_CONFIG=/etc/yotascale/kubeconfig
      - METRIC_TYPES=node,pod  # 仅采集节点和Pod指标
      - METRIC_INTERVAL=60s  # 采集间隔调整为1分钟
      - OUTPUT_DEST=https://yotascale-platform.example.com
      - LOG_LEVEL=info
    restart: always  # 容器退出后自动重启

Docker Compose配置示例

创建docker-compose.yml文件，定义完整部署配置：

yaml
version: '3.8'
services:
  yotascale-k8s-agent:
    image: docker.xuanyuan.run/yotascale/k8s-agent:latest
    volumes:
      - ./kubeconfig:/etc/yotascale/kubeconfig  # 挂载Kubernetes配置
      - ./config.yaml:/etc/yotascale/config.yaml  # 可选：挂载自定义配置文件
    environment:
      - KUBE_CONFIG=/etc/yotascale/kubeconfig
      - AUTH_MODE=kubeconfig  # 使用kubeconfig认证
      - METRIC_INTERVAL=30s
      - METRIC_TYPES=node,pod,container
      - OUTPUT_DEST=https://yotascale-platform.example.com
      - LOG_LEVEL=info
    restart: unless-stopped

核心配置参数说明

环境变量配置

配置文件配置（可选）

若需更复杂的配置（如自定义指标过滤规则、输出格式），可通过挂载配置文件/etc/yotascale/config.yaml实现，示例：

yaml
kubeConfig: /etc/yotascale/kubeconfig
metric:
  interval: 30s
  types:
    - node
    - pod
  filters:  # 可选：指标过滤规则
    pod:
      namespace: ["default", "kube-system"]  # 仅采集指定命名空间的Pod指标
output:
  dest: https://yotascale-platform.example.com
  timeout: 10s  # 数据发送超时时间
log:
  level: info
  format: json  # 日志格式：text/json

注意事项

• 权限要求：若使用kubeconfig认证，配置文件需包含足够权限（至少nodes、pods、pods/status资源的get和list权限）。
• 集群内部署：生产环境建议通过Kubernetes DaemonSet部署，使用Service Account认证，并挂载/var/run/secrets/kubernetes.io/serviceaccount目录。
• 资源限制：根据集群规模调整资源限制（建议单节点CPU限制100m，内存限制256Mi）。