热门搜索:
komodorio/komodor-agent
komodorio
Komodor Agent是一个Kubernetes集群监控代理，用于收集集群事件、资源状态和部署信息，帮助开发和运维团队实时监控、排查和解决Kubernetes环境中的问题。
下载次数: 0状态：社区镜像维护者：komodorio仓库类型：镜像最近更新：8 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Komodor Agent 镜像文档
概述
Komodor Agent 是一个轻量级的 Kubernetes 集群监控代理，专为收集、处理和发送 Kubernetes 集群数据而设计。该镜像提供了与 Komodor 平台集成的能力，使团队能够实时监控集群状态、跟踪部署变更、诊断问题并简化故障排除流程。
核心功能与特性
- 全面的数据收集：收集 Kubernetes 集群事件、资源元数据、部署历史和性能指标
- 实时监控：持续跟踪集群状态变化，提供实时告警和通知
- 变更追踪：记录所有集群资源变更，支持问题溯源和变更审计
- 集成能力：与 Komodor 平台无缝集成，提供统一的监控和管理界面
- 轻量级设计：资源占用低，对集群性能影响小
- 自动发现：自动发现集群中的新资源和服务
- 安全合规：支持加密数据传输和 RBAC 权限控制
使用场景与适用范围
- Kubernetes 集群监控与管理
- 容器化应用部署跟踪
- 集群故障排查与诊断
- 变更管理与审计
- DevOps 工作流集成
- 多集群集中监控
- CI/CD 部署验证
快速开始
使用 Helm 安装（推荐）
bash# 添加 Komodor Helm 仓库 helm repo add komodorio https://helm-charts.komodor.io helm repo update # 安装 Komodor Agent helm install komodor-agent komodorio/komodor-agent \ --namespace komodor \ --create-namespace \ --set apiKey=<YOUR_KOMODOR_API_KEY>
使用 Docker 运行（用于测试）
bashdocker 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
配置参数
环境变量
| 环境变量 | 描述 | 必需 | 默认值 |
|---|---|---|---|
API_KEY | Komodor 平台 API 密钥 | 是 | - |
CLUSTER_NAME | Kubernetes 集群名称 | 是 | - |
K8S_NODE_NAME | 运行代理的节点名称 | 否 | 主机名 |
LOG_LEVEL | 日志级别 (debug, info, warn, error) | 否 | info |
API_ENDPOINT | Komodor API 端点 | 否 | [***] |
PROXY_URL | 代理服务器 URL | 否 | - |
SKIP_TLS_VERIFY | 是否跳过 TLS 验证 | 否 | false |
Helm Chart 配置
| 参数 | 描述 | 默认值 |
|---|---|---|
apiKey | Komodor API 密钥 | "" |
clusterName | 集群名称 | "" |
image.repository | 镜像仓库 | komodorio/komodor-agent |
image.tag | 镜像标签 | latest |
resources | 资源限制和请求 | {} |
nodeSelector | 节点选择器 | {} |
tolerations | 容忍污点配置 | [] |
rbac.create | 是否创建 RBAC 资源 | true |
serviceAccount.create | 是否创建服务账户 | true |
高级配置
自定义资源收集
可以通过配置文件自定义要收集的资源类型：
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
故障排除
常见问题
-
代理无法连接到 Kubernetes API
- 确保 Pod 具有正确的 RBAC 权限
- 检查网络策略是否阻止了访问
-
数据未显示在 Komodor 平台
- 验证 API 密钥是否正确
- 检查网络连接和防火墙规则
- 查看代理日志获取详细错误信息
-
高资源使用率
- 调整资源请求和限制
- 减少收集频率或要收集的资源类型
查看日志
bash# 使用 Helm 安装时查看日志 kubectl logs -n komodor deployment/komodor-agent # 使用 Docker 运行时查看日志 docker logs komodor-agent
相关资源
- Komodor 官方文档
- https://github.com/komodorio/helm-charts/tree/master/charts/komodor-agent
- Komodor 平台
- Kubernetes 集成指南
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 komodor-agent 镜像标签
docker pull docker.xuanyuan.run/komodorio/komodor-agent:<标签>
DockerHub 原生拉取命令
docker pull komodorio/komodor-agent:<标签>
更多 komodor-agent 镜像推荐
datadog/agent
datadog
新Datadog Agent的Docker容器，用于运行该代理以收集、处理并发送监控数据至Datadog平台。
172 次收藏10亿+ 次下载
7 天前更新
portainer/agent
portainer
Portainer是一款高效的容器管理平台，您可将Kubernetes容器编排平台、Docker及Podman容器引擎等主流容器环境便捷连接至该平台，实现对各类容器环境的集中化管理、可视化监控与高效运维操作，有效简化复杂容器架构的管理流程，提升容器部署、维护的效率与安全性。
290 次收藏10亿+ 次下载
20 天前更新
docker/ucp-agent
Docker 官方工具与组件镜像
暂无描述
13 次收藏5亿+ 次下载
5 年前更新
grafana/agent
Grafana 可观测性平台
暂无描述
25 次收藏1亿+ 次下载
2 个月前更新
mirantis/ucp-agent
mirantis
暂无描述
1亿+ 次下载
13 天前更新
mirantis/ucp-agent-win
mirantis
暂无描述
1亿+ 次下载
13 天前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"