README.md

   1 # netdata
   2
   3 #### 180.000+ views, 50.000+ visitors, 15.000+ downloads, 8.000+ github stars, 400+ forks, 7 days!
   4
   5 And we still run with 1.000+ downloads per day!
   6
   7 Thank you!
   8
   9 ---
  10
  11 **Real-time performance monitoring, done right!**
  12
  13 This is the default dashboard of **netdata**:
  14
  15  - real-time, per second updates, snappy refreshes!
  16  - 300+ charts out of the box, 2000+ metrics monitored!
  17  - zero configuration, zero maintenance, zero dependencies!
  18
  19 ![netdata](https://cloud.githubusercontent.com/assets/2662304/14092712/93b039ea-f551-11e5-822c-beadbf2b2a2e.gif)
  20
  21 ---
  22
  23 ## Git sources
  24
  25 You are looking at a version of the sources extracted directly from git.
  26 If you want a version of the source package where `configure` and any
  27 documentation has been built for you, please get an official
  28 [netdata package download](https://firehol.org/download/netdata/).
  29 The `unsigned/master` folder tracks the head of the git tree and
  30 released packages are also available.
  31
  32 ## Features
  33
  34 **netdata** is a highly optimized Linux daemon providing **real-time performance monitoring for Linux systems, Applications, SNMP devices, over the web**!
  35
  36 It tries to visualize the **truth of now**, in its **greatest detail**, so that you can get insights of what is happening now and what just happened, on your systems and applications.
  37
  38 This is what you get:
  39
  40 1. **Beautiful out of the box** bootstrap dashboards
  41 2. **Custom dashboards** that can be built using simple HTML (no javascript necessary)
  42 3. **Blazingly fast** and **super efficient**, written in C (for default installations, expect just 2% of a single core CPU usage and a few MB of RAM)
  43 3. **Zero configuration** - you just install it and it autodetects everything
  44 4. **Zero dependencies**, it is its own web server for its static web files and its web API
  45 4. **Extensible**, you can monitor anything you can get a metric for, using its Plugin API (anything can be a netdata plugin - from BASH to node.js)
  46 7. **Embeddable**, it can run anywhere a Linux kernel runs
  47
  48 ---
  49
  50 ## What does it monitor?
  51
  52 This is what it currently monitors (most with zero configuration):
  53
  54 1. **CPU usage, interrupts, softirqs and frequency** (total and per core)
  55 2. **RAM, swap and kernel memory usage** (including KSM and kernel memory deduper)
  56 3. **Disk I/O** (per disk: bandwidth, operations, backlog, utilization, etc)
  57
  58    ![sda](https://cloud.githubusercontent.com/assets/2662304/14093195/c882bbf4-f554-11e5-8863-1788d643d2c0.gif)
  59
  60 4. **Network interfaces** (per interface: bandwidth, packets, errors, drops, etc)
  61
  62    ![dsl0](https://cloud.githubusercontent.com/assets/2662304/14093128/4d566494-f554-11e5-8ee4-5392e0ac51f0.gif)
  63
  64 5. **IPv4 networking** (bandwidth, packets, errors, fragments, tcp: connections, packets, errors, handshake, udp: packets, errors, broadcast: bandwidth, packets, multicast: bandwidth, packets)
  65 6. **IPv6 networking** (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)
  66 7. **netfilter / iptables Linux firewall** (connections, connection tracker events, errors, etc)
  67 8. **Processes** (running, blocked, forks, active, etc)
  68 9. **Entropy**
  69 10. **NFS file servers**, v2, v3, v4 (I/O, cache, read ahead, RPC calls)
  70 11. **Network QoS** (yes, the only tool that visualizes network `tc` classes in realtime)
  71
  72    ![qos-tc-classes](https://cloud.githubusercontent.com/assets/2662304/14093004/68966020-f553-11e5-98fe-ffee2086fafd.gif)
  73
  74
  75 12. **Applications**, by grouping the process tree (CPU, memory, disk reads, disk writes, swap, threads, pipes, sockets, etc)
  76
  77    ![apps](https://cloud.githubusercontent.com/assets/2662304/14093565/67c4002c-f557-11e5-86bd-0154f5135def.gif)
  78
  79 13. **Apache web server** mod-status (v2.2, v2.4)
  80 14. **Nginx web server** stub-status
  81 15. **mySQL databases** (multiple servers, each showing: bandwidth, queries/s, handlers, locks, issues, tmp operations, connections, binlog metrics, threads, innodb metrics, etc)
  82 16. **ISC Bind name server** (multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics)
  83 17. **Postfix email server** message queue (entries, size)
  84 18. **Squid proxy server** (clients bandwidth and requests, servers bandwidth and requests)
  85 19. **Hardware sensors** (temperature, voltage, fans, power, humidity, etc)
  86 20. **NUT UPSes** (load, charge, battery voltage, temperature, utility metrics, output metrics)
  87
  88 Any number of **SNMP devices** can be monitored, although you will need to configure these.
  89
  90 And you can extend it, by writing plugins that collect data from any source, using any computer language.
  91
  92 ---
  93
  94 ## Still not convinced?
  95
  96 Read **[Why netdata?](https://github.com/firehol/netdata/wiki/Why-netdata%3F)**
  97
  98 Or **[check what our users say about netdata](https://github.com/firehol/netdata/issues/148)**.
  99
 100 ---
 101
 102 ## Installation
 103
 104 Use our **[automatic installer](https://github.com/firehol/netdata/wiki/Installation)** to build and install it on your system
 105
 106 It should run on any Linux system. We have tested it on:
 107
 108 - Gentoo
 109 - ArchLinux
 110 - Ubuntu / Debian
 111 - CentOS
 112 - Fedora
 113
 114 ---
 115
 116 ## Documentation
 117
 118 Check the **[netdata wiki](https://github.com/firehol/netdata/wiki)**.
 119