]> arthur.barton.de Git - netdata.git/blob - web/dashboard_info.js
multi-os support (final touch)
[netdata.git] / web / dashboard_info.js
1
2 var netdataDashboard = window.netdataDashboard || {};
3
4 // menu
5 // information about the main menus
6
7 netdataDashboard.menu = {
8     'system': {
9         title: 'System Overview',
10         icon: '<i class="fa fa-bookmark" aria-hidden="true"></i>',
11         info: 'Overview of the key system metrics.'
12     },
13
14     'services': {
15         title: 'systemd Services',
16         icon: '<i class="fa fa-cogs" aria-hidden="true"></i>',
17         info: 'Resources utilization of systemd services. netdata monitors all systemd services via cgroups (the resources accounting used by containers). '
18     },
19
20     'ap': {
21         title: 'Access Points',
22         icon: '<i class="fa fa-wifi" aria-hidden="true"></i>',
23         info: 'Performance metrics for the access points (i.e. wireless interfaces in AP mode) found on the system.'
24     },
25
26     'tc': {
27         title: 'Quality of Service',
28         icon: '<i class="fa fa-globe" aria-hidden="true"></i>',
29         info: 'Netdata collects and visualizes tc class utilization using its <a href="https://github.com/firehol/netdata/blob/master/plugins.d/tc-qos-helper.sh" target="_blank">tc-helper plugin</a>. If you also use <a href="http://firehol.org/#fireqos" target="_blank">FireQOS</a> for setting up QoS, netdata automatically collects interface and class names. If your QoS configuration includes overheads calculation, the values shown here will include these overheads (the total bandwidth for the same interface as reported in the Network Interfaces section, will be lower than the total bandwidth reported here). QoS data collection may have a slight time difference compared to the interface (QoS data collection uses a BASH script, so a shift in data collection of a few milliseconds should be justified).'
30     },
31
32     'net': {
33         title: 'Network Interfaces',
34         icon: '<i class="fa fa-share-alt" aria-hidden="true"></i>',
35         info: 'Performance metrics for network interfaces.'
36     },
37
38     'ipv4': {
39         title: 'IPv4 Networking',
40         icon: '<i class="fa fa-cloud" aria-hidden="true"></i>',
41         info: 'Performance metrics for the IPv4 stack of the system.'
42     },
43
44     'ipv6': {
45         title: 'IPv6 Networking',
46         icon: '<i class="fa fa-cloud" aria-hidden="true"></i>',
47         info: 'Performance metrics for the IPv6 stack of the system.'
48     },
49
50     'ipvs': {
51         title: 'IP Virtual Server',
52         icon: '<i class="fa fa-eye" aria-hidden="true"></i>',
53         info: '<a href="http://www.linuxvirtualserver.org/software/ipvs.html" target="_blank">IPVS (IP Virtual Server)</a> implements transport-layer load balancing inside the Linux kernel, so called Layer-4 switching. IPVS running on a host acts as a load balancer at the front of a cluster of real servers, it can direct requests for TCP/UDP based services to the real servers, and makes services of the real servers to appear as a virtual service on a single IP address.'
54     },
55
56     'netfilter': {
57         title: 'Firewall (netfilter)',
58         icon: '<i class="fa fa-shield" aria-hidden="true"></i>',
59         info: 'Performance metrics of the netfilter components.'
60     },
61
62     'cpu': {
63         title: 'CPUs',
64         icon: '<i class="fa fa-bolt" aria-hidden="true"></i>',
65         info: 'Detailed information for each CPU of the system. A summary of the system for all CPUs can be found at the <a href="#menu_system">System Overview</a> section.'
66     },
67
68     'mem': {
69         title: 'Memory',
70         icon: '<i class="fa fa-bolt" aria-hidden="true"></i>',
71         info: 'Detailed information about the memory management of the system.'
72     },
73
74     'disk': {
75         title: 'Disks',
76         icon: '<i class="fa fa-folder" aria-hidden="true"></i>',
77         info: 'Charts with performance information for all the system disks. Special care has been given to present disk performance metrics in a way compatible with <code>iostat -x</code>. netdata by default prevents rendering performance charts for individual partitions and unmounted virtual disks. Disabled charts can still be enabled by configuring the relative settings in the netdata configuration file.'
78     },
79
80     'sensors': {
81         title: 'Sensors',
82         icon: '<i class="fa fa-leaf" aria-hidden="true"></i>',
83         info: 'Readings of the configured system sensors.'
84     },
85
86     'nfsd': {
87         title: 'NFS Server',
88         icon: '<i class="fa fa-folder-open" aria-hidden="true"></i>',
89         info: 'Performance metrics of the Network File Server. NFS is a distributed file system protocol, allowing a user on a client computer to access files over a network, much like local storage is accessed. NFS, like many other protocols, builds on the Open Network Computing Remote Procedure Call (ONC RPC) system. The NFS is an open standard defined in Request for Comments (RFC).'
90     },
91
92     'nfs': {
93         title: 'NFS Client',
94         icon: '<i class="fa fa-folder-open" aria-hidden="true"></i>',
95         info: 'Performance metrics of the NFS operations of this system, acting as an NFS client.'
96     },
97
98     'apps': {
99         title: 'Applications',
100         icon: '<i class="fa fa-heartbeat" aria-hidden="true"></i>',
101         info: 'Per application statistics are collected using netdata\'s <code>apps.plugin</code>. This plugin walks through all processes and aggregates statistics for applications of interest, defined in <code>/etc/netdata/apps_groups.conf</code> (the default is <a href="https://github.com/firehol/netdata/blob/master/conf.d/apps_groups.conf" target="_blank">here</a>). The plugin internally builds a process tree (much like <code>ps fax</code> does), and groups processes together (evaluating both child and parent processes) so that the result is always a chart with a predefined set of dimensions (of course, only application groups found running are reported). The reported values are compatible with <code>top</code>, although the netdata plugin counts also the resources of exited children (unlike <code>top</code> which shows only the resources of the currently running processes). So for processes like shell scripts, the reported values include the resources used by the commands these scripts run within each timeframe.',
102         height: 1.5
103     },
104
105     'users': {
106         title: 'Users',
107         icon: '<i class="fa fa-user" aria-hidden="true"></i>',
108         info: 'Per user statistics are collected using netdata\'s <code>apps.plugin</code>. This plugin walks through all processes and aggregates statistics per user. The reported values are compatible with <code>top</code>, although the netdata plugin counts also the resources of exited children (unlike <code>top</code> which shows only the resources of the currently running processes). So for processes like shell scripts, the reported values include the resources used by the commands these scripts run within each timeframe.',
109         height: 1.5
110     },
111
112     'groups': {
113         title: 'User Groups',
114         icon: '<i class="fa fa-users" aria-hidden="true"></i>',
115         info: 'Per user group statistics are collected using netdata\'s <code>apps.plugin</code>. This plugin walks through all processes and aggregates statistics per user group. The reported values are compatible with <code>top</code>, although the netdata plugin counts also the resources of exited children (unlike <code>top</code> which shows only the resources of the currently running processes). So for processes like shell scripts, the reported values include the resources used by the commands these scripts run within each timeframe.',
116         height: 1.5
117     },
118
119     'netdata': {
120         title: 'Netdata Monitoring',
121         icon: '<i class="fa fa-bar-chart" aria-hidden="true"></i>',
122         info: 'Performance metrics for the operation of netdata itself and its plugins.'
123     },
124
125     'example': {
126         title: 'Example Charts',
127         info: 'Example charts, demonstrating the external plugin architecture.'
128     },
129
130     'cgroup': {
131         title: '',
132         icon: '<i class="fa fa-th" aria-hidden="true"></i>',
133         info: 'Container resource utilization metrics. Netdata reads this information from <b>cgroups</b> (abbreviated from <b>control groups</b>), a Linux kernel feature that limits and accounts resource usage (CPU, memory, disk I/O, network, etc.) of a collection of processes. <b>cgroups</b> together with <b>namespaces</b> (that offer isolation between processes) provide what we usually call: <b>containers</b>.'
134     },
135
136     'cgqemu': {
137         title: '',
138         icon: '<i class="fa fa-th-large" aria-hidden="true"></i>',
139         info: 'QEMU virtual machine resource utilization metrics. QEMU (short for Quick Emulator) is a free and open-source hosted hypervisor that performs hardware virtualization.'
140     },
141
142     'fping': {
143         title: 'fping',
144         icon: '<i class="fa fa-exchange" aria-hidden="true"></i>',
145         info: 'Network latency statistics, via <b>fping</b>. <b>fping</b> is a program to send ICMP echo probes to network hosts, similar to <code>ping</code>, but much better performing when pinging multiple hosts. fping versions after 3.15 can be directly used as netdata plugins.'
146     },
147
148     'memcached': {
149         title: 'memcached',
150         icon: '<i class="fa fa-database" aria-hidden="true"></i>',
151         info: 'Performance metrics for <b>memcached</b>. Memcached is a general-purpose distributed memory caching system. It is often used to speed up dynamic database-driven websites by caching data and objects in RAM to reduce the number of times an external data source (such as a database or API) must be read.'
152     },
153
154     'mysql': {
155         title: 'MySQL',
156         icon: '<i class="fa fa-database" aria-hidden="true"></i>',
157         info: 'Performance metrics for <b>mysql</b>, the open-source relational database management system (RDBMS).'
158     },
159
160     'postgres': {
161         title: 'Postgres',
162         icon: '<i class="fa fa-database" aria-hidden="true"></i>',
163         info: 'Performance metrics for <b>PostgresSQL</b>, the object-relational database (ORDBMS).'
164     },
165
166     'redis': {
167         title: 'Redis',
168         icon: '<i class="fa fa-database" aria-hidden="true"></i>',
169         info: 'Performance metrics for <b>redis</b>. Redis (REmote DIctionary Server) is a software project that implements data structure servers. It is open-source, networked, in-memory, and stores keys with optional durability.'
170     },
171
172     'retroshare': {
173         title: 'RetroShare',
174         icon: '<i class="fa fa-share-alt" aria-hidden="true"></i>',
175         info: 'Performance metrics for <b>RetroShare</b>. RetroShare is open source software for encrypted filesharing, serverless email, instant messaging, online chat, and BBS, based on a friend-to-friend network built on GNU Privacy Guard (GPG).'
176     },
177
178     'ipfs': {
179         title: 'IPFS',
180         icon: '<i class="fa fa-folder-open" aria-hidden="true"></i>',
181         info: 'Performance metrics for the InterPlanetary File System (IPFS), a content-addressable, peer-to-peer hypermedia distribution protocol.'
182     },
183
184     'phpfpm': {
185         title: 'PHP-FPM',
186         icon: '<i class="fa fa-eye" aria-hidden="true"></i>',
187         info: 'Performance metrics for <b>PHP-FPM</b>, an alternative FastCGI implementation for PHP.'
188     },
189
190     'postfix': {
191         title: 'postfix',
192         icon: '<i class="fa fa-envelope" aria-hidden="true"></i>',
193         info: undefined
194     },
195
196     'dovecot': {
197         title: 'Dovecot',
198         icon: '<i class="fa fa-envelope" aria-hidden="true"></i>',
199         info: undefined
200     },
201
202     'hddtemp': {
203         title: 'HDD Temp',
204         icon: '<i class="fa fa-thermometer-full" aria-hidden="true"></i>',
205         info: undefined
206     },
207
208     'nginx': {
209         title: 'nginx',
210         icon: '<i class="fa fa-eye" aria-hidden="true"></i>',
211         info: undefined
212     },
213
214     'apache': {
215         title: 'Apache',
216         icon: '<i class="fa fa-eye" aria-hidden="true"></i>',
217         info: undefined
218     },
219
220     'named': {
221         title: 'named',
222         icon: '<i class="fa fa-tag" aria-hidden="true"></i>',
223         info: undefined
224     },
225
226     'squid': {
227         title: 'squid',
228         icon: '<i class="fa fa-exchange" aria-hidden="true"></i>',
229         info: undefined
230     },
231
232     'nut': {
233         title: 'UPS',
234         icon: '<i class="fa fa-battery-half" aria-hidden="true"></i>',
235         info: undefined
236     },
237
238     'apcupsd': {
239         title: 'UPS',
240         icon: '<i class="fa fa-battery-half" aria-hidden="true"></i>',
241         info: undefined
242     },
243
244     'smawebbox': {
245         title: 'Solar Power',
246         icon: '<i class="fa fa-sun-o" aria-hidden="true"></i>',
247         info: undefined
248     },
249
250     'snmp': {
251         title: 'SNMP',
252         icon: '<i class="fa fa-random" aria-hidden="true"></i>',
253         info: undefined
254     }
255 };
256
257 // submenu
258 // information about the submenus
259 netdataDashboard.submenu = {
260     'mem.ksm': {
261         title: 'Memory Deduper',
262         info: 'Kernel Same-page Merging (KSM) performance monitoring, read from several files in <code>/sys/kernel/mm/ksm/</code>. KSM is a memory-saving de-duplication feature in the Linux kernel (since version 2.6.32). The KSM daemon ksmd periodically scans those areas of user memory which have been registered with it, looking for pages of identical content which can be replaced by a single write-protected page (which is automatically copied if a process later wants to update its content). KSM was originally developed for use with KVM (where it was known as Kernel Shared Memory), to fit more virtual machines into physical memory, by sharing the data common between them.  But it can be useful to any application which generates many instances of the same data.'
263     },
264
265     'mem.numa': {
266         info: 'Non-Uniform Memory Access (NUMA) is a hierarchical memory design the memory access time is dependent on locality. Under NUMA, a processor can access its own local memory faster than non-local memory (memory local to another processor or memory shared between processors). The individual metrics are described in the <a href="https://www.kernel.org/doc/Documentation/numastat.txt" target="_blank">Linux kernel documentation</a>.'
267     },
268
269     'ipv4.ecn': {
270         info: '<a href="https://en.wikipedia.org/wiki/Explicit_Congestion_Notification" target="_blank">Explicit Congestion Notification (ECN)</a> is a TCP extension that allows end-to-end notification of network congestion without dropping packets. ECN is an optional feature that may be used between two ECN-enabled endpoints when the underlying network infrastructure also supports it.'
271     },
272
273     'netfilter.conntrack': {
274         title: 'Connection Tracker',
275         info: 'Netfilter Connection Tracker performance metrics. The connection tracker keeps track of all connections of the machine, inbound and outbound. It works by keeping a database with all open connections, tracking network and address translation and connection expectations.'
276     },
277
278     'netfilter.nfacct': {
279         title: 'Bandwidth Accounting',
280         info: 'The following information is read using the <code>nfacct.plugin</code>.'
281     },
282
283     'netfilter.synproxy': {
284         title: 'DDoS Protection',
285         info: 'DDoS protection performance metrics. <a href="https://github.com/firehol/firehol/wiki/Working-with-SYNPROXY" target="_blank">SYNPROXY</a> is a TCP SYN packets proxy. It is used to protect any TCP server (like a web server) from SYN floods and similar DDoS attacks. It is a netfilter module, in the Linux kernel (since version 3.12). It is optimized to handle millions of packets per second utilizing all CPUs available without any concurrency locking between the connections. It can be used for any kind of TCP traffic (even encrypted), since it does not interfere with the content itself.'
286     },
287
288     'system.softnet_stat': {
289         title: 'softnet',
290         info: 'Statistics for CPUs SoftIRQs related to network receive work. Break down per CPU core can be found at <a href="#menu_cpu_submenu_softnet_stat">CPU / softnet statistics</a>. <b>processed</b> states the number of packets processed, <b>dropped</b> is the number packets dropped because the network device backlog was full (to fix them use <code>sysctl</code> to increase <code>net.core.netdev_max_backlog</code>), <b>squeezed</b> is the number of packets dropped because the network device budget ran out (to fix them use <code>sysctl</code> to increase <code>net.core.netdev_budget</code>). More information about identifying and troubleshooting network driver related issues can be found at <a href="https://access.redhat.com/sites/default/files/attachments/20150325_network_performance_tuning.pdf" target="_blank">Red Hat Enterprise Linux Network Performance Tuning Guide</a>.'
291     },
292
293     'cpu.softnet_stat': {
294         title: 'softnet',
295         info: 'Statistics for per CPUs core SoftIRQs related to network receive work. Total for all CPU cores can be found at <a href="#menu_system_submenu_softnet_stat">System / softnet statistics</a>. <b>processed</b> states the number of packets processed, <b>dropped</b> is the number packets dropped because the network device backlog was full (to fix them use <code>sysctl</code> to increase <code>net.core.netdev_max_backlog</code>), <b>squeezed</b> is the number of packets dropped because the network device budget ran out (to fix them use <code>sysctl</code> to increase <code>net.core.netdev_budget</code>). More information about identifying and troubleshooting network driver related issues can be found at <a href="https://access.redhat.com/sites/default/files/attachments/20150325_network_performance_tuning.pdf" target="_blank">Red Hat Enterprise Linux Network Performance Tuning Guide</a>.'
296     }
297 };
298
299 // chart
300 // information works on the context of a chart
301 // Its purpose is to set:
302 //
303 // info: the text above the charts
304 // heads: the representation of the chart at the top the subsection (second level menu)
305 // mainheads: the representation of the chart at the top of the section (first level menu)
306 // colors: the dimension colors of the chart (the default colors are appended)
307 // height: the ratio of the chart height relative to the default
308 //
309 netdataDashboard.context = {
310     'system.cpu': {
311         info: function() {
312             return 'Total CPU utilization (all cores). 100% here means there is no CPU idle time at all. You can get per core usage at the <a href="#menu_cpu">CPUs</a> section and per application usage at the <a href="#menu_apps">Applications Monitoring</a> section.'
313                 + netdataDashboard.sparkline('<br/>Keep an eye on <b>iowait</b> ', 'system.cpu', 'iowait', '%', '. If it is constantly high, your disks are a bottleneck and they slow your system down.')
314                 + netdataDashboard.sparkline('<br/>An important metric worth monitoring, is <b>softirq</b> ', 'system.cpu', 'softirq', '%', '. A constantly high percentage of softirq may indicate network driver issues.');
315         },
316         valueRange: "[0, 100]"
317     },
318
319     'system.load': {
320         info: 'Current system load, i.e. the number of processes using CPU or waiting for system resources (usually CPU and disk). The 3 metrics refer to 1, 5 and 15 minute averages. The system calculates this once every 5 seconds. For more information check <a href="https://en.wikipedia.org/wiki/Load_(computing)" target="_blank">this wikipedia article</a>',
321         height: 0.7
322     },
323
324     'system.io': {
325         info: 'Total Disk I/O, for all disks. You can get detailed information about each disk at the <a href="#menu_disk">Disks</a> section and per application Disk usage at the <a href="#menu_apps">Applications Monitoring</a> section.'
326     },
327
328     'system.swapio': {
329         info: 'Total Swap I/O. (netdata measures both <code>in</code> and <code>out</code>. If either of them is not shown in the chart, it is because it is zero - you can change the page settings to always render all the available dimensions on all charts).'
330     },
331
332     'system.pgfaults': {
333         info: 'Total page faults. <b>Major page faults</b> indicates that the system is using its swap. You can find which applications use the swap at the <a href="#menu_apps">Applications Monitoring</a> section.'
334     },
335
336     'system.entropy': {
337         colors: '#CC22AA',
338         info: '<a href="https://en.wikipedia.org/wiki/Entropy_(computing)" target="_blank">Entropy</a>, is like a pool of random numbers (<a href="https://en.wikipedia.org/wiki//dev/random" target="_blank">/dev/random</a>) that are mainly used in cryptography. It is advised that the pool remains always <a href="https://blog.cloudflare.com/ensuring-randomness-with-linuxs-random-number-generator/" target="_blank">above 200</a>. If the pool of entropy gets empty, you risk your security to be predictable and you should install a user-space random numbers generating daemon, like <code>haveged</code> or <code>rng-tools</code> (i.e. <b>rngd</b>), to keep the pool in healthy levels.'
339     },
340
341     'system.forks': {
342         colors: '#5555DD',
343         info: 'Number of new processes created.'
344     },
345
346     'system.intr': {
347         colors: '#DD5555',
348         info: 'Total number of CPU interrupts. Check <code>system.interrupts</code> that gives more detail about each interrupt and also the <a href="#menu_cpu">CPUs</a> section where interrupts are analyzed per CPU core.'
349     },
350
351     'system.interrupts': {
352         info: 'CPU interrupts in detail. At the <a href="#menu_cpu">CPUs</a> section, interrupts are analyzed per CPU core.'
353     },
354
355     'system.softirqs': {
356         info: 'CPU softirqs in detail. At the <a href="#menu_cpu">CPUs</a> section, softirqs are analyzed per CPU core.'
357     },
358
359     'system.processes': {
360         info: 'System processes. <b>Running</b> are the processes in the CPU. <b>Blocked</b> are processes that are willing to enter the CPU, but they cannot, e.g. because they wait for disk activity.'
361     },
362
363     'system.active_processes': {
364         info: 'All system processes.'
365     },
366
367     'system.ctxt': {
368         info: '<a href="https://en.wikipedia.org/wiki/Context_switch" target="_blank">Context Switches</a>, is the switching of the CPU from one process, task or thread to another. If there are many processes or threads willing to execute and very few CPU cores available to handle them, the system is making more context switching to balance the CPU resources among them. The whole process is computationally intensive. The more the context switches, the slower the system gets.'
369     },
370
371     'system.idlejitter': {
372         colors: '#5555AA',
373         info: 'Idle jitter is calculated by netdata. A thread is spawned that requests to sleep for a few microseconds. When the system wakes it up, it measures how many microseconds have passed. The difference between the requested and the actual duration of the sleep, is the <b>idle jitter</b>. This number is useful in real-time environments, where CPU jitter can affect the quality of the service (like VoIP media gateways).'
374     },
375
376     'system.ipv4': {
377         info: 'Total IPv4 Traffic.'
378     },
379
380     'system.ipv6': {
381         info: 'Total IPv6 Traffic.'
382     },
383
384     'system.ram': {
385         info: 'System memory usage.'
386     },
387
388     'system.swap': {
389         info: 'System swap memory usage.'
390     },
391
392     // ------------------------------------------------------------------------
393     // MEMORY
394
395     'mem.ksm_savings': {
396         heads: [
397             netdataDashboard.gaugeChart('Saved', '12%', 'savings', '#0099CC')
398         ]
399     },
400
401     'mem.ksm_ratios': {
402         heads: [
403             function(id) {
404                 return  '<div data-netdata="' + id + '"'
405                     + ' data-gauge-max-value="100"'
406                     + ' data-chart-library="gauge"'
407                     + ' data-title="Savings"'
408                     + ' data-units="percentage %"'
409                     + ' data-gauge-adjust="width"'
410                     + ' data-width="12%"'
411                     + ' data-before="0"'
412                     + ' data-after="-CHART_DURATION"'
413                     + ' data-points="CHART_DURATION"'
414                     + ' role="application"></div>';
415             }
416         ]
417     },
418
419     'mem.pgfaults': {
420         info: 'A <a href="https://en.wikipedia.org/wiki/Page_fault" target="_blank">page fault</a> is a type of interrupt, called trap, raised by computer hardware when a running program accesses a memory page that is mapped into the virtual address space, but not actually loaded into main memory. If the page is loaded in memory at the time the fault is generated, but is not marked in the memory management unit as being loaded in memory, then it is called a <b>minor</b> or soft page fault. A <b>major</b> page fault is generated when the system needs to load the memory page from disk or swap memory.'
421     },
422
423     'mem.committed': {
424         colors: NETDATA.colors[3],
425         info: 'Committed Memory, is the sum of all memory which has been allocated by processes.'
426     },
427
428     'mem.writeback': {
429         info: '<b>Dirty</b> is the amount of memory waiting to be written to disk. <b>Writeback</b> is how much memory is actively being written to disk.'
430     },
431
432     'mem.kernel': {
433         info: 'The total ammount of memory being used by the kernel. <b>Slab</b> is the amount of memory used by the kernel to cache data structures for its own use. <b>KernelStack</b> is the amount of memory allocated for each task done by the kernel. <b>PageTables</b> is the amount of memory decicated to the lowest level of page tables (A page table is used to turn a virtual address into a physical memory address). <b>VmallocUsed</b> is the amount of memory being used as virtual address space.'
434     },
435
436     'mem.slab': {
437         info: '<b>Reclaimable</b> is the amount of memory which the kernel can reuse. <b>Unreclaimable</b> can not be reused even when the kernel is lacking memory.'
438     },
439
440     // ------------------------------------------------------------------------
441     // network interfaces
442
443     'net.drops': {
444         info: 'Packets that have been dropped at the network interface level. These are the same counters reported by <code>ifconfig</code> as <code>RX dropped</code> (inbound) and <code>TX dropped</code> (outbound). <b>inbound</b> packets can be dropped at the network interface level due to <a href="#menu_system_submenu_softnet_stat">softnet backlog</a> overflow, bad / unintented VLAN tags, unknown or unregistered protocols, IPv6 frames when the server is not configured for IPv6. Check <a href="https://www.novell.com/support/kb/doc.php?id=7007165" target="_blank">this document</a> for more information.'
445     },
446
447     // ------------------------------------------------------------------------
448     // IPv4
449
450     'ipv4.tcpmemorypressures': {
451         info: 'Number of times a socket was put in <b>memory pressure</b> due to a non fatal memory allocation failure (the kernel attempts to work around this situation by reducing the send buffers, etc).'
452     },
453
454     'ipv4.tcpconnaborts': {
455         info: 'TCP connection aborts. <b>baddata</b> (<code>TCPAbortOnData</code>) happens while the connection is on <code>FIN_WAIT1</code> and the kernel receives a packet with a sequence number beyond the last one for this connection - the kernel responds with <code>RST</code> (closes the connection). <b>userclosed</b> (<code>TCPAbortOnClose</code>) happens when the kernel receives data on an already closed connection and responds with <code>RST</code>. <b>nomemory</b> (<code>TCPAbortOnMemory</code> happens when there are too many orphaned sockets (not attached to an fd) and the kernel has to drop a connection - sometimes it will send an <code>RST</code>, sometimes it won\'t. <b>timeout</b> (<code>TCPAbortOnTimeout</code>) happens when a connection times out. <b>linger</b> (<code>TCPAbortOnLinger</code>) happens when the kernel killed a socket that was already closed by the application and lingered around for long enough. <b>failed</b> (<code>TCPAbortFailed</code>) happens when the kernel attempted to send an <code>RST</code> but failed because there was no memory available.'
456     },
457
458     // ------------------------------------------------------------------------
459     // APPS
460
461     'apps.cpu': {
462         height: 2.0
463     },
464
465     'apps.mem': {
466         info: 'Real memory (RAM) used by applications. This does not include shared memory.'
467     },
468
469     'apps.vmem': {
470         info: 'Virtual memory allocated by applications. Please check <a href="https://github.com/firehol/netdata/wiki/netdata-virtual-memory-size" target="_blank">this article</a> for more information.'
471     },
472
473     'apps.preads': {
474         height: 2.0
475     },
476
477     'apps.pwrites': {
478         height: 2.0
479     },
480
481     // ------------------------------------------------------------------------
482     // USERS
483
484     'users.cpu': {
485         height: 2.0
486     },
487
488     'users.mem': {
489         info: 'Real memory (RAM) used per user. This does not include shared memory.'
490     },
491
492     'users.vmem': {
493         info: 'Virtual memory allocated per user. Please check <a href="https://github.com/firehol/netdata/wiki/netdata-virtual-memory-size" target="_blank">this article</a> for more information.'
494     },
495
496     'users.preads': {
497         height: 2.0
498     },
499
500     'users.pwrites': {
501         height: 2.0
502     },
503
504     // ------------------------------------------------------------------------
505     // GROUPS
506
507     'groups.cpu': {
508         height: 2.0
509     },
510
511     'groups.mem': {
512         info: 'Real memory (RAM) used per user group. This does not include shared memory.'
513     },
514
515     'groups.vmem': {
516         info: 'Virtual memory allocated per user group. Please check <a href="https://github.com/firehol/netdata/wiki/netdata-virtual-memory-size" target="_blank">this article</a> for more information.'
517     },
518
519     'groups.preads': {
520         height: 2.0
521     },
522
523     'groups.pwrites': {
524         height: 2.0
525     },
526
527     // ------------------------------------------------------------------------
528     // NETWORK QoS
529
530     'tc.qos': {
531         heads: [
532             function(id) {
533                 if(id.match(/.*-ifb$/))
534                     return netdataDashboard.gaugeChart('Inbound', '12%', '', '#5555AA');
535                 else
536                     return netdataDashboard.gaugeChart('Outbound', '12%', '', '#AA9900');
537             }
538         ]
539     },
540
541     // ------------------------------------------------------------------------
542     // NETWORK INTERFACES
543
544     'net.net': {
545         heads: [
546             netdataDashboard.gaugeChart('Received', '12%', 'received'),
547             netdataDashboard.gaugeChart('Sent', '12%', 'sent')
548         ]
549     },
550
551     // ------------------------------------------------------------------------
552     // NETFILTER
553
554     'netfilter.sockets': {
555         colors: '#88AA00',
556         heads: [
557             netdataDashboard.gaugeChart('Active Connections', '12%', '', '#88AA00')
558         ]
559     },
560
561     'netfilter.new': {
562         heads: [
563             netdataDashboard.gaugeChart('New Connections', '12%', 'new', '#5555AA')
564         ]
565     },
566
567     // ------------------------------------------------------------------------
568     // DISKS
569
570     'disk.util': {
571         colors: '#FF5588',
572         heads: [
573             netdataDashboard.gaugeChart('Utilization', '12%', '', '#FF5588')
574         ],
575         info: 'Disk Utilization measures the amount of time the disk was busy with something. This is not related to its performance. 100% means that the system always had an outstanding operation on the disk. Keep in mind that depending on the underlying technology of the disk, 100% here may or may not be an indication of congestion.'
576     },
577
578     'disk.backlog': {
579         colors: '#0099CC',
580         info: 'Backlog is an indication of the duration of pending disk operations. On every I/O event the system is multiplying the time spent doing I/O since the last update of this field with the number of pending operations. While not accurate, this metric can provide an indication of the expected completion time of the operations in progress.'
581     },
582
583     'disk.io': {
584         heads: [
585             netdataDashboard.gaugeChart('Read', '12%', 'reads'),
586             netdataDashboard.gaugeChart('Write', '12%', 'writes')
587         ],
588         info: 'Amount of data transferred to and from disk.'
589     },
590
591     'disk.ops': {
592         info: 'Completed disk I/O operations. Keep in mind the number of operations requested might be higher, since the system is able to merge adjacent to each other (see merged operations chart).'
593     },
594
595     'disk.qops': {
596         info: 'I/O operations currently in progress. This metric is a snapshot - it is not an average over the last interval.'
597     },
598
599     'disk.iotime': {
600         height: 0.5,
601         info: 'The sum of the duration of all completed I/O operations. This number can exceed the interval if the disk is able to execute I/O operations in parallel.'
602     },
603     'disk.mops': {
604         height: 0.5,
605         info: 'The number of merged disk operations. The system is able to merge adjacent I/O operations, for example two 4KB reads can become one 8KB read before given to disk.'
606     },
607     'disk.svctm': {
608         height: 0.5,
609         info: 'The average service time for completed I/O operations. This metric is calculated using the total busy time of the disk and the number of completed operations. If the disk is able to execute multiple parallel operations the reporting average service time will be misleading.'
610     },
611     'disk.avgsz': {
612         height: 0.5,
613         info: 'The average I/O operation size.'
614     },
615     'disk.await': {
616         height: 0.5,
617         info: 'The average time for I/O requests issued to the device to be served. This includes the time spent by the requests in queue and the time spent servicing them.'
618     },
619
620     'disk.space': {
621         info: 'Disk space utilization. reserved for root is automatically reserved by the system to prevent the root user from getting out of space.'
622     },
623     'disk.inodes': {
624         info: 'inodes (or index nodes) are filesystem objects (e.g. files and directories). On many types of file system implementations, the maximum number of inodes is fixed at filesystem creation, limiting the maximum number of files the filesystem can hold. It is possible for a device to run out of inodes. When this happens, new files cannot be created on the device, even though there may be free space available.'
625     },
626
627     'mysql.net': {
628         info: 'The amount of data sent to mysql clients (<strong>out</strong>) and received from mysql clients (<strong>in</strong>).'
629     },
630
631     // ------------------------------------------------------------------------
632     // MYSQL
633
634     'mysql.queries': {
635         info: 'The number of statements executed by the server.<ul>' +
636         '<li><strong>queries</strong> counts the statements executed within stored SQL programs.</li>' +
637         '<li><strong>questions</strong> counts the statements sent to the mysql server by mysql clients.</li>' +
638         '<li><strong>slow queries</strong> counts the number of statements that took more than <a href="http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_long_query_time" target="_blank">long_query_time</a> seconds to be executed.' +
639         ' For more information about slow queries check the mysql <a href="http://dev.mysql.com/doc/refman/5.7/en/slow-query-log.html" target="_blank">slow query log</a>.</li>' +
640         '</ul>'
641     },
642
643     'mysql.handlers': {
644         info: 'Usage of the internal handlers of mysql. This chart provides very good insights of what the mysql server is actually doing.' +
645         ' (if the chart is not showing all these dimensions it is because they are zero - set <strong>Which dimensions to show?</strong> to <strong>All</strong> from the dashboard settings, to render even the zero values)<ul>' +
646         '<li><strong>commit</strong>, the number of internal <a href="http://dev.mysql.com/doc/refman/5.7/en/commit.html" target="_blank">COMMIT</a> statements.</li>' +
647         '<li><strong>delete</strong>, the number of times that rows have been deleted from tables.</li>' +
648         '<li><strong>prepare</strong>, a counter for the prepare phase of two-phase commit operations.</li>' +
649         '<li><strong>read first</strong>, the number of times the first entry in an index was read. A high value suggests that the server is doing a lot of full index scans; e.g. <strong>SELECT col1 FROM foo</strong>, with col1 indexed.</li>' +
650         '<li><strong>read key</strong>, the number of requests to read a row based on a key. If this value is high, it is a good indication that your tables are properly indexed for your queries.</li>' +
651         '<li><strong>read next</strong>, the number of requests to read the next row in key order. This value is incremented if you are querying an index column with a range constraint or if you are doing an index scan.</li>' +
652         '<li><strong>read prev</strong>, the number of requests to read the previous row in key order. This read method is mainly used to optimize <strong>ORDER BY ... DESC</strong>.</li>' +
653         '<li><strong>read rnd</strong>, the number of requests to read a row based on a fixed position. A high value indicates you are doing a lot of queries that require sorting of the result. You probably have a lot of queries that require MySQL to scan entire tables or you have joins that do not use keys properly.</li>' +
654         '<li><strong>read rnd next</strong>, the number of requests to read the next row in the data file. This value is high if you are doing a lot of table scans. Generally this suggests that your tables are not properly indexed or that your queries are not written to take advantage of the indexes you have.</li>' +
655         '<li><strong>rollback</strong>, the number of requests for a storage engine to perform a rollback operation.</li>' +
656         '<li><strong>savepoint</strong>, the number of requests for a storage engine to place a savepoint.</li>' +
657         '<li><strong>savepoint rollback</strong>, the number of requests for a storage engine to roll back to a savepoint.</li>' +
658         '<li><strong>update</strong>, the number of requests to update a row in a table.</li>' +
659         '<li><strong>write</strong>, the number of requests to insert a row in a table.</li>' +
660         '</ul>'
661     },
662
663     'mysql.table_locks': {
664         info: 'MySQL table locks counters: <ul>' +
665         '<li><strong>immediate</strong>, the number of times that a request for a table lock could be granted immediately.</li>' +
666         '<li><strong>waited</strong>, the number of times that a request for a table lock could not be granted immediately and a wait was needed. If this is high and you have performance problems, you should first optimize your queries, and then either split your table or tables or use replication.</li>' +
667         '</ul>'
668     },
669
670     // ------------------------------------------------------------------------
671     // APACHE
672
673     'apache.connections': {
674         colors: NETDATA.colors[4],
675         mainheads: [
676             netdataDashboard.gaugeChart('Connections', '12%', '', NETDATA.colors[4])
677         ]
678     },
679
680     'apache.requests': {
681         colors: NETDATA.colors[0],
682         mainheads: [
683             netdataDashboard.gaugeChart('Requests', '12%', '', NETDATA.colors[0])
684         ]
685     },
686
687     'apache.net': {
688         colors: NETDATA.colors[3],
689         mainheads: [
690             netdataDashboard.gaugeChart('Bandwidth', '12%', '', NETDATA.colors[3])
691         ]
692     },
693
694     'apache.workers': {
695         mainheads: [
696             function(id) {
697                 return  '<div data-netdata="' + id + '"'
698                     + ' data-dimensions="busy"'
699                     + ' data-append-options="percentage"'
700                     + ' data-gauge-max-value="100"'
701                     + ' data-chart-library="gauge"'
702                     + ' data-title="Workers Utilization"'
703                     + ' data-units="percentage %"'
704                     + ' data-gauge-adjust="width"'
705                     + ' data-width="12%"'
706                     + ' data-before="0"'
707                     + ' data-after="-CHART_DURATION"'
708                     + ' data-points="CHART_DURATION"'
709                     + ' role="application"></div>';
710             }
711         ]
712     },
713
714     'apache.bytesperreq': {
715         colors: NETDATA.colors[3],
716         height: 0.5
717     },
718
719     'apache.reqpersec': {
720         colors: NETDATA.colors[4],
721         height: 0.5
722     },
723
724     'apache.bytespersec': {
725         colors: NETDATA.colors[6],
726         height: 0.5
727     },
728
729
730     // ------------------------------------------------------------------------
731     // NGINX
732
733     'nginx.connections': {
734         colors: NETDATA.colors[4],
735         mainheads: [
736             netdataDashboard.gaugeChart('Connections', '12%', '', NETDATA.colors[4])
737         ]
738     },
739
740     'nginx.requests': {
741         colors: NETDATA.colors[0],
742         mainheads: [
743             netdataDashboard.gaugeChart('Requests', '12%', '', NETDATA.colors[0])
744         ]
745     },
746
747     // ------------------------------------------------------------------------
748     // NETDATA
749
750     'netdata.response_time': {
751         info: 'The netdata API response time measures the time netdata needed to serve requests. This time includes everything, from the reception of the first byte of a request, to the dispatch of the last byte of its reply, therefore it includes all network latencies involved (i.e. a client over a slow network will influence these metrics).'
752     },
753
754     // ------------------------------------------------------------------------
755     // RETROSHARE
756
757     'retroshare.bandwidth': {
758         info: 'RetroShare inbound and outbound traffic.',
759         mainheads: [
760             netdataDashboard.gaugeChart('Received', '12%', 'bandwidth_down_kb'),
761             netdataDashboard.gaugeChart('Sent', '12%', 'bandwidth_up_kb')
762         ]
763     },
764
765     'retroshare.peers': {
766         info: 'Number of (connected) RetroShare friends.',
767         mainheads: [
768             function(id) {
769                 return  '<div data-netdata="' + id + '"'
770                     + ' data-dimensions="peers_connected"'
771                     + ' data-append-options="friends"'
772                     + ' data-chart-library="easypiechart"'
773                     + ' data-title="connected friends"'
774                     + ' data-units=""'
775                     + ' data-width="8%"'
776                     + ' data-before="0"'
777                     + ' data-after="-CHART_DURATION"'
778                     + ' data-points="CHART_DURATION"'
779                     + ' role="application"></div>';
780             }
781         ]
782     },
783
784     'retroshare.dht': {
785         info: 'Statistics about RetroShare\'s DHT. These values are estimated!'
786     },
787
788     // ------------------------------------------------------------------------
789     // fping
790
791     'fping.quality': {
792         colors: NETDATA.colors[10],
793         height: 0.5
794     },
795
796     'fping.packets': {
797         height: 0.5
798     }
799
800 };