summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md748
1 files changed, 413 insertions, 335 deletions
diff --git a/README.md b/README.md
index 6f11fd14a..5d17627dc 100644
--- a/README.md
+++ b/README.md
@@ -1,421 +1,499 @@
-# netdata [![Build Status](https://travis-ci.com/netdata/netdata.svg?branch=master)](https://travis-ci.com/netdata/netdata) [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2231/badge)](https://bestpractices.coreinfrastructure.org/projects/2231) [![License: GPL v3+](https://img.shields.io/badge/License-GPL%20v3%2B-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
-
-[![Code Climate](https://codeclimate.com/github/netdata/netdata/badges/gpa.svg)](https://codeclimate.com/github/netdata/netdata)
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/a994873f30d045b9b4b83606c3eb3498)](https://www.codacy.com/app/netdata/netdata?utm_source=github.com&utm_medium=referral&utm_content=netdata/netdata&utm_campaign=Badge_Grade)
-[![LGTM C](https://img.shields.io/lgtm/grade/cpp/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:cpp)
-[![LGTM JS](https://img.shields.io/lgtm/grade/javascript/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:javascript)
-[![LGTM PYTHON](https://img.shields.io/lgtm/grade/python/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:python)
-
-> *New to netdata? Here is a live demo: [http://my-netdata.io](http://my-netdata.io)*
-
-**netdata** is a system for **distributed real-time performance and health monitoring**.
-
-It provides **unparalleled insights**, **in real-time**, of everything happening on the systems it runs (including containers and applications such as web and database servers), using **modern interactive web dashboards**.
-
-### netdata core values
-
-we value |netdata...
-:--------------------------:|:----
-high resolution metrics |collects all metrics **every single second**
-unlimited metrics |collects **thousands of metrics** per monitored node
-real-time visualization |dashboards run with **sub-second latency**, collection to visualization
-powerful anomaly detection |has a **distributed watchdog** embedded in it, running on all monitored nodes
-visual anomaly detection |dashboards are optimized for **spotting anomalies**, across all metrics
-meaningful presentation |dashboards present **all metrics in a structured, easy to understand, way**
-zero configuration |**auto-detects** all metrics and comes with dozens of alarms
-resource utilization |core is **optimized C code**, using <1% utilization of single CPU core
-
-netdata also supports:
-
- - monitoring **ephemeral nodes** and **auto-scaled containers**,
- - **integration** with existing monitoring infrastructure (time-series databases like `prometheus`, `graphite`, `opentsdb`) and third-party event notification methods
-(like `slack`, `pagerduty`, `pushover`, and dozens more),
- - building hierarchies of monitored nodes via **real-time metrics streaming** between them,
- - embedding charts and dashboards on third party web sites and applications, such as [Atlassian's Confluence](https://github.com/netdata/netdata/wiki/Custom-Dashboard-with-Confluence).
-
-_netdata is **fast** and **efficient**, designed to permanently run on all systems
-(**physical** & **virtual** servers, **containers**, **IoT** devices), without
-disrupting their core function._
-
-netdata currently runs on **Linux**, **FreeBSD**, and **MacOS**.
-
-[![Twitter Follow](https://img.shields.io/twitter/follow/linuxnetdata.svg?style=social&label=New%20-%20stay%20in%20touch%20-%20follow%20netdata%20on%20twitter)](https://twitter.com/linuxnetdata)
-[![analytics](http://www.google-analytics.com/collect?v=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Freadme&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()
+# netdata [![Build Status](https://travis-ci.com/netdata/netdata.svg?branch=master)](https://travis-ci.com/netdata/netdata) [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2231/badge)](https://bestpractices.coreinfrastructure.org/projects/2231) [![License: GPL v3+](https://img.shields.io/badge/License-GPL%20v3%2B-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![analytics](https://www.google-analytics.com/collect?v=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Freadme&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)]()
+
+[![Code Climate](https://codeclimate.com/github/netdata/netdata/badges/gpa.svg)](https://codeclimate.com/github/netdata/netdata) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/a994873f30d045b9b4b83606c3eb3498)](https://www.codacy.com/app/netdata/netdata?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=netdata/netdata&amp;utm_campaign=Badge_Grade) [![LGTM C](https://img.shields.io/lgtm/grade/cpp/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:cpp) [![LGTM JS](https://img.shields.io/lgtm/grade/javascript/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:javascript) [![LGTM PYTHON](https://img.shields.io/lgtm/grade/python/g/netdata/netdata.svg?logo=lgtm)](https://lgtm.com/projects/g/netdata/netdata/context:python)
---
-## User base
-*Docker pulls*<br/>
-[![netdata/netdata (official)](https://img.shields.io/docker/pulls/netdata/netdata.svg?label=netdata/netdata+%28official%29)](https://hub.docker.com/r/netdata/netdata/)
-[![firehol/netdata (deprecated)](https://img.shields.io/docker/pulls/firehol/netdata.svg?label=firehol/netdata+%28deprecated%29)](https://hub.docker.com/r/firehol/netdata/)
-[![titpetric/netdata (donated)](https://img.shields.io/docker/pulls/titpetric/netdata.svg?label=titpetric/netdata+%28third+party%29)](https://hub.docker.com/r/titpetric/netdata/)
+**Netdata** is **distributed, real-time, performance and health monitoring for systems and applications**. It is a highly optimized monitoring agent you install on all your systems and containers.
-*Since May 16th 2016 (the date the [global public netdata registry](https://github.com/netdata/netdata/wiki/mynetdata-menu-item) was released):*<br/>
-[![User Base](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=persons&label=user%20base&units=null&value_color=blue&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-[![Monitored Servers](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=machines&label=servers%20monitored&units=null&value_color=orange&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-[![Sessions Served](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_sessions&label=sessions%20served&units=null&value_color=yellowgreen&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-
-*in the last 24 hours:*<br/>
-[![New Users Today](http://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=persons&after=-86400&options=unaligned&group=incremental-sum&label=new%20users%20today&units=null&value_color=blue&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-[![New Machines Today](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=machines&group=incremental-sum&after=-86400&options=unaligned&label=servers%20added%20today&units=null&value_color=orange&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-[![Sessions Today](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_sessions&after=-86400&group=incremental-sum&options=unaligned&label=sessions%20served%20today&units=null&value_color=yellowgreen&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-
----
+Netdata provides **unparalleled insights**, **in real-time**, of everything happening on the systems it runs (including web servers, databases, applications), using **highly interactive web dashboards**. It can run autonomously, without any third party components, or it can be integrated to existing monitoring toolchains (Prometheus, Graphite, OpenTSDB, Kafka, Grafana, etc).
-## News
+_Netdata is **fast** and **efficient**, designed to permanently run on all systems (**physical** & **virtual** servers, **containers**, **IoT** devices), without disrupting their core function._
-`Sep 18, 2018` - **netdata has its own organization**
+Netdata is **free, open-source software** and it currently runs on **Linux**, **FreeBSD**, and **MacOS**.
-Netdata used to be a [firehol.org](https://firehol.org) project, accessible as `firehol/netdata`.
+![cncf](https://www.cncf.io/wp-content/uploads/2016/09/logo_cncf.png)
-Netdata now has its own github organization `netdata`, so all github URLs are now `netdata/netdata`. The old github URLs, repo clones, forks, etc redirect automatically to the new repo.
+Netdata is in the [Cloud Native Computing Foundation (CNCF) landscape](https://landscape.cncf.io/grouping=no&sort=stars).
+Check the [CNCF TOC Netdata presentation](https://docs.google.com/presentation/d/18C8bCTbtgKDWqPa57GXIjB2PbjjpjsUNkLtZEz6YK8s/edit?usp=sharing).
---
-![cncf](https://www.cncf.io/wp-content/uploads/2016/09/logo_cncf.png)
-
-`Jun 16, 2018` - **netdata in CNCF**
-
-Netdata is now at the [Cloud Native Computing Foundation (CNCF) landscape](https://landscape.cncf.io/grouping=no&sort=stars).
-
-Read the [netdata presentation](https://docs.google.com/presentation/d/18C8bCTbtgKDWqPa57GXIjB2PbjjpjsUNkLtZEz6YK8s/edit?usp=sharing) we gave at CNCF TOC on Sep 18, 2018.
-
----
-
-`Mar 27th, 2018` - **[netdata v1.10.0 released!](https://github.com/netdata/netdata/releases)**
-
- - new web server, a lot faster and more secure
- - updated all javascript libraries to their latest versions (fixed compatibility issues - now netdata chart can now be embedded on **Atlassian Confluence** pages and remain fully interactive!)
- - new plugins:
- - **BTRFS** (visualize BTRFS allocation with alarms)
- - **bcache** (monitor hybrid setups HDD + SSD)
- - **ceph**
- - **nginx plus**
- - **libreswan** (monitor the traffic of IPSEC tunnels)
- - **traefik**
- - **icecast**
- - **ntpd**
- - **httpcheck** (monitor any remote web server)
- - **portcheck** (monitor any remote TCP port)
- - **spring-boot** (monitor java spring-boot apps)
- - **dnsdist**
- - **Linux hugepages**
- - improved plugins:
- - **statsd**
- - **web_log**
- - **cgroups** for containers and VMs monitoring (netdata now supports **systemd-nspawn** and **kubernetes** - fixed security issue with `cgroup-network`)
- - **Linux memory**
- - **diskspace**
- - **network interfaces**
- - **postgres**
- - **rabbitmq**
- - **apps.plugin** (now it also tracks swap usage per process)
- - **haproxy**
- - **uptime**
- - **ksm** (kernel memory debupper)
- - **mdstat** (software raid)
- - **elasticsearch**
- - **apcupsd**
- - **dhcpd**
- - **fronius**
- - **stiebeletron**
- - new alarm notification methods
- - **alerta**
- - **IRC** (post on IRC channels)
- - and dozens more improvements, enhancements, features and compatibility fixes
-
----
-
-## Features
-
-<p align="center">
-<img src="https://cloud.githubusercontent.com/assets/2662304/19168687/f6a567be-8c19-11e6-8561-ce8d589e8346.gif"/>
-</p>
-
- - **Stunning interactive bootstrap dashboards**<br/>
- mouse and touch friendly, in 2 themes: dark, light
-
- - **Amazingly fast**<br/>
- responds to all queries in less than 0.5 ms per metric,
- even on low-end hardware
+People get **addicted to netdata**.<br/>
+Once you use it on your systems, **there is no going back**! *You have been warned...*
- - **Highly efficient**<br/>
- collects thousands of metrics per server per second,
- with just 1% CPU utilization of a single core, a few MB of RAM and no disk I/O at all
+![image](https://user-images.githubusercontent.com/2662304/48305662-9de82980-e537-11e8-9f5b-aa1a60fbb82f.png)
- - **Sophisticated alerting**<br/>
- hundreds of alarms, **out of the box**!<br/>
- supports dynamic thresholds, hysteresis, alarm templates,
- multiple role-based notification methods (such as email, slack.com, flock.com,
- pushover.net, pushbullet.com, telegram.org, twilio.com, messagebird.com, kavenegar.com)
+[![Tweet about netdata!](https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Tweet%20about%20netdata)](https://twitter.com/intent/tweet?text=Netdata,%20real-time%20performance%20and%20health%20monitoring,%20done%20right!&url=https://my-netdata.io/&via=linuxnetdata&hashtags=netdata,monitoring)
- - **Extensible**<br/>
- you can monitor anything you can get a metric for,
- using its Plugin API (anything can be a netdata plugin,
- BASH, python, perl, node.js, java, Go, ruby, etc)
- - **Embeddable**<br/>
- it can run anywhere a Linux kernel runs (even IoT)
- and its charts can be embedded on your web pages too
+## Contents
- - **Customizable**<br/>
- custom dashboards can be built using simple HTML (no javascript necessary)
+1. [How it looks](#how-it-looks) - have a quick look at it
+2. [User base](#user-base) - who uses netdata?
+3. [Quick Start](#quick-start) - try it now on your systems
+4. [Why Netdata](#why-netdata) - why people love netdata, how it compares with other solutions
+5. [News](#news) - latest news about netdata
+6. [How it works](#how-it-works) - high level diagram of how netdata works
+7. [infographic](#infographic) - everything about netdata, in a page
+8. [Features](#features) - what features does it have
+9. [Visualization](#visualization) - unique visualization features
+10. [What does it monitor](#what-does-it-monitor) - which metrics it collects
+11. [Documentation](#documentation) - read the docs
+12. [Community](#community) - disucss with others and get support
+13. [License](#license) - check the license of netdata
- - **Zero configuration**<br/>
- auto-detects everything, it can collect up to 5000 metrics
- per server out of the box
- - **Zero dependencies**<br/>
- it is even its own web server, for its static web files and its web API
+## How it looks
- - **Zero maintenance**<br/>
- you just run it, it does the rest
+The following animated image, shows the top part of a typical netdata dashboard.
- - **scales to infinity**<br/>
- requiring minimal central resources
+![peek 2018-11-11 02-40](https://user-images.githubusercontent.com/2662304/48307727-9175c800-e55b-11e8-92d8-a581d60a4889.gif)
- - **several operating modes**<br/>
- autonomous host monitoring, headless data collector, forwarding proxy, store and forward proxy, central multi-host monitoring, in all possible configurations.
- Each node may have different metrics retention policy and run with or without health monitoring.
+*A typical netdata dashboard, in 1:1 timing. Charts can be panned by dragging them, zoomed in/out with `SHIFT` + `mouse wheel`, an area can be selected for zoom-in with `SHIFT` + `mouse selection`. Netdata is highly interactive and **real-time**, optimized to get the work done!*
- - **time-series back-ends supported**<br/>
- can archive its metrics on `graphite`, `opentsdb`, `prometheus`, json document DBs, in the same or lower detail
- (lower: to prevent it from congesting these servers due to the amount of data collected)
+> *We have a few online demos to experience it live: [https://my-netdata.io](https://my-netdata.io)*
-![netdata](https://cloud.githubusercontent.com/assets/2662304/14092712/93b039ea-f551-11e5-822c-beadbf2b2a2e.gif)
-
----
-
-## What does it monitor?
-
-netdata collects several thousands of metrics per device.
-All these metrics are collected and visualized in real-time.
-
-> _Almost all metrics are auto-detected, without any configuration._
-
-This is a list of what it currently monitors:
-
-- **CPU**<br/>
- usage, interrupts, softirqs, frequency, total and per core, CPU states
-
-- **Memory**<br/>
- RAM, swap and kernel memory usage, KSM (Kernel Samepage Merging), NUMA
-
-- **Disks**<br/>
- per disk: I/O, operations, backlog, utilization, space, software RAID (md)
-
- ![sda](https://cloud.githubusercontent.com/assets/2662304/14093195/c882bbf4-f554-11e5-8863-1788d643d2c0.gif)
-
-- **Network interfaces**<br/>
- per interface: bandwidth, packets, errors, drops
-
- ![dsl0](https://cloud.githubusercontent.com/assets/2662304/14093128/4d566494-f554-11e5-8ee4-5392e0ac51f0.gif)
-
-- **IPv4 networking**<br/>
- bandwidth, packets, errors, fragments,
- tcp: connections, packets, errors, handshake,
- udp: packets, errors,
- broadcast: bandwidth, packets,
- multicast: bandwidth, packets
-
-- **IPv6 networking**<br/>
- bandwidth, packets, errors, fragments, ECT,
- udp: packets, errors,
- udplite: packets, errors,
- broadcast: bandwidth,
- multicast: bandwidth, packets,
- icmp: messages, errors, echos, router, neighbor, MLDv2, group membership,
- break down by type
-
-- **Interprocess Communication - IPC**<br/>
- such as semaphores and semaphores arrays
-
-- **netfilter / iptables Linux firewall**<br/>
- connections, connection tracker events, errors
+## User base
-- **Linux DDoS protection**<br/>
- SYNPROXY metrics
+Netdata is used by hundreds of thousands of users all over the world.
+Check our [GitHub watchers list](https://github.com/netdata/netdata/watchers).
+You will find people working for **Amazon**, **Atos**, **Baidu**, **Cisco Systems**, **Citrix**, **Deutsche Telekom**, **DigitalOcean**,
+**Elastic**, **EPAM Systems**, **Ericsson**, **Google**, **Groupon**, **Hortonworks**, **HP**, **Huawei**,
+**IBM**, **Microsoft**, **NewRelic**, **Nvidia**, **Red Hat**, **SAP**, **Selectel**, **TicketMaster**,
+**Vimeo**, and many more!
+
+### Docker pulls
+We provide docker images for the most common architectures. These are statistics reported by docker hub:
+
+[![netdata/netdata (official)](https://img.shields.io/docker/pulls/netdata/netdata.svg?label=netdata/netdata+%28official%29)](https://hub.docker.com/r/netdata/netdata/) [![firehol/netdata (deprecated)](https://img.shields.io/docker/pulls/firehol/netdata.svg?label=firehol/netdata+%28deprecated%29)](https://hub.docker.com/r/firehol/netdata/) [![titpetric/netdata (donated)](https://img.shields.io/docker/pulls/titpetric/netdata.svg?label=titpetric/netdata+%28third+party%29)](https://hub.docker.com/r/titpetric/netdata/)
+
+### Registry
+When you install multiple netdata, they are integrated into **one distributed application**, via a [netdata registry](registry/#netdata-registry). This is a web browser feature and it allows us to count the number of unique users and unique netdata servers installed. The following information comes from the global public netdata registry we run:
+
+[![User Base](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=persons&label=user%20base&units=M&value_color=blue&precision=2&divide=1000000&v43)](https://registry.my-netdata.io/#menu_netdata_submenu_registry) [![Monitored Servers](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=machines&label=servers%20monitored&units=k&divide=1000&value_color=orange&precision=2&v43)](https://registry.my-netdata.io/#menu_netdata_submenu_registry) [![Sessions Served](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_sessions&label=sessions%20served&units=M&value_color=yellowgreen&precision=2&divide=1000000&v43)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
+
+*in the last 24 hours:*<br/> [![New Users Today](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=persons&after=-86400&options=unaligned&group=incremental-sum&label=new%20users%20today&units=null&value_color=blue&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry) [![New Machines Today](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_entries&dimensions=machines&group=incremental-sum&after=-86400&options=unaligned&label=servers%20added%20today&units=null&value_color=orange&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry) [![Sessions Today](https://registry.my-netdata.io/api/v1/badge.svg?chart=netdata.registry_sessions&after=-86400&group=incremental-sum&options=unaligned&label=sessions%20served%20today&units=null&value_color=yellowgreen&precision=0&v42)](https://registry.my-netdata.io/#menu_netdata_submenu_registry)
-- **fping** latencies</br>
- for any number of hosts, showing latency, packets and packet loss
+## Quick Start
- ![image](https://cloud.githubusercontent.com/assets/2662304/20464811/9517d2b4-af57-11e6-8361-f6cc57541cd7.png)
+You can quickly install netdata on a Linux box (physical, virtual, container, IoT) with the following command:
+```sh
+# make sure you run `bash` for your shell
+bash
+
+# install netdata, directly from github sources
+bash <(curl -Ss https://my-netdata.io/kickstart.sh)
+```
+![](https://registry.my-netdata.io/api/v1/badge.svg?chart=web_log_nginx.requests_per_url&options=unaligned&dimensions=kickstart&group=sum&after=-3600&label=last+hour&units=installations&value_color=orange&precision=0) ![](https://registry.my-netdata.io/api/v1/badge.svg?chart=web_log_nginx.requests_per_url&options=unaligned&dimensions=kickstart&group=sum&after=-86400&label=today&units=installations&precision=0)
-- **Processes**<br/>
- running, blocked, forks, active
+The above command will:
-- **Entropy**<br/>
- random numbers pool, using in cryptography
+1. install any required packages on your system (it will ask you to confirm before doing so),
+2. download netdata source to `/usr/src/netdata.git`
+3. compile it, install it and start it
+
+More installation methods and additional options can be found at the [installation page](installer/#installation).
-- **NFS file servers and clients**<br/>
- NFS v2, v3, v4: I/O, cache, read ahead, RPC calls
+To try netdata in a docker container, run this:
-- **Network QoS**<br/>
- the only tool that visualizes network `tc` classes in realtime
+```
+docker run -d --name=netdata \
+ -p 19999:19999 \
+ -v /proc:/host/proc:ro \
+ -v /sys:/host/sys:ro \
+ -v /var/run/docker.sock:/var/run/docker.sock:ro \
+ --cap-add SYS_PTRACE \
+ --security-opt apparmor=unconfined \
+ netdata/netdata
+```
- ![qos-tc-classes](https://cloud.githubusercontent.com/assets/2662304/14093004/68966020-f553-11e5-98fe-ffee2086fafd.gif)
+For more information about running netdata in docker, check the [docker installation page](docker/).
-- **Linux Control Groups**<br/>
- containers: systemd, lxc, docker
+![image](https://user-images.githubusercontent.com/2662304/48304090-fd384080-e51b-11e8-80ae-eecb03118dda.png)
-- **Applications**<br/>
- by grouping the process tree and reporting CPU, memory, disk reads,
- disk writes, swap, threads, pipes, sockets - per group
+## Why Netdata
- ![apps](https://cloud.githubusercontent.com/assets/2662304/14093565/67c4002c-f557-11e5-86bd-0154f5135def.gif)
+Netdata has a quite different approach to monitoring.
-- **Users and User Groups resource usage**<br/>
- by summarizing the process tree per user and group,
- reporting: CPU, memory, disk reads, disk writes, swap, threads, pipes, sockets
+Netdata is a monitoring agent you install on all your systems. It is:
-- **Apache and lighttpd web servers**<br/>
- `mod-status` (v2.2, v2.4) and cache log statistics, for multiple servers
+- a **metrics collector** - for system and application metrics (including web servers, databases, containers, etc)
+- a **time-series database** - all stored in memory (does not touch the disks while it runs)
+- a **metrics visualizer** - super fast, interactive, modern, optimized for anomaly detection
+- an **alarms notification engine** - an advanced watchdog for detecting performance and availability issues
-- **Nginx web servers**<br/>
- `stub-status`, for multiple servers
+All the above, are packaged together in a very flexible, extremely modular, distributed application.
-- **Tomcat**<br/>
- accesses, threads, free memory, volume
+This is how netdata compares to other monitoring solutions:
-- **web server log files**<br/>
- extracting in real-time, web server performance metrics and applying several health checks
+netdata|others (open-source and commercial)
+:---:|:---:
+**High resolution metrics** (1s granularity)|Low resolution metrics (10s granularity at best)
+Monitors everything, **thousands of metrics per node**|Monitor just a few metrics
+UI is super fast, optimized for **anomaly detection**|UI is good for just an abstract view
+**Meaningful presentation**, to help you understand the metrics|You have to know the metrics before you start
+Install and get results **immediately**|Long preparation is required to get any useful results
+Use it for **troubleshooting** performance problems|Use them to get *statistics of past performance*
+**Kills the console** for tracing performance issues|The console is always required for troubleshooting
+Requires **zero dedicated resources**|Require large dedicated resources
-- **mySQL databases**<br/>
- multiple servers, each showing: bandwidth, queries/s, handlers, locks, issues,
- tmp operations, connections, binlog metrics, threads, innodb metrics, and more
+Netdata is **open-source**, **free**, super **fast**, very **easy**, completely **open**, extremely **efficient**,
+**flexible** and integrate-able.
-- **Postgres databases**<br/>
- multiple servers, each showing: per database statistics (connections, tuples
- read - written - returned, transactions, locks), backend processes, indexes,
- tables, write ahead, background writer and more
+It has been designed by **SysAdmins**, **DevOps** and **Developers** for troubleshooting performance problems,
+not just visualize metrics.
-- **Redis databases**<br/>
- multiple servers, each showing: operations, hit rate, memory, keys, clients, slaves
+## News
+
+`Nov 6th, 2018` - **[netdata v1.11.0 released!](https://github.com/netdata/netdata/releases)**
+
+ - New query engine, supporting statistical functions.
+ - Fixed security issues identified by Red4Sec.com and Synacktiv.
+ - New Data Collection Modules: [`rethinkdbs`](collectors/python.d.plugin/rethinkdbs/), [`proxysql`](collectors/python.d.plugin/proxysql/), [`litespeed`](collectors/python.d.plugin/litespeed/), [`uwsgi`](collectors/python.d.plugin/uwsgi/), [`unbound`](collectors/python.d.plugin/unbound/), [`powerdns`](collectors/python.d.plugin/powerdns/), [`dockerd`](collectors/python.d.plugin/dockerd/), [`puppet`](collectors/python.d.plugin/puppet/), [`logind`](collectors/python.d.plugin/logind/), [`adaptec_raid`](collectors/python.d.plugin/adaptec_raid/), [`megacli`](collectors/python.d.plugin/megacli/), [`spigotmc`](collectors/python.d.plugin/spigotmc/), [`boinc`](collectors/python.d.plugin/boinc/), [`w1sensor`](collectors/python.d.plugin/w1sensor/), [`monit`](collectors/python.d.plugin/monit/), [`linux_power_supplies`](collectors/python.d.plugin/linux_power_supply/).
+ - Improved Data Collection Modules: [`statsd.plugin`](collectors/statsd.plugin/), [`apps.plugin`](collectors/apps.plugin/), [`freeipmi.plugin`](collectors/freeipmi.plugin/), [`proc.plugin`](collectors/proc.plugin/), [`diskspace.plugin`](collectors/diskspace.plugin/), [`freebsd.plugin`](collectors/freebsd.plugin/), [`python.d.plugin`](collectors/python.d.plugin/), [`web_log`](collectors/python.d.plugin/web_log/), [`nginx_plus`](collectors/python.d.plugin/nginx_plus/), [`ipfs`](collectors/python.d.plugin/ipfs/), [`fail2ban`](collectors/python.d.plugin/fail2ban/), [`ceph`](collectors/python.d.plugin/ceph/), [`elasticsearch`](collectors/python.d.plugin/elasticsearch/), [`redis`](collectors/python.d.plugin/redis/),
+ [`beanstalk`](collectors/python.d.plugin/beanstalk/), [`mysql`](collectors/python.d.plugin/mysql/), [`varnish`](collectors/python.d.plugin/varnish/), [`couchdb`](collectors/python.d.plugin/couchdb/), [`phpfpm`](collectors/python.d.plugin/phpfpm/), [`apache`](collectors/python.d.plugin/apache/), [`icecast`](collectors/python.d.plugin/icecast/), [`mongodb`](collectors/python.d.plugin/mongodb/), [`postgress`](collectors/python.d.plugin/postgres/), [`mdstat`](collectors/python.d.plugin/mdstat/), [`openvpn_log`](collectors/python.d.plugin/ovpn_status_log/), [`snmp`](collectors/node.d.plugin/snmp/), [`nut`](collectors/charts.d.plugin/nut/).
+
+ - Added alarms for detecting abnormally high load average, `TCP` `SYN` and `TCP` accept queue overflows, network interfaces congestion and alarms for `bcache`, `mdstat`, `apcupsd`, `mysql`.
+ - system alarms are now enabled on FreeBSD.
+ - New notification methods: **[rocket.chat](health/notifications/rocketchat/)**, **Microsoft Teams**, **[syslog](health/notifications/syslog/)**, **fleep.io**, **[Amazon SNS](health/notifications/awssns/)**.
+
+ - and dozens more improvements, enhancements, features and compatibility fixes
+
+---
+
+`Sep 18, 2018` - **netdata has its own organization**
+
+Netdata used to be a [firehol.org](https://firehol.org) project, accessible as `firehol/netdata`.
+
+Netdata now has its own github organization `netdata`, so all github URLs are now `netdata/netdata`. The old github URLs, repo clones, forks, etc redirect automatically to the new repo.
+
+## How it works
-- **couchdb**<br/>
- reads/writes, request methods, status codes, tasks, replication, per-db, etc
+Netdata is a highly efficient, highly modular, metrics management engine. Its lockless design makes it ideal for concurrent operations on the metrics.
+
+![image](https://user-images.githubusercontent.com/2662304/48323827-b4c17580-e636-11e8-842c-0ee72fcb4115.png)
-- **mongodb**<br/>
- operations, clients, transactions, cursors, connections, asserts, locks, etc
+This is how it works:
+
+Function|Description|Documentation
+:---:|:---|:---:
+**Collect**|Multiple independent data collection workers are collecting metrics from their sources using the optimal protocol for each application and push the metrics to the database. Each data collection worker has lockless write access to the metrics it collects.|[`collectors`](collectors/#data-collection-plugins)
+**Store**|Metrics are stored in RAM in a round robin database (ring buffer), using a custom made floating point number for minimal footprint.|[`database`](database/#netdata-database)
+**Check**|A lockless independent watchdog is evaluating **health checks** on the collected metrics, triggers alarms, maintains a health transaction log and dispatches alarm notifications.|[`health`](health/#health-monitoring)
+**Stream**|An lockless independent worker is streaming metrics, in full detail and in real-time, to remote netdata servers, as soon as they are collected.|[`streaming`](streaming/#metrics-streaming)
+**Archive**|A lockless independent worker is down-sampling the metrics and pushes them to **backend** time-series databases.|[`backends`](backends/)
+**Query**|Multiple independent workers are attached to the [internal web server](web/server/#netdata-web-server), servicing API requests, including [data queries](web/api/queries/#database-queries).|[`web/api`](web/api/#api)
+
+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 feature set and architecture.
+Click it to to interact with it (it has direct links to documentation).
+
+[![image](https://user-images.githubusercontent.com/2662304/47672043-a47eb480-dbb9-11e8-92a4-fa422d053309.png)](https://my-netdata.io/infographic.html)
-- **memcached databases**<br/>
- multiple servers, each showing: bandwidth, connections, items
-- **elasticsearch**<br/>
- search and index performance, latency, timings, cluster statistics, threads statistics, etc
+## Features
-- **ISC Bind name servers**<br/>
- multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics
+![finger-video](https://user-images.githubusercontent.com/2662304/48346998-96cf3180-e685-11e8-9f4e-059d23aa3aa5.gif)
-- **NSD name servers**<br/>
- queries, zones, protocols, query types, transfers, etc.
+This is what you should expect from Netdata:
-- **PowerDNS**</br>
- queries, answers, cache, latency, etc.
+### General
+- **1s granularity** - the highest possible resolution for all metrics.
+- **Unlimited metrics** - collects all the available metrics, the more the better.
+- **1% CPU utilization of a single core** - it is super fast, unbelievably optimized.
+- **A few MB of RAM** - by default it uses 25MB RAM. [You size it](database).
+- **Zero disk I/O** - while it runs, it does not load or save anything (except `error` and `access` logs).
+- **Zero configuration** - auto-detects everything, it can collect up to 10000 metrics per server out of the box.
+- **Zero maintenance** - You just run it, it does the rest.
+- **Zero dependencies** - it is even its own web server, for its static web files and its web API (though its plugins may require additional libraries, depending on the applications monitored).
+- **Scales to infinity** - you can install it on all your servers, containers, VMs and IoTs. 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. Each node may have different metrics retention policy and run with or without health monitoring.
-- **Postfix email servers**<br/>
- message queue (entries, size)
+### Health Monitoring & Alarms
+- **Sophisticated alerting** - comes with hundreds of alarms, **out of the box**! Supports dynamic thresholds, hysteresis, alarm templates, multiple role-based notification methods.
+- **Notifications**: [alerta.io](health/notifications/alerta/), [amazon sns](health/notifications/awssns/), [discordapp.com](health/notifications/discord/), [email](health/notifications/email/), [flock.com](health/notifications/flock/), [irs](health/notifications/irc/), [kavenegar.com](health/notifications/kavenegar/), [messagebird.com](health/notifications/messagebird/), [pagerduty.com](health/notifications/pagerduty/), [pushbullet.com](health/notifications/pushbullet/), [pushover.net](health/notifications/pushover/), [rocket.chat](health/notifications/rocketchat/), [slack.com](health/notifications/slack/), [syslog](health/notifications/syslog/), [telegram.org](health/notifications/telegram/), [twilio.com](health/notifications/twilio/), [web](health/notifications/web/).
-- **exim email servers**<br/>
- message queue (emails queued)
+### Integrations
+- **time-series dbs** - can archive its metrics to `graphite`, `opentsdb`, `prometheus`, json document DBs, in the same or lower resolution (lower: to prevent it from congesting these servers due to the amount of data collected).
-- **Dovecot** POP3/IMAP servers<br/>
+## Visualization
-- **ISC dhcpd**<br/>
- pools utilization, leases, etc.
+- **Stunning interactive dashboards** - mouse, touchpad and touch-screen friendly in 2 themes: `slate` (dark) and `white`.
+- **Amazingly fast visualization** - responds to all queries in less than 1 ms per metric, even on low-end hardware.
+- **Visual anomaly detection** - the dashboards are optimized for detecting anomalies visually.
+- **Embeddable** - its charts can be embedded on your web pages, wikis and blogs. You can even use [Atlassian's Confluence as a monitoring dashboard](web/gui/confluence/).
+- **Customizable** - custom dashboards can be built using simple HTML (no javascript necessary).
-- **IPFS**<br/>
- bandwidth, peers
+### Positive and negative values
-- **Squid proxy servers**<br/>
- multiple servers, each showing: clients bandwidth and requests, servers bandwidth and requests
+To improve clarity on charts, netdata dashboards present **positive** values for metrics representing `read`, `input`, `inbound`, `received` and **negative** values for metrics representing `write`, `output`, `outbound`, `sent`.
-- **HAproxy**<br/>
- bandwidth, sessions, backends, etc
+![positive-and-negative-values](https://user-images.githubusercontent.com/2662304/48309090-7c5c6180-e57a-11e8-8e03-3a7538c14223.gif)
-- **varnish**<br/>
- threads, sessions, hits, objects, backends, etc
+*Netdata charts showing the bandwidth and packets of a network interface. `received` is positive and `sent` is negative.*
-- **OpenVPN**<br/>
- status per tunnel
+### Autoscaled y-axis
-- **Hardware sensors**<br/>
- `lm_sensors` and `IPMI`: temperature, voltage, fans, power, humidity
+Netdata charts automatically zoom vertically, to visualize the variation of each metric within the visible time-frame.
-- **NUT and APC UPSes**<br/>
- load, charge, battery voltage, temperature, utility metrics, output metrics
+![non-zero-based](https://user-images.githubusercontent.com/2662304/48309139-3d2f1000-e57c-11e8-9a44-b91758134b00.gif)
-- **PHP-FPM**<br/>
- multiple instances, each reporting connections, requests, performance
+*A zero based `stacked` chart, automatically switches to an auto-scaled `area` chart when a single dimension is selected.*
-- **hddtemp**<br/>
- disk temperatures
+### Charts are synchronized
-- **smartd**<br/>
- disk S.M.A.R.T. values
+Charts on netdata dashboards are synchronized to each other. There is no master chart. Any chart can be panned or zoomed at any time, and all other charts will follow.
-- **SNMP devices**<br/>
- can be monitored too (although you will need to configure these)
+![charts-are-synchronized](https://user-images.githubusercontent.com/2662304/48309003-b4fb3b80-e578-11e8-86f6-f505c7059c15.gif)
-- **chrony**</br>
- frequencies, offsets, delays, etc.
+*Charts are panned by dragging them with the mouse. Charts can be zoomed in/out with`SHIFT` + `mouse wheel` while the mouse pointer is over a chart.*
-- **beanstalkd**</br>
- global and per tube monitoring
+> The visible time-frame (pan and zoom) is propagated from netdata server to netdata server, when navigating via the [`my-netdata` menu](registry#netdata-registry).
-- **statsd**<br/>
- [netdata is a fully featured statsd server](https://github.com/netdata/netdata/wiki/statsd)
-- **ceph**<br/>
- OSD usage, Pool usage, number of objects, etc.
+### Highlighted time-frame
-And you can extend it, by writing plugins that collect data from any source, using any computer language.
+To improve visual anomaly detection across charts, the user can highlight a time-frame (by pressing `ALT` + `mouse selection`) on all charts.
----
+![highlighted-timeframe](https://user-images.githubusercontent.com/2662304/48311876-f9093300-e5ae-11e8-9c74-e3e291741990.gif)
-## netdata infographic
+*A highlighted time-frame can be given by pressing `ALT` + `mouse selection` on any chart. Netdata will highlight the same range on all charts.*
-This is a high level overview of netdata feature set and architecture.
-Click it to to interact with it (it has direct links to documentation).
+> Highlighted ranges are propagated from netdata server to netdata server, when navigating via the [`my-netdata` menu](registry#netdata-registry).
-[![image](https://user-images.githubusercontent.com/2662304/47672043-a47eb480-dbb9-11e8-92a4-fa422d053309.png)](https://my-netdata.io/infographic.html)
----
-
-## Installation
-
-Use our **[automatic installer](https://github.com/netdata/netdata/wiki/Installation)** to build and install it on your system.
+## What does it monitor
+
+Netdata data collection is **extensible** - you can monitor anything you can get a metric for.
+Its [Plugin API](collectors/plugins.d/) supports all programing languages (anything can be a netdata plugin, BASH, python, perl, node.js, java, Go, ruby, etc).
+
+- For better performance, most system related plugins (cpu, memory, disks, filesystems, networking, etc) have been written in `C`.
+- For faster development and easier contributions, most application related plugins (databases, web servers, etc) have been written in `python`.
+
+#### APM (Application Performance Monitoring)
+- **[statsd](collectors/statsd.plugin/)** - netdata is a fully featured statsd server.
+- **[Go expvar](collectors/python.d.plugin/go_expvar/)** - collects metrics exposed by applications written in the Go programming language using the expvar package.
+- **[Spring Boot](collectors/python.d.plugin/springboot/)** - monitors running Java Spring Boot applications that expose their metrics with the use of the Spring Boot Actuator included in Spring Boot library.
+- **[uWSGI](collectors/python.d.plugin/uwsgi/)** - collects performance metrics from uWSGI applications.
+
+#### System Resources
+- **[CPU Utilization](collectors/proc.plugin/)** - total and per core CPU usage.
+- **[Interrupts](collectors/proc.plugin/)** - total and per core CPU interrupts.
+- **[SoftIRQs](collectors/proc.plugin/)** - total and per core SoftIRQs.
+- **[SoftNet](collectors/proc.plugin/)** - total and per core SoftIRQs related to network activity.
+- **[CPU Throttling](collectors/proc.plugin/)** - collects per core CPU throttling.
+- **[CPU Frequency](collectors/python.d.plugin/couchdb/)** - collects the current CPU frequency.
+- **[CPU Idle](collectors/python.d.plugin/cpuidle/)** - collects the time spent per processor state.
+- **[IdleJitter](collectors/idlejitter.plugin/)** - measures CPU latency.
+- **[Entropy](collectors/proc.plugin/)** - random numbers pool, using in cryptography.
+- **[Interprocess Communication - IPC](collectors/proc.plugin/)** - such as semaphores and semaphores arrays.
+
+#### Memory
+- **[ram](collectors/proc.plugin/)** - collects info about RAM usage.
+- **[swap](collectors/proc.plugin/)** - collects info about swap memory usage.
+- **[available memory](collectors/proc.plugin/)** - collects the amount of RAM available for userspace processes.
+- **[committed memory](collectors/proc.plugin/)** - collects the amount of RAM committed to userspace processes.
+- **[Page Faults](collectors/proc.plugin/)** - collects the system page faults (major and minor).
+- **[writeback memory](collectors/proc.plugin/)** - collects the system dirty memory and writeback activity.
+- **[huge pages](collectors/proc.plugin/)** - collects the amount of RAM used for huge pages.
+- **[KSM](collectors/proc.plugin/)** - collects info about Kernel Same Merging (memory dedupper).
+- **[Numa](collectors/proc.plugin/)** - collects Numa info on systems that support it.
+- **[slab](collectors/proc.plugin/)** - collects info about the Linux kernel memory usage.
+
+#### Disks
+- **[block devices](collectors/proc.plugin/)** - per disk: I/O, operations, backlog, utilization, space, etc.
+- **[BCACHE](collectors/proc.plugin/)** - detailed performance of SSD caching devices.
+- **[DiskSpace](collectors/proc.plugin/)** - monitors disk space usage.
+- **[mdstat](collectors/python.d.plugin/mdstat/)** - software RAID.
+- **[hddtemp](collectors/python.d.plugin/hddtemp/)** - disk temperatures.
+- **[smartd](collectors/python.d.plugin/smartd_log/)** - disk S.M.A.R.T. values.
+- **[device mapper](collectors/proc.plugin/)** - naming disks.
+- **[Veritas Volume Manager](collectors/proc.plugin/)** - naming disks.
+- **[megacli](collectors/python.d.plugin/megacli/)** - adapter, physical drives and battery stats.
+- **[adaptec_raid](collectors/python.d.plugin/adaptec_raid/)** - logical and physical devices health metrics.
+
+#### Filesystems
+- **[BTRFS](collectors/proc.plugin/)** - detailed disk space allocation and usage.
+- **[Ceph](collectors/python.d.plugin/ceph/)** - OSD usage, Pool usage, number of objects, etc.
+- **[NFS file servers and clients](collectors/proc.plugin/)** - NFS v2, v3, v4: I/O, cache, read ahead, RPC calls
+- **[Samba](collectors/python.d.plugin/samba/)** - performance metrics of Samba SMB2 file sharing.
+- **[ZFS](collectors/proc.plugin/)** - detailed performance and resource usage.
+
+#### Networking
+- **[Network Stack](collectors/proc.plugin/)** - everything about the networking stack (both IPv4 and IPv6 for all protocols: TCP, UDP, SCTP, UDPLite, ICMP, Multicast, Broadcast, etc), and all network interfaces (per interface: bandwidth, packets, errors, drops).
+- **[Netfilter](collectors/proc.plugin/)** - everything about the netfilter connection tracker.
+- **[SynProxy](collectors/proc.plugin/)** - collects performance data about the linux SYNPROXY (DDoS).
+- **[NFacct](collectors/nfacct.plugin/)** - collects accounting data from iptables.
+- **[Network QoS](collectors/tc.plugin/)** - the only tool that visualizes network `tc` classes in real-time
+- **[FPing](collectors/fping.plugin/)** - to measure latency and packet loss between any number of hosts.
+- **[ISC dhcpd](collectors/python.d.plugin/isc_dhcpd/)** - pools utilization, leases, etc.
+- **[AP](collectors/charts.d.plugin/ap/)** - collects Linux access point performance data (`hostapd`).
+- **[SNMP](collectors/node.d.plugin/snmp/)** - SNMP devices can be monitored too (although you will need to configure these).
+- **[port_check](collectors/python.d.plugin/portcheck/)** - checks TCP ports for availability and response time.
+
+#### Virtual Private Networks
+- **[OpenVPN](collectors/python.d.plugin/ovpn_status_log/)** - collects status per tunnel.
+- **[LibreSwan](collectors/charts.d.plugin/libreswan/)** - collects metrics per IPSEC tunnel.
+- **[Tor](collectors/python.d.plugin/tor/)** - collects Tor traffic statistics.
+
+#### Processes
+- **[System Processes](collectors/proc.plugin/)** - running, blocked, forks, active.
+- **[Applications](collectors/apps.plugin/)** - by grouping the process tree and reporting CPU, memory, disk reads, disk writes, swap, threads, pipes, sockets - per process group.
+- **[systemd](collectors/cgroups.plugin/)** - monitors systemd services using CGROUPS.
+
+#### Users
+- **[Users and User Groups resource usage](collectors/apps.plugin/)** - by summarizing the process tree per user and group, reporting: CPU, memory, disk reads, disk writes, swap, threads, pipes, sockets
+- **[logind](collectors/python.d.plugin/logind/)** - collects sessions, users and seats connected.
+
+#### Containers and VMs
+- **[Containers](collectors/cgroups.plugin/)** - collects resource usage for all kinds of containers, using CGROUPS (systemd-nspawn, lxc, lxd, docker, kubernetes, etc).
+- **[libvirt VMs](collectors/cgroups.plugin/)** - collects resource usage for all kinds of VMs, using CGROUPS.
+- **[dockerd](collectors/python.d.plugin/dockerd/)** - collects docker health metrics.
+
+#### Web Servers
+- **[Apache and lighttpd](collectors/python.d.plugin/apache/)** - `mod-status` (v2.2, v2.4) and cache log statistics, for multiple servers.
+- **[IPFS](collectors/python.d.plugin/ipfs/)** - bandwidth, peers.
+- **[LiteSpeed](collectors/python.d.plugin/litespeed/)** - reads the litespeed rtreport files to collect metrics.
+- **[Nginx](collectors/python.d.plugin/nginx/)** - `stub-status`, for multiple servers.
+- **[Nginx+](collectors/python.d.plugin/nginx_plus/)** - connects to multiple nginx_plus servers (local or remote) to collect real-time performance metrics.
+- **[PHP-FPM](collectors/python.d.plugin/phpfpm/)** - multiple instances, each reporting connections, requests, performance, etc.
+- **[Tomcat](collectors/python.d.plugin/tomcat/)** - accesses, threads, free memory, volume, etc.
+- **[web server `access.log` files](collectors/python.d.plugin/web_log/)** - extracting in real-time, web server and proxy performance metrics and applying several health checks, etc.
+- **[HTTP check](collectors/python.d.plugin/httpcheck/)** - checks one or more web servers for HTTP status code and returned content.
+
+#### Proxies, Balancers, Accelerators
+- **[HAproxy](collectors/python.d.plugin/haproxy/)** - bandwidth, sessions, backends, etc.
+- **[Squid](collectors/python.d.plugin/squid/)** - multiple servers, each showing: clients bandwidth and requests, servers bandwidth and requests.
+- **[Traefik](collectors/python.d.plugin/traefik/)** - connects to multiple traefik instances (local or remote) to collect API metrics (response status code, response time, average response time and server uptime).
+- **[Varnish](collectors/python.d.plugin/varnish/)** - threads, sessions, hits, objects, backends, etc.
+- **[IPVS](collectors/proc.plugin/)** - collects metrics from the Linux IPVS load balancer.
+
+#### Database Servers
+- **[CouchDB](collectors/python.d.plugin/couchdb/)** - reads/writes, request methods, status codes, tasks, replication, per-db, etc.
+- **[MemCached](collectors/python.d.plugin/memcached/)** - multiple servers, each showing: bandwidth, connections, items, etc.
+- **[MongoDB](collectors/python.d.plugin/mongodb/)** - operations, clients, transactions, cursors, connections, asserts, locks, etc.
+- **[MySQL and mariadb](collectors/python.d.plugin/mysql/)** - multiple servers, each showing: bandwidth, queries/s, handlers, locks, issues, tmp operations, connections, binlog metrics, threads, innodb metrics, and more.
+- **[PostgreSQL](collectors/python.d.plugin/postgres/)** - multiple servers, each showing: per database statistics (connections, tuples read - written - returned, transactions, locks), backend processes, indexes, tables, write ahead, background writer and more.
+- **[Proxy SQL](collectors/python.d.plugin/proxysql/)** - collects Proxy SQL backend and frontend performance metrics.
+- **[Redis](collectors/python.d.plugin/redis/)** - multiple servers, each showing: operations, hit rate, memory, keys, clients, slaves.
+- **[RethinkDB](collectors/python.d.plugin/rethinkdbs/)** - connects to multiple rethinkdb servers (local or remote) to collect real-time metrics.
+
+#### Message Brokers
+- **[beanstalkd](collectors/python.d.plugin/beanstalk/)** - global and per tube monitoring.
+- **[RabbitMQ](collectors/python.d.plugin/rabbitmq/)** - performance and health metrics.
+
+#### Search and Indexing
+- **[ElasticSearch](collectors/python.d.plugin/elasticsearch/)** - search and index performance, latency, timings, cluster statistics, threads statistics, etc.
+
+#### DNS Servers
+- **[bind_rndc](collectors/python.d.plugin/bind_rndc/)** - parses `named.stats` dump file to collect real-time performance metrics. All versions of bind after 9.6 are supported.
+- **[dnsdist](collectors/python.d.plugin/dnsdist/)** - performance and health metrics.
+- **[ISC Bind (named)](collectors/node.d.plugin/named/)** - multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics. All versions of bind after 9.9.10 are supported.
+- **[NSD](collectors/python.d.plugin/nsd/)** - queries, zones, protocols, query types, transfers, etc.
+- **[PowerDNS](collectors/python.d.plugin/powerdns/)** - queries, answers, cache, latency, etc.
+- **[unbound](collectors/python.d.plugin/unbound/)** - performance and resource usage metrics.
+- **[dns_query_time](collectors/python.d.plugin/dns_query_time/)** - DNS query time statistics.
+
+#### Time Servers
+- **[chrony](collectors/python.d.plugin/chrony/)** - uses the `chronyc` command to collect chrony statistics (Frequency, Last offset, RMS offset, Residual freq, Root delay, Root dispersion, Skew, System time).
+- **[ntpd](collectors/python.d.plugin/ntpd/)** - connects to multiple ntpd servers (local or remote) to provide statistics of system variables and optional also peer variables.
+
+#### Mail Servers
+- **[Dovecot](collectors/python.d.plugin/dovecot/)** - POP3/IMAP servers.
+- **[Exim](collectors/python.d.plugin/exim/)** - message queue (emails queued).
+- **[Postfix](collectors/python.d.plugin/postfix/)** - message queue (entries, size).
+
+#### Hardware Sensors
+- **[IPMI](collectors/freeipmi.plugin/)** - enterprise hardware sensors and events.
+- **[lm-sensors](collectors/python.d.plugin/sensors/)** - temperature, voltage, fans, power, humidity, etc.
+- **[Nvidia](collectors/python.d.plugin/nvidia_smi/)** - collects information for Nvidia GPUs.
+- **[RPi](collectors/charts.d.plugin/sensors/)** - Raspberry Pi temperature sensors.
+- **[w1sensor](collectors/python.d.plugin/w1sensor/)** - collects data from connected 1-Wire sensors.
+
+#### UPSes
+- **[apcupsd](collectors/charts.d.plugin/apcupsd/)** - load, charge, battery voltage, temperature, utility metrics, output metrics
+- **[NUT](collectors/charts.d.plugin/nut/)** - load, charge, battery voltage, temperature, utility metrics, output metrics
+- **[Linux Power Supply](collectors/python.d.plugin/linux_power_supply/)** - collects metrics reported by power supply drivers on Linux.
+
+#### Social Sharing Servers
+- **[RetroShare](collectors/python.d.plugin/retroshare/)** - connects to multiple retroshare servers (local or remote) to collect real-time performance metrics.
+
+#### Security
+- **[Fail2Ban](collectors/python.d.plugin/fail2ban/)** - monitors the fail2ban log file to check all bans for all active jails.
+
+#### Authentication, Authorization, Accounting (AAA, RADIUS, LDAP) Servers
+- **[FreeRadius](collectors/python.d.plugin/freeradius/)** - uses the `radclient` command to provide freeradius statistics (authentication, accounting, proxy-authentication, proxy-accounting).
+
+#### Telephony Servers
+- **[opensips](collectors/charts.d.plugin/opensips/)** - connects to an opensips server (localhost only) to collect real-time performance metrics.
+
+#### Household Appliances
+- **[SMA webbox](collectors/node.d.plugin/sma_webbox/)** - connects to multiple remote SMA webboxes to collect real-time performance metrics of the photovoltaic (solar) power generation.
+- **[Fronius](collectors/node.d.plugin/fronius/)** - connects to multiple remote Fronius Symo servers to collect real-time performance metrics of the photovoltaic (solar) power generation.
+- **[StiebelEltron](collectors/node.d.plugin/stiebeleltron/)** - collects the temperatures and other metrics from your Stiebel Eltron heating system using their Internet Service Gateway (ISG web).
+
+#### Game Servers
+- **[SpigotMC](collectors/python.d.plugin/spigotmc/)** - monitors Spigot Minecraft server ticks per second and number of online players using the Minecraft remote console.
+
+#### Distributed Computing
+- **[BOINC](collectors/python.d.plugin/boinc/)** - monitors task states for local and remote BOINC client software using the remote GUI RPC interface. Also provides alarms for a handful of error conditions.
+
+#### Media Streaming Servers
+- **[IceCast](collectors/python.d.plugin/icecast/)** - collects the number of listeners for active sources.
+
+### Monitoring Systems
+- **[Monit](collectors/python.d.plugin/monit/)** - collects metrics about monit targets (filesystems, applications, networks).
+
+#### Provisioning Systems
+- **[Puppet](collectors/python.d.plugin/puppet/)** - connects to multiple Puppet Server and Puppet DB instances (local or remote) to collect real-time status metrics.
+
+And you can extend it, by writing plugins that collect data from any source, using any computer language.
+
+---
+
+## Documentation
-It should run on **any Linux** system (including IoT). It has been tested on:
+The netdata documentation is inside the repo, so by just navigating the repo on github you can find all the documentation.
-- Alpine
-- Arch Linux
-- CentOS
-- Debian
-- Fedora
-- Gentoo
-- openSUSE
-- PLD Linux
-- RedHat Enterprise Linux
-- SUSE
-- Ubuntu
+Here is a quick list:
----
+Directory|Description
+:---|:---
+[`installer`](installer/)|Instructions to install netdata on your systems.
+[`docker`](docker/)|Instructions to install netdata using docker.
+[`daemon`](daemon/)|Information about the netdata daemon and its configuration.
+[`collectors`](collectors/)|Information about data collection plugins.
+[`health`](health/)|How netdata's health monitoring works, how to create your own alarms and how to configure alarm notification methods.
+[`streaming`](streaming/)|How to build hierarchies of netdata servers, by streaming metrics between them.
+[`backends`](backends/)|Long term archiving of metrics to industry standard time-series databases, like `prometheus`, `graphite`, `opentsdb`.
+[`web/api`](web/api/)|Learn how to query the netdata API and the queries it supports.
+[`web/api/badges`](web/api/badges/)|Learn how to generate badges (SVG images) from live data.
+[`web/gui/custom`](web/gui/custom/)|Learn how to create custom netdata dashboards.
+[`web/gui/confluence`](web/gui/confluence/)|Learn how to create netdata dashboards on Atlassian's Confluence.
-## Interaction with netdata
+But you can also check all the other directories. Most of them have plenty of documentation.
-After installation, you can interact with netdata using **[CLI](https://github.com/netdata/netdata/wiki/Command-Line-Options)** and web dashboards.
-The default port of dashboard is 19999. To access the web dashboard on localhost, use: http://localhost:19999
+## Community
----
+We welcome contributions. So, feel free to join the team.
-## Documentation
+To report bugs, or get help, use [GitHub Issues](https://github.com/netdata/netdata/issues).
-Check the **[netdata wiki](https://github.com/netdata/netdata/wiki)**.
+You can also find netdata on:
-## License
+- [Facebook](https://www.facebook.com/linuxnetdata/)
+- [Twitter](https://twitter.com/linuxnetdata)
+- [OpenHub](https://www.openhub.net/p/netdata)
+- [Repology](https://repology.org/metapackage/netdata/versions)
+- [StackShare](https://stackshare.io/netdata)
-netdata is [GPLv3+](LICENSE).
+## License
+
+netdata is [GPLv3+](LICENSE).
-Netdata re-distributes other open-source tools and libraries. Please check the [third party licenses](https://github.com/netdata/netdata/blob/master/REDISTRIBUTED.md).
+Netdata re-distributes other open-source tools and libraries. Please check the [third party licenses](REDISTRIBUTED.md).