56e22c16e8
* Cleanly reimplement system/edit-config.in - Added support for pulling config files from Docker containers. - Added auto-detection for Docker containers. - Use directory the script is in for target directory for config files instead of templating it in at build time. - Prefix error messages with `ERROR:`. - Robustly check for a valid editor _before_ invoking it. - Add support for actual command-line options, including a proper `--help` option. - Use prefix matching of absolute paths to determine file validity instead of blindly excluding certain path types. - If editing a non-existing file we do not provide a stock copy of, create an empty file instead of throwing an error. - Make the whole script properly modular. * Improve robustness of container autodetection. Instead of relying on the lack of certain directories on a host system, use some relatively standard checks to determine if we appear to be running in a container. * Auto-detect stock config paths at runtinme instead of hard-coding them at build time. THis will simplify testing of the script, as well as making it a bit more resilient to users moving things around. * Add an option to list known config files. * Fix container environment check to not require root. * Fix help output. * Fix path prefix check. * Fix file path handling. * Use correct variable when editing files. * Use correct path for `env`. * Source profile before running `set -e`. To prevent questionablly written profiles from causing the script to exit. * Produce columnar output when listing valid files. * Fix copy check. * Fix build issues. * fix build issues * formatting Co-authored-by: ilyam8 <ilya@netdata.cloud> |
||
|---|---|---|
| .devcontainer | ||
| .github | ||
| .travis | ||
| aclk | ||
| build | ||
| build_external | ||
| claim | ||
| cli | ||
| collectors | ||
| contrib | ||
| daemon | ||
| database | ||
| diagrams | ||
| docs | ||
| exporting | ||
| health | ||
| libnetdata | ||
| ml | ||
| mqtt_websockets@d1e30f55e2 | ||
| packaging | ||
| parser | ||
| registry | ||
| spawn | ||
| streaming | ||
| system | ||
| tests | ||
| web | ||
| .clang-format | ||
| .codacy.yml | ||
| .codeclimate.yml | ||
| .csslintrc | ||
| .dockerignore | ||
| .eslintignore | ||
| .eslintrc | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .lgtm.yml | ||
| .mlc_config.json | ||
| .remarkignore | ||
| .remarkrc.js | ||
| .squash.yml | ||
| .travis.yml | ||
| .yamllint.yml | ||
| BREAKING_CHANGES.md | ||
| build-artifacts.sh | ||
| BUILD.md | ||
| CHANGELOG.md | ||
| CMakeLists.txt | ||
| config.cmake.h.in | ||
| configs.signatures | ||
| configure.ac | ||
| coverity-scan.sh | ||
| cppcheck.sh | ||
| Dockerfile | ||
| Dockerfile.test | ||
| HISTORICAL_CHANGELOG.md | ||
| LICENSE | ||
| Makefile.am | ||
| netdata-installer.sh | ||
| netdata.cppcheck | ||
| netdata.spec.in | ||
| README.md | ||
| REDISTRIBUTED.md | ||
Netdata is high-fidelity infrastructure monitoring and troubleshooting.
Open-source, free, preconfigured, opinionated, and always real-time.
){kind=icon}
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...
Menu
- Features
- Get Netdata
- How it works
- Infographic
- Documentation
- Community
- Contribute
- License
- Is it any good?
Features
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
errorandaccesslogs. - 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.
- Machine learning (ML) features out of the box: Unsupervised ML-based anomaly detection, every second, every metric, zero-config! Metric correlations to help with short-term change detection. And other additional ML-based features to help make your life easier.
- 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
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.
wget -O /tmp/netdata-kickstart.sh https://my-netdata.io/kickstart.sh && sh /tmp/netdata-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.
Netdata Cloud
Netdata Cloud works with Netdata's free, open-source monitoring agent to help you monitor and troubleshoot every layer of your systems to find weaknesses before they turn into outages. Using both tools can help you turn data into insights immediately.
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.
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.
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
Netdata is an inclusive open-source project and community. Please read our Code of Conduct.
Find most of the Netdata team in our community forums. It's the best place to ask questions, find resources, and engage with passionate professionals. The team is also available and active in our Discord too.
You can also find Netdata on:
Contribute
Contributions are the lifeblood of open-source projects. While we continue to invest in and improve Netdata, we need help to democratize monitoring!
- Read our Contributing Guide, which contains all the information you need to contribute to Netdata, such as improving our documentation, engaging in the community, and developing new features. We've made it as frictionless as possible, but if you need help, just ping us on our community forums!
- We have a whole category dedicated to contributing and extending Netdata on our community forums
- Found a bug? Open a GitHub issue.
- View our Security Policy.
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.".