netdata README

The project's README from github.com/netdata/netdata. As one markdown file: README.md.

Netdata Netdata

X-Ray Vision for your infrastructure!

Every Metric, Every Second. No BS.


GitHub Stars
Live Demo Latest release Latest nightly build
Discourse topics GitHub Discussions
CII Best Practices Coverity Scan

User base Servers monitored Sessions served Docker Hub pulls

Visit our Home Page


MENU: WHO WE ARE | KEY FEATURES | GETTING STARTED | HOW IT WORKS | FAQ | DOCS | COMMUNITY | CONTRIBUTE | LICENSE

[!WARNING] People get addicted to Netdata. Once you use it on your systems, there's no going back.

Platforms


WHO WE ARE

Netdata is an open-source, real-time infrastructure monitoring platform. Monitor, detect, and act across your entire infrastructure.

Core Advantages:

With Netdata, you get real-time, per-second updates. Clear insights at a glance, no complexity.

All heroes have a great origin story. Click to discover ours.

In 2013, at the company where Costa Tsaousis was COO, a significant percentage of their cloud-based transactions failed silently, severely impacting business performance.

Costa and his team tried every troubleshooting tool available at the time. None could identify the root cause. As Costa later wrote:

“I couldn’t believe that monitoring systems provide so few metrics and with such low resolution, scale so badly, and cost so much to run.”

Frustrated, he decided to build his own monitoring tool, starting from scratch.

That decision led to countless late nights and weekends. It also sparked a fundamental shift in how infrastructure monitoring and troubleshooting are approached, both in method and in cost.

Most Energy-Efficient Monitoring Tool

Energy Efficiency Energy efficiency

According to the University of Amsterdam study, Netdata is the most energy-efficient tool for monitoring Docker-based systems. The study also shows Netdata excels in CPU usage, RAM usage, and execution time compared to other monitoring solutions.


Key Features

Feature Description What Makes It Unique
Real-Time Per-second data collection and processing Works in a beat – click and see results instantly
Zero-Configuration Automatic detection and discovery Auto-discovers everything on the nodes it runs
ML-Powered Unsupervised anomaly detection Trains multiple ML models per metric at the edge
Long-Term Retention High-performance storage ~0.5 bytes per sample with tiered storage for archiving
Advanced Visualization Rich, interactive dashboards Slice and dice data without query language
Extreme Scalability Native horizontal scaling Parent-Child centralization with multi-million samples/s
Complete Visibility From infrastructure to applications Simplifies operations and eliminates silos
Edge-Based Processing at your premises Distributes code instead of centralizing data

[!NOTE]
Want to put Netdata to the test against Prometheus? Explore the full comparison.


Netdata Ecosystem

This three-part architecture enables you to scale from single nodes to complex multi-cloud environments:

Component Description License
Netdata Agent • Core monitoring engine
• Handles collection, storage, ML, alerts, exports
• Runs on servers, cloud, K8s, IoT
• Zero production impact
GPL v3+
Netdata Cloud • Enterprise features
• User management, RBAC, horizontal scaling
• Centralized alerts
• Free community tier
• No metric storage centralization
Netdata UI • Dashboards and visualizations
• Free to use
• Included in standard packages
• Latest version via CDN
NCUL1

What You Can Monitor

With Netdata you can monitor all these components across platforms:

