site24x7/docker-agent

Site24x7 Agent Docker镜像文档

镜像概述和主要用途

本镜像用于构建Site24x7 Agent容器的基础镜像，用户可通过该镜像配置并运行Site24x7 Agent，实现对主机系统的监控。通过容器化部署，简化Agent的安装和管理流程，适用于需要监控主机资源的场景。

核心功能和特性

• 容器化部署Site24x7监控代理，便捷集成到现有容器环境
• 支持通过环境变量配置主机名，灵活自定义监控标识
• 挂载主机必要系统目录（/proc、/sys、docker.sock）以获取系统和Docker容器信息

使用场景和适用范围

适用于需要通过容器方式部署Site24x7监控代理的服务器环境，尤其适合容器化管理的主机监控需求，可监控主机CPU、内存、磁盘、网络等系统资源。

使用方法和配置说明

快速启动

在服务器中执行以下命令，通过site24x7-agent容器监控主机：

bash
docker run -d --name site24x7-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys:/host/sys/:ro \
  -e KEY=<device_key> \
  site24x7/docker-agent:latest

参数说明：

• -v /var/run/docker.sock:/var/run/docker.sock:ro：只读挂载Docker套接字，用于监控Docker容器
• -v /proc/:/host/proc/:ro：只读挂载主机proc目录，用于获取系统进程信息
• -v /sys:/host/sys/:ro：只读挂载主机sys目录，用于获取系统硬件信息
• -e KEY=<device_key>：指定Site24x7设备密钥，替换<device_key>为实际密钥

配置

主机名配置

默认情况下，Agent容器使用主机docker info命令中的Name字段作为主机名。如需自定义，可通过修改/opt/site24x7/monagent/conf/monagent.cfg文件的hostname字段实现，最简单的方式是使用HOSTNAME环境变量：

bash
docker run -d --name site24x7-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys:/host/sys/:ro \
  -e KEY=<device_key> \
  -e HOSTNAME=<host_name> \
  site24x7/docker-agent:latest

参数说明：

• -e HOSTNAME=<host_name>：自定义监控主机名，替换<host_name>为实际主机标识

限制

• 只有挂载到容器中的卷才能上报磁盘指标

贡献

如果发现容器存在限制或缺陷，欢迎通过https://github.com/site24x7/docker-agent/issues%E6%8F%90%E4%BA%A4%E5%8F%8D%E9%A6%88%E3%80%82