Go to file
Austin S. Hemmelgarn beaeafc1f9
Fixed argument handling in `.travis/trigger_docker_build.sh`. (#10546)
This should have gone in with #10545 but I forgot to commit it after
testing before opening the PR.
2021-01-22 09:35:04 -05:00
.github Switch to using GitHub Actions for publishing Docker images. (#10365) 2021-01-15 09:45:05 -05:00
.travis Fixed argument handling in `.travis/trigger_docker_build.sh`. (#10546) 2021-01-22 09:35:04 -05:00
aclk Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
backends Spelling md (#10508) 2021-01-18 07:43:43 -05:00
build Added support for using `/etc/cron.d` for auto-updates. (#9598) 2020-09-15 07:40:05 -04:00
build_external Spelling md (#10508) 2021-01-18 07:43:43 -05:00
claim Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
cli Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
collectors Update README.md on postgres collector (#10532) 2021-01-20 20:52:57 +03:00
contrib Fixed bundling of libwebsockets in binary packages. (#10460) 2021-01-11 08:21:22 -05:00
daemon Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
database Remove unused entries from structures (#10519) 2021-01-19 14:43:49 +02:00
diagrams Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
docs Make some tweaks/improvements to conf docs (#10528) 2021-01-21 14:01:54 -07:00
exporting Spelling md (#10508) 2021-01-18 07:43:43 -05:00
health Reduce the number of alarm updates on ACLK #10524 2021-01-19 17:02:34 +02:00
libnetdata Support multiple chart label keys in data queries (#10483) 2021-01-14 18:50:33 +02:00
packaging installer: update go.d.plugin version to v0.27.0 (#10544) 2021-01-22 15:47:54 +03:00
parser Spelling md (#10508) 2021-01-18 07:43:43 -05:00
registry Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
spawn Make libnetdata headers compilable by C++. (#10185) 2020-11-07 00:10:50 +00:00
streaming add `_is_k8s_node` label to the host labels (#10501) 2021-01-18 07:44:14 -05:00
system Fix systemd comment syntax (#10066) 2020-10-14 07:44:28 -04:00
tests Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
web add `_is_k8s_node` label to the host labels (#10501) 2021-01-18 07:44:14 -05:00
.clang-format Add clang-format. Update Contribution guidelines. (#6677) 2019-09-20 16:44:20 +02:00
.codacy.yml Improving the ACLK performance - initial changes (#8399) 2020-03-14 07:35:49 +01:00
.codeclimate.yml modularized all source code (#4391) 2018-10-15 23:16:42 +03:00
.csslintrc added codeclimate coverage 2017-01-06 18:01:57 +02:00
.dockerignore Adds Docker based build system for Binary Packages, CI/CD, Smoke Testing and Development. (#7735) 2020-01-28 05:51:18 +10:00
.eslintignore added codeclimate coverage 2017-01-06 18:01:57 +02:00
.eslintrc added codeclimate coverage 2017-01-06 18:01:57 +02:00
.gitattributes Add a .gitattributes file (#6381) 2019-07-05 11:54:32 +02:00
.gitignore Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
.lgtm.yml Split js 2 (#4581) 2018-11-08 11:37:06 +02:00
.mlc_config.json GitHub action markdown link check update (#10474) 2021-01-11 13:50:16 -05:00
.remarkignore add CHANGELOG.md to .remarkignore (#6671) 2019-08-15 16:41:08 -07:00
.remarkrc.js Change lint standard for lists (#10371) 2021-01-07 08:43:18 -07:00
.squash.yml Squash integration (#5566) 2019-09-16 16:49:31 +02:00
.travis.yml Properly handle arguments and responses for triggering Docker builds. (#10545) 2021-01-22 09:22:22 -05:00
.yamllint.yml github/workflow: disable `document-start` yamllint check (#8522) 2020-05-06 20:41:26 +03:00
BREAKING_CHANGES.md Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
BUILD.md Spelling md (#10508) 2021-01-18 07:43:43 -05:00
CHANGELOG.md [ci skip] create nightly packages and update changelog 2021-01-22 00:42:01 +00:00
CMakeLists.txt Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
CODE_OF_CONDUCT.md Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
CONTRIBUTING.md Updated contributing guidelines to suggest use of Draft PRs. (#10125) 2020-11-30 07:03:47 -05:00
CONTRIBUTORS.md web/gui: Added support for per series styling for dygraphs (#8668) 2021-01-04 13:10:20 +01:00
Dockerfile Remove the confusion around the multiple Dockerfile(s) we have (#8214) 2020-03-10 08:12:26 +10:00
Dockerfile.test Remove the confusion around the multiple Dockerfile(s) we have (#8214) 2020-03-10 08:12:26 +10:00
HISTORICAL_CHANGELOG.md Spelling md (#10508) 2021-01-18 07:43:43 -05:00
LICENSE remove license templates; add info about SPDX to main license file 2018-09-08 15:53:07 +02:00
Makefile.am Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
README.md Change links at bottom of all install docs (#10416) 2021-01-07 08:41:03 -07:00
REDISTRIBUTED.md Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
SECURITY.md Docs housekeeping for SEO and syntax, part 1 (#10388) 2021-01-07 11:44:43 -07:00
build-artifacts.sh Fix the netdata-updater.sh to correctly pass REINSTALL_OPTIONS (finally) (#8808) 2020-08-25 15:25:26 +10:00
configs.signatures Drop dirty dbengine pages if disk cannot keep up (#7777) 2020-02-06 21:58:13 +02:00
configure.ac Move ACLK Legacy into a subfolder (#10265) 2021-01-19 09:41:35 +01:00
coverity-scan.sh Fix coverity scan (#8388) 2020-03-13 07:24:06 +10:00
cppcheck.sh optimized ses and added des (#4470) 2018-10-24 03:03:57 +03:00
netdata-installer.sh New eBPF kernel (#10434) 2021-01-13 15:02:20 +00:00
netdata.cppcheck remove static dir config 2018-09-08 15:45:34 +02:00
netdata.spec.in Switched to using system libwebsockets for RPM builds. (#10507) 2021-01-15 12:38:05 -05:00
package-lock.json Bump ini from 1.3.5 to 1.3.8 (#10489) 2021-01-12 09:36:11 -05:00
package.json fix minimist vulnerability (#8537) 2020-03-30 19:05:04 +10:00

README.md

Netdata

Netdata is high-fidelity infrastructure monitoring and troubleshooting.
Open-source, free, preconfigured, opinionated, and always real-time.


Latest release Build status CII Best Practices License: GPL v3+ analytics
Code Climate Codacy LGTM C LGTM PYTHON

---

Netdata's distributed, real-time monitoring Agent collects thousands of metrics from systems, hardware, containers, and applications with zero configuration. It runs permanently on all your physical/virtual servers, containers, cloud deployments, and edge/IoT devices, and is perfectly safe to install on your systems mid-incident without any preparation.

You can install Netdata on most Linux distributions (Ubuntu, Debian, CentOS, and more), container platforms (Kubernetes clusters, Docker), and many other operating systems (FreeBSD, macOS). No sudo required.

Netdata is designed by system administrators, DevOps engineers, and developers to collect everything, help you visualize metrics, troubleshoot complex performance problems, and make data interoperable with the rest of your monitoring stack.

People get addicted to Netdata. Once you use it on your systems, there's no going back! You've been warned...

Users who are addicted toNetdata

Latest release: v1.28.0, December 18, 2020

Release v1.28.0 is a hotfix release to address a deadlock in the Netdata Agent. We intended to release this hotfix as v1.27.1, but we can't backtrack on a release once we've begun to publish new Docker images and binary packages on other platforms.

v1.27.0, December 17, 2020

The v1.27.0 release of the Netdata Agent brings dramatic improvements to long-term metrics storage via the database engine, and new dashboard features like a time & date picker for visualizing precise timeframes. Two new collectors bring incredible new value to existing features, including a bit of machine learning magic.

Menu

Features

Netdata inaction

Here's what you can expect from Netdata:

  • 1s granularity: The highest possible resolution for all metrics.
  • Unlimited metrics: Netdata collects all the available metrics—the more, the better.
  • 1% CPU utilization of a single core: It's unbelievably optimized.
  • A few MB of RAM: The highly-efficient database engine stores per-second metrics in RAM and then "spills" historical metrics to disk long-term storage.
  • Minimal disk I/O: While running, Netdata only writes historical metrics and reads error and access logs.
  • Zero configuration: Netdata auto-detects everything, and can collect up to 10,000 metrics per server out of the box.
  • Zero maintenance: You just run it. Netdata does the rest.
  • Stunningly fast, interactive visualizations: The dashboard responds to queries in less than 1ms per metric to synchronize charts as you pan through time, zoom in on anomalies, and more.
  • Visual anomaly detection: Our UI/UX emphasizes the relationships between charts to help you detect the root cause of anomalies.
  • Scales to infinity: You can install it on all your servers, containers, VMs, and IoT devices. Metrics are not centralized by default, so there is no limit.
  • Several operating modes: Autonomous host monitoring (the default), headless data collector, forwarding proxy, store and forward proxy, central multi-host monitoring, in all possible configurations. Use different metrics retention policies per node and run with or without health monitoring.

Netdata works with tons of applications, notifications platforms, and other time-series databases:

  • 300+ system, container, and application endpoints: Collectors autodetect metrics from default endpoints and immediately visualize them into meaningful charts designed for troubleshooting. See everything we support.
  • 20+ notification platforms: Netdata's health watchdog sends warning and critical alarms to your favorite platform to inform you of anomalies just seconds after they affect your node.
  • 30+ external time-series databases: Export resampled metrics as they're collected to other local- and Cloud-based databases for best-in-class interoperability.

💡 Want to leverage the monitoring power of Netdata across entire infrastructure? View metrics from any number of distributed nodes in a single interface and unlock even more features with Netdata Cloud.

Get Netdata

User base Servers monitored Sessions served Docker Hub pulls
New users today New machines today Sessions today Docker Hub pulls today

To install Netdata from source on most Linux systems (physical, virtual, container, IoT, edge), run our one-line installation script. This script downloads and builds all dependencies, including those required to connect to Netdata Cloud if you choose, and enables automatic nightly updates and anonymous statistics.

bash <(curl -Ss https://my-netdata.io/kickstart.sh)

To view the Netdata dashboard, navigate to http://localhost:19999, or http://NODE:19999.

Docker

You can also try out Netdata's capabilities in a Docker container:

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 \
  -v /etc/os-release:/host/etc/os-release:ro \
  --restart unless-stopped \
  --cap-add SYS_PTRACE \
  --security-opt apparmor=unconfined \
  netdata/netdata

To view the Netdata dashboard, navigate to http://localhost:19999, or http://NODE:19999.

Other operating systems

See our documentation for additional operating systems, including Kubernetes, .deb/.rpm packages, and more.

Post-installation

When you're finished with installation, check out our single-node or infrastructure monitoring quickstart guides based on your use case.

Or, skip straight to configuring the Netdata Agent.

Read through Netdata's documentation, which is structured based on actions and solutions, to enable features like health monitoring, alarm notifications, long-term metrics storage, exporting to external databases, and more.

How it works

Netdata is a highly efficient, highly modular, metrics management engine. Its lockless design makes it ideal for concurrent operations on the metrics.

Diagram of Netdata's corefunctionality

The result is a highly efficient, low-latency system, supporting multiple readers and one writer on each metric.

Infographic

This is a high-level overview of Netdata features and architecture. Click on it to view an interactive version, which has links to our documentation.

An infographic of how Netdataworks

Documentation

Netdata's documentation is available at Netdata Learn.

This site also hosts a number of guides to help newer users better understand how to collect metrics, troubleshoot via charts, export to external databases, and more.

Community

You can find most of the Netdata team in our community forum. It's the best place to ask questions, find resources, and get to know the Netdata team.

You can also find Netdata on:

Contribute

We welcome contributions to our code and to our documentation. Feel free to join the team!

To report bugs or get help, use GitHub's issues.

Package maintainers should read the guide on building Netdata from source for instructions on building each Netdata component from source and preparing a package.

License

The Netdata Agent is GPLv3+. Netdata re-distributes other open-source tools and libraries. Please check the third party licenses.

Is it any good?

Yes.

When people first hear about a new product, they frequently ask if it is any good. A Hacker News user remarked:

Note to self: Starting immediately, all raganwald projects will have a “Is it any good?” section in the readme, and the answer shall be “yes.".

So, we follow the tradition...