Component Linux FreeBSD macOS Windows
System Resources
CPU, Memory and system shared resources
Full Yes Yes Yes
Storage
Disks, Mount points, Filesystems, RAID arrays
Full Yes Yes Yes
Network
Network Interfaces, Protocols, Firewall, etc
Full Yes Yes Yes
Hardware & Sensors
Fans, Temperatures, Controllers, GPUs, etc
Full Some Some Some
O/S Services
Resources, Performance and Status
Yes
systemd
- - -
Processes
Resources, Performance, OOM, and more
Yes Yes Yes Yes
System and Application Logs Yes
systemd-journal
- - Yes
Windows Event Log, ETW
Network Connections
Live TCP and UDP sockets per PID
Yes - - -
Containers
Docker/containerd, LXC/LXD, Kubernetes, etc
Yes - - -
VMs (from the host)
KVM, qemu, libvirt, Proxmox, etc
Yes
cgroups
- - Yes
Hyper-V
Synthetic Checks
Test APIs, TCP ports, Ping, Certificates, etc
Yes Yes Yes Yes
Packaged Applications
nginx, apache, postgres, redis, mongodb,
and hundreds more
Yes Yes Yes Yes
Cloud Provider Infrastructure
AWS, GCP, Azure, and more
Yes Yes Yes Yes
Custom Applications
OpenMetrics, StatsD and soon OpenTelemetry
Yes Yes Yes Yes

On Linux, you can continuously monitor all kernel features and hardware sensors for errors, including Intel/AMD/Nvidia GPUs, PCI AER, RAM EDAC, IPMI, S.M.A.R.T, Intel RAPL, NVMe, fans, power supplies, and voltage readings.


Getting Started

You can install Netdata on all major operating systems. To begin:

1. Install Netdata

Choose your platform and follow the installation guide:

[!NOTE] You can access the Netdata UI at http://localhost:19999 (or http://NODE:19999 if remote).

2. Configure Collectors

Netdata auto-discovers most metrics, but you can manually configure some collectors:

3. Configure Alerts

You can use hundreds of built-in alerts and integrate with:

email, Slack, Telegram, PagerDuty, Discord, Microsoft Teams, and more.

[!NOTE]
Email alerts work by default if there's a configured MTA.

4. Configure Parents

You can centralize dashboards, alerts, and storage with Netdata Parents:

[!NOTE]
You can use Netdata Parents for central dashboards, longer retention, and alert configuration.

5. Connect to Netdata Cloud

Sign in to Netdata Cloud and connect your nodes for:

[!NOTE]
Netdata Cloud is optional. Your data stays in your infrastructure.

Live Demo Sites

See Netdata in action
FRANKFURT | NEWYORK | ATLANTA | SANFRANCISCO | TORONTO | SINGAPORE | BANGALORE
These demo clusters run with default configuration and show real monitoring data.
Choose the instance closest to you for the best performance.


How It Works

With Netdata you can run a modular pipeline for metrics collection, processing, and visualization.

flowchart TB
  A[Netdata Agent]:::mainNode
  A1(Collect):::green --> A
  A2(Store):::green --> A
  A3(Learn):::green --> A
  A4(Detect):::green --> A
  A5(Check):::green --> A
  A6(Stream):::green --> A
  A7(Archive):::green --> A
  A8(Query):::green --> A
  A9(Score):::green --> A

  classDef green fill:#bbf3bb,stroke:#333,stroke-width:1px,color:#000
  classDef mainNode fill:#f0f0f0,stroke:#333,stroke-width:1px,color:#333

With each Agent you can:

  1. Collect – Gather metrics from systems, containers, apps, logs, APIs, and synthetic checks.
  2. Store – Save metrics to a high-efficiency, tiered time-series database.
  3. Learn – Train ML models per metric using recent behavior.
  4. Detect – Identify anomalies using trained ML models.
  5. Check – Evaluate metrics against pre-set or custom alert rules.
  6. Stream – Send metrics to Netdata Parents in real time.
  7. Archive – Export metrics to Prometheus, InfluxDB, OpenTSDB, Graphite, and others.
  8. Query – Access metrics via an API for dashboards or third-party tools.
  9. Score – Use a scoring engine to find patterns and correlations across metrics.

[!NOTE]
Learn more: Netdata's architecture

Agent Capabilities

With the Netdata Agent, you can use these core capabilities out-of-the-box:

