titpetric/netdata

netdata Docker镜像

镜像概述

本镜像用于构建和运行Netdata守护进程，实现主机实例的实时性能监控。Netdata专注于性能和内存使用情况，提供近期服务器指标的详细洞察，现已支持Docker化部署。更多项目信息请访问：https://github.com/firehol/netdata

注意：Netdata项目包含遥测功能，使用Google Analytics聚合遥测数据（已开启IP***化）。目前暂无运行时 opt-out 机制（需跟踪上游https://github.com/netdata/netdata/issues/7404）。GDPR第6条和第89(1)条明确允许统计目的的处理无需opt-in，也可通过编译时禁用遥测实现opt-out。更多遥测信息请参考：***统计文档

核心功能

• 实时数据收集：每秒采集服务器性能数据（CPU、网络、磁盘、应用等）
• 多维度指标：覆盖系统资源、容器状态、应用性能等多维度监控
• 灵活告警：支持邮件、Slack、、、Pushbullet等告警方式
• 可配置性：支持自定义监听IP、参数、告警规则及配置覆盖
• 容器集成：可监控Docker容器指标（需挂载docker.sock）

使用场景

• 个人/企业服务器性能实时监控
• Docker容器集群状态跟踪
• 多节点服务器的集中流媒体监控
• 关键服务的异常告警与故障排查

配置说明

启动容器

Docker CLI

bash
docker run -d --cap-add SYS_PTRACE \
           -v /proc:/host/proc:ro \
           -v /sys:/host/sys:ro \
           -p 19999:19999 \
           --restart unless-stopped \
           docker.xuanyuan.run/titpetric/netdata

注意：若无需容器开机自启，可移除--restart unless-stopped参数。

Docker Compose

bash
mkdir netdata && cd netdata && wget https://raw.githubusercontent.com/titpetric/netdata/master/docker-compose.yml
docker-compose up -d

注意：若无需自启，可移除restart: unless-stopped选项。

访问监控数据

打开浏览器访问：http://服务器IP:19999 查看服务器状态。

关键配置选项

限制监听IP

通过NETDATA_IP环境变量指定监听IP（默认0.0.0.0）：

bash
-e NETDATA_IP=127.0.0.1

自定义参数

通过NETDATA_ARGS传递自定义参数：

bash
-e NETDATA_ARGS="-i 127.0.0.1"

邮件告警配置

设置SMTP参数实现邮件告警：

bash
-e SMTP_TO=user@example.com -e SMTP_USER=user -e SMTP_PASS=password -e SMTP_SERVER=smtp.example.com

容器监控

挂载docker.sock以监控容器指标：

bash
-v /var/run/docker.sock:/var/run/docker.sock:ro

安全提示：挂载docker.sock会暴露Docker管理API，若容器被入侵可能导致主机安全风险，建议使用https://github.com/titpetric/docker-proxy-acl实现安全转发。

流媒体监控

客户端节点配置：

bash
-e NETDATA_STREAM_DESTINATION=central-netdata:19999 -e NETDATA_STREAM_API_KEY=your-secret-key

中心节点配置：

bash
-e NETDATA_API_KEY_ENABLE_your-secret-key=1

其他注意事项

• 网络接口监控：容器内无法直接监控主机所有网络接口，可使用--net=host模式或fakenet.sh脚本（详见原文档）解决。
• 自定义配置覆盖：挂载卷到/etc/netdata/override以添加自定义告警、图表或配置。
• 版本选择：Docker Hub提供从1.4到最新版本的标签，latest标签与上游同步，旧标签更稳定。

更多详细配置请参考原项目文档或镜像GitHub仓库。