Netdata · 实时基础设施监控平台（每秒指标、零配置）· 中文部署与使用全指南

项目仓库： https://github.com/netdata/netdata

开源协议：GPL v3+（Netdata Agent） · 形态：Agent 守护进程 + Web 仪表盘 · 平台：Linux / macOS / FreeBSD / Windows · 容器镜像：netdata/netdata · 默认 Web 端口：19999 · 指标采集粒度：每秒 · 集成：800+ collector

1 项目简介

Netdata（仓库名 netdata/netdata）是一个开源实时基础设施监控平台：每秒采集指标、零配置自动发现、开箱即用的 Web 仪表盘，主打"X-Ray Vision for your infrastructure"。它在被监控节点上跑一个 Agent，自动发现系统、容器、硬件传感器、数据库等指标，无需写查询语言就能看交互图表。

1.1 核心信息一览

1.2 适用场景

• 想在服务器上立刻看到 CPU、内存、磁盘、网络、容器的秒级实时曲线，不想配 Prometheus + Grafana 那套。
• 需要内置数百条告警规则，并能接 Slack / Telegram / 邮件。
• 多节点想通过 Netdata Parents 做中央化仪表盘与更长保留。

1.3 能力边界（官方口径）

• 零配置自动发现为主；部分 collector（如 SNMP）需手动配置。
• 数据默认留在本地（edge-based，不强制集中）；可用 Netdata Parents 集中。
• 可导出到 Prometheus / InfluxDB / OpenTSDB / Graphite 等。

2 功能特性

• 实时：每秒采集与处理，点开即看。
• 零配置自动发现：自动识别节点上的服务与指标。
• ML 异常检测：在边缘为每个指标训练多个无监督模型。
• 长期保留：约 0.5 字节 / 样本，分层存储归档。
• 交互仪表盘：切片分析无需查询语言。
• 可扩展：Parent-Child 横向扩展。
• 完整可见性：从基础设施到应用，OpenMetrics / StatsD / 日志。

3 官方界面预览

封面为 Netdata 官方标识。UI 访问 http://NODE:19999。官方提供在线 Live Demo（见仓库徽章链接）。

4 官方跳转链接汇总

5 前置要求

• Linux（推荐）/ macOS / FreeBSD / Windows。
• 磁盘：按本地保留时长估算，Netdata 存储效率很高。
• 端口 19999 开放（若远程访问）。

6 方式一：Docker 部署（官方）

官方推荐 host 网络模式以获得完整宿主指标：

docker run -d --name=netdata \
  --pid=host \
  --network=host \
  -v netdataconfig:/etc/netdata \
  -v netdatalib:/var/lib/netdata \
  -v netdatacache:/var/cache/netdata \
  -v /:/host/root:ro,rslave \
  -v /etc/passwd:/host/etc/passwd:ro \
  -v /etc/group:/host/etc/group:ro \
  -v /etc/localtime:/etc/localtime:ro \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  -v /etc/os-release:/host/etc/os-release:ro \
  -v /var/log:/host/var/log:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  --restart unless-stopped \
  --cap-add SYS_PTRACE \
  netdata/netdata

端口映射模式（不用 host 网络时）：

docker run -d --name=netdata \
  -p 19999:19999 \
  -v netdataconfig:/etc/netdata \
  -v netdatalib:/var/lib/netdata \
  -v netdatacache:/var/cache/netdata \
  -v /etc/passwd:/host/etc/passwd:ro \
  -v /etc/group:/host/etc/group:ro \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  --restart unless-stopped \
  netdata/netdata

7 方式二：一键脚本安装（Linux）

官方提供全 Linux 一键安装脚本（见文档链接 one-line-installer-for-all-linux-systems），按指引执行即可。安装后访问 http://localhost:19999。

# 安装后查看版本信息
docker exec netdata netdata -W buildinfo
# 进入容器排查
docker exec -it netdata bash

8 配置项说明

• 配置目录：/etc/netdata；自动发现为主，部分 collector 手动配（如 SNMP）。
• 告警：内置数百条规则，在文档配置渠道（email 默认在有 MTA 时生效）。
• Parents：通过 streaming 配置集中化仪表盘、告警与更长保留。
• Cloud：在 Netdata Cloud 登录后把节点接入，获得远程访问、多节点面板、RBAC。

9 常用运维命令

docker logs -f netdata
docker restart netdata
docker exec netdata netdata -W buildinfo   # 版本信息
docker-compose pull && docker-compose up -d   # 更新（compose 部署时）

10 常见故障排查

• 仪表盘打不开：确认 19999 映射 / host 网络模式下防火墙放行。
• 指标采集不全：host 网络 + --pid=host 并挂 /proc、/sys，才能拿到完整宿主指标。
• 告警没收到：检查是否配了对应渠道（email 需 MTA）。
• 想看版本 / 排错：docker exec netdata netdata -W buildinfo、docker exec -it netdata bash。

11 风险与合规说明

• GPL v3+ 许可；Netdata Agent 读宿主 /proc、/sys、日志等，容器以 --pid=host、SYS_PTRACE 运行，权限较大，远程访问务必加鉴权 / 反向代理，不要把 19999 裸露公网。
• 数据默认本地留存；接入 Netdata Cloud 会把指标同步到官方云，注意数据隐私权衡。
• 本文命令、端口、挂载项来自官方 README 与 packaging/docker 文档，随版本可能调整，以官方文档为准。