komodorio/komodor-agent Docker 镜像 - 轩辕镜像

Komodor Agent 镜像文档

概述

Komodor Agent 是一个轻量级的 Kubernetes 集群监控代理，专为收集、处理和发送 Kubernetes 集群数据而设计。该镜像提供了与 Komodor 平台集成的能力，使团队能够实时监控集群状态、跟踪部署变更、诊断问题并简化故障排除流程。

核心功能与特性

• 全面的数据收集：收集 Kubernetes 集群事件、资源元数据、部署历史和性能指标
• 实时监控：持续跟踪集群状态变化，提供实时告警和通知
• 变更追踪：记录所有集群资源变更，支持问题溯源和变更审计
• 集成能力：与 Komodor 平台无缝集成，提供统一的监控和管理界面
• 轻量级设计：资源占用低，对集群性能影响小
• 自动发现：自动发现集群中的新资源和服务
• 安全合规：支持加密数据传输和 RBAC 权限控制

使用场景与适用范围

• Kubernetes 集群监控与管理
• 容器化应用部署跟踪
• 集群故障排查与诊断
• 变更管理与审计
• DevOps 工作流集成
• 多集群集中监控
• CI/CD 部署验证

快速开始

使用 Helm 安装（推荐）

bash
# 添加 Komodor Helm 仓库
helm repo add komodorio [***]
helm repo update

# 安装 Komodor Agent
helm install komodor-agent komodorio/komodor-agent \
  --namespace komodor \
  --create-namespace \
  --set apiKey=<YOUR_KOMODOR_API_KEY>

使用 Docker 运行（用于测试）

bash
docker run -d \
  --name komodor-agent \
  -e K8S_NODE_NAME=<NODE_NAME> \
  -e API_KEY=<YOUR_KOMODOR_API_KEY> \
  -e CLUSTER_NAME=<CLUSTER_NAME> \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/kubernetes:/etc/kubernetes \
  -v /var/lib/kubelet:/var/lib/kubelet \
  komodorio/komodor-agent:latest

配置参数

环境变量

Helm Chart 配置

高级配置

自定义资源收集

可以通过配置文件自定义要收集的资源类型：

yaml
# config.yaml
resources:
  - name: deployments
    enabled: true
    interval: 30s
  - name: statefulsets
    enabled: true
    interval: 30s
  - name: daemonsets
    enabled: true
    interval: 30s
  - name: pods
    enabled: true
    interval: 15s

故障排除

常见问题

1. 代理无法连接到 Kubernetes API

   • 确保 Pod 具有正确的 RBAC 权限
   • 检查网络策略是否阻止了访问

2. 数据未显示在 Komodor 平台

   • 验证 API 密钥是否正确
   • 检查网络连接和防火墙规则
   • 查看代理日志获取详细错误信息

3. 高资源使用率

   • 调整资源请求和限制
   • 减少收集频率或要收集的资源类型

查看日志

bash
# 使用 Helm 安装时查看日志
kubectl logs -n komodor deployment/komodor-agent

# 使用 Docker 运行时查看日志
docker logs komodor-agent

相关资源

• Komodor 官方文档
• GitHub 仓库
• Komodor 平台
• Kubernetes 集成指南