outlyer/agent

Outlyer Agent 容器镜像

镜像概述

本镜像前身为Dataloop-docker，是Outlyer的容器指标收集工具，用于自动发现并监控Docker容器及其内部运行的服务，为用户提供容器性能数据。

核心功能

• 自动发现运行中的容器并创建虚拟监控代理
• 收集容器的CPU、内存、网络等关键指标（指标列表见https://github.com/dataloop/docker-alpine/tree/master/agent/METRICS.md%EF%BC%89
• 支持多种Linux系统（常规Linux、Amazon Linux、CentOS 6）
• 可配置代理、环境变量及标签等自定义参数
• 暴露HTTP端点（8000端口）返回代理指纹

使用场景

适用于需要监控Docker容器性能的场景，如容器化应用运维、资源利用率分析、故障排查等，支持不同Linux发行版的Docker环境。

配置说明

环境变量

• DATALOOP_AGENT_KEY（必填）：Outlyer账户的API密钥
• DATALOOP_NAME（可选）：代理在Outlyer中显示的名称，默认值为dataloop
• DATALOOP_TAGS（可选）：代理标签列表，以逗号分隔，默认值为docker
• DATALOOP_FINGERPRINT（可选）：现有指纹，用于保持数据关联
• DATALOOP_DEBUG（可选）：调试模式开关（yes/no或true/false），默认值为no

部署示例

常规Linux系统

bash
DATALOOP_AGENT_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DATALOOP_NAME=docker_container_name

docker run -d \
-e "DATALOOP_AGENT_KEY=${DATALOOP_AGENT_KEY}" \
-e "DATALOOP_NAME=${DATALOOP_NAME}" \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc:/rootfs/proc:ro \
-v /sys/fs/cgroup:/rootfs/sys/fs/cgroup:ro \
outlyer/agent:latest

Amazon Linux（ECS）

bash
DATALOOP_AGENT_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DATALOOP_NAME=docker_container_name

docker run -d \
-e "DATALOOP_AGENT_KEY=${DATALOOP_AGENT_KEY}" \
-e "DATALOOP_NAME=${DATALOOP_NAME}" \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc:/rootfs/proc:ro \
-v /cgroup:/rootfs/sys/fs/cgroup:ro \
outlyer/agent:latest

CentOS 6

先安装cgroups：

bash
sudo yum install -y libcgroup

再运行容器：

bash
DATALOOP_AGENT_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DATALOOP_NAME=docker_container_name

docker run -d \
-e "DATALOOP_AGENT_KEY=${DATALOOP_AGENT_KEY}" \
-e "DATALOOP_NAME=${DATALOOP_NAME}" \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
-v /proc:/rootfs/proc:ro \
-v /cgroup:/rootfs/sys/fs/cgroup:ro \
outlyer/agent:latest

代理设置

若需通过代理访问，可添加环境变量：

bash
docker run -e HTTP_PROXY=http://proxy:port ... outlyer/agent:latest

暴露端口

容器暴露8000端口，可通过以下命令获取代理指纹：

bash
curl -XGET http://<container>:8000

故障排查

• 若未看到内存指标，需在内核参数中启用内存统计：cgroup_enable=memory swapaccount=1
• 如需获取容器CPU负载、网络连接等功能，建议使用--net host运行容器
• 可通过Slack（[***]

版本支持

已测试支持Docker >=1.7版本。

贡献

如需修改镜像，可提交Pull Request。镜像基于Alpine Linux和Scott Mebberson的基础镜像，使用s6进行进程管理。