Capability Description
Comprehensive Collection • 800+ integrations
• Systems, containers, VMs, hardware sensors
• OpenMetrics, StatsD, and logs
• OpenTelemetry support coming soon
Performance & Precision • Per-second collection
• Real-time visualization with 1-second latency
• High-resolution metrics
Edge-Based ML • ML models trained at the edge
• Automatic anomaly detection per metric
• Pattern recognition based on historical behavior
Advanced Log Management • Direct systemd-journald and Windows Event Log integration
• Process logs at the edge
• Rich log visualization
Observability Pipeline • Parent-Child relationships
• Flexible centralization
• Multi-level replication and retention
Automated Visualization • NIDL data model
• Auto-generated dashboards
• No query language needed
Smart Alerting • Pre-configured alerts
• Multiple notification methods
• Proactive detection
Low Maintenance • Auto-detection
• Zero-touch ML
• Easy scalability
• CI/CD friendly
Open & Extensible • Modular architecture
• Easy to customize
• Integrates with existing tools

CNCF Membership

CNCF Logo
Netdata actively supports and is a member of the Cloud Native Computing Foundation (CNCF).
It is one of the most starred projects in the CNCF landscape.


FAQ

Is Netdata secure?

Yes. Netdata follo

netdata (netdata/netdata)

Searching Database…

这是什么?Netdata 是一个开源的实时基础设施监控平台,能够以秒为单位采集指标,将其可视化,并利用机器学习检测异常。
它是独立的应用,还是需要单独的仪表盘服务?它是一个需要安装在每台机器上的代理程序,自带内置界面;另外还有一个可选的云端服务(Netdata Cloud),用于集中查看多节点仪表盘。
我该怎么让它跑起来?在你的操作系统上安装 Netdata Agent(提供 Linux、macOS、FreeBSD、Windows、Docker 或 Kubernetes 的安装指南),然后可以在本地通过 http://localhost 访问界面,安装完成后也可以远程访问。
安装前需要准备什么特别的东西吗,比如数据库?不需要外部数据库;Netdata 使用自带的分层时序存储,邮件告警只需配置好 MTA(邮件传输代理)即可。
每个操作系统的支持范围都一样吗?不一样。Linux 几乎所有方面都获得“完整”支持(内核、容器、日志、虚拟机等),而 FreeBSD、macOS 和 Windows 只能部分支持硬件传感器、容器和进程级网络连接等功能(标注为“是”或“部分”)。
这东西适合谁用——单台服务器还是大规模机群?它可以从单个节点扩展到复杂的多云环境,通过 Parent-Child 架构实现集中管理和横向扩展。
只能在 Linux 上用吗,还是别的系统也行?它可以运行在 Linux、FreeBSD、macOS 和 Windows 上,也支持 Docker 和 Kubernetes 部署,不过 Linux 的功能覆盖最全面。
我的数据会被发送到 Netdata 的服务器吗?不会,默认情况下指标数据只保存在你自己的基础设施上;连接 Netdata Cloud 是可选的,而且不会把指标存储集中到云端。
异常检测是怎么工作的?Netdata 直接在边缘端(即节点本身)为每个指标训练多个无监督机器学习模型,利用近期的历史行为来标记异常,无需把数据发送到其他地方。
开箱即用支持多少种集成?内置超过 800 种集成,涵盖系统、容器、虚拟机、硬件传感器、OpenMetrics、StatsD 和日志等,OpenTelemetry 支持也在计划中。
我需要自己写查询语句才能看到仪表盘吗?不需要,Netdata 会基于其 NIDL 数据模型自动生成丰富的交互式仪表盘,无需任何查询语言。
作者为什么要自己做这个,而不用现有的监控工具?创始人 Costa Tsaousis 在他的公司里,现有监控系统无法诊断无声的交易失败:它们提供的指标太少、分辨率太低,而且扩展性很差,于是他动手做了这个。
Creator
netdata
Size
327.9 MB
Stars
81K
Age
13y
Commits · 90 Days