python.d/README.md

   1 # Disclaimer
   2
   3 Every module should be compatible with python2 and python3.
   4 All third party libraries should be installed system-wide or in `python_modules` directory.
   5 Module configurations are written in YAML and **pyYAML is required**.
   6
   7 Every configuration file must have one of two formats:
   8
   9 - Configuration for only one job:
  10
  11 ```yaml
  12 update_every : 2 # update frequency
  13 retries      : 1 # how many failures in update() is tolerated
  14 priority     : 20000 # where it is shown on dashboard
  15
  16 other_var1   : bla  # variables passed to module
  17 other_var2   : alb
  18 ```
  19
  20 - Configuration for many jobs (ex. mysql):
  21
  22 ```yaml
  23 # module defaults:
  24 update_every : 2
  25 retries      : 1
  26 priority     : 20000
  27
  28 local:  # job name
  29   update_every : 5 # job update frequency
  30   other_var1   : some_val # module specific variable
  31
  32 other_job:
  33   priority     : 5 # job position on dashboard
  34   retries      : 20 # job retries
  35   other_var2   : val # module specific variable
  36 ```
  37
  38 `update_every`, `retries`, and `priority` are always optional.
  39
  40 ---
  41
  42 The following python.d modules are supported:
  43
  44 # apache
  45
  46 This module will monitor one or more apache servers depending on configuration.
  47
  48 **Requirements:**
  49  * apache with enabled `mod_status`
  50
  51 It produces the following charts:
  52
  53 1. **Requests** in requests/s
  54  * requests
  55
  56 2. **Connections**
  57  * connections
  58
  59 3. **Async Connections**
  60  * keepalive
  61  * closing
  62  * writing
  63
  64 4. **Bandwidth** in kilobytes/s
  65  * sent
  66
  67 5. **Workers**
  68  * idle
  69  * busy
  70
  71 6. **Lifetime Avg. Requests/s** in requests/s
  72  * requests_sec
  73
  74 7. **Lifetime Avg. Bandwidth/s** in kilobytes/s
  75  * size_sec
  76
  77 8. **Lifetime Avg. Response Size** in bytes/request
  78  * size_req
  79
  80 ### configuration
  81
  82 Needs only `url` to server's `server-status?auto`
  83
  84 Here is an example for 2 servers:
  85
  86 ```yaml
  87 update_every : 10
  88 priority     : 90100
  89
  90 local:
  91   url      : 'http://localhost/server-status?auto'
  92   retries  : 20
  93
  94 remote:
  95   url          : 'http://www.apache.org/server-status?auto'
  96   update_every : 5
  97   retries      : 4
  98 ```
  99
 100 Without configuration, module attempts to connect to `http://localhost/server-status?auto`
 101
 102 ---
 103
 104 # apache_cache
 105
 106 Module monitors apache mod_cache log and produces only one chart:
 107
 108 **cached responses** in percent cached
 109  * hit
 110  * miss
 111  * other
 112
 113 ### configuration
 114
 115 Sample:
 116
 117 ```yaml
 118 update_every : 10
 119 priority     : 120000
 120 retries      : 5
 121 log_path     : '/var/log/apache2/cache.log'
 122 ```
 123
 124 If no configuration is given, module will attempt to read log file at `/var/log/apache2/cache.log`
 125
 126 ---
 127
 128 # bind_rndc
 129
 130 Module parses bind dump file to collect real-time performance metrics
 131
 132 **Requirements:**
 133  * Version of bind must be 9.6 +
 134  * Netdata must have permissions to run `rndc status`
 135
 136 It produces:
 137
 138 1. **Name server statistics**
 139  * requests
 140  * responses
 141  * success
 142  * auth_answer
 143  * nonauth_answer
 144  * nxrrset
 145  * failure
 146  * nxdomain
 147  * recursion
 148  * duplicate
 149  * rejections
 150
 151 2. **Incoming queries**
 152  * RESERVED0
 153  * A
 154  * NS
 155  * CNAME
 156  * SOA
 157  * PTR
 158  * MX
 159  * TXT
 160  * X25
 161  * AAAA
 162  * SRV
 163  * NAPTR
 164  * A6
 165  * DS
 166  * RSIG
 167  * DNSKEY
 168  * SPF
 169  * ANY
 170  * DLV
 171
 172 3. **Outgoing queries**
 173  * Same as Incoming queries
 174
 175
 176 ### configuration
 177
 178 Sample:
 179
 180 ```yaml
 181 local:
 182   named_stats_path       : '/var/log/bind/named.stats'
 183 ```
 184
 185 If no configuration is given, module will attempt to read named.stats file  at `/var/log/bind/named.stats`
 186
 187 ---
 188
 189 # cpufreq
 190
 191 This module shows the current CPU frequency as set by the cpufreq kernel
 192 module.
 193
 194 **Requirement:**
 195 You need to have `CONFIG_CPU_FREQ` and (optionally) `CONFIG_CPU_FREQ_STAT`
 196 enabled in your kernel.
 197
 198 This module tries to read from one of two possible locations. On
 199 initialization, it tries to read the `time_in_state` files provided by
 200 cpufreq\_stats. If this file does not exist, or doesn't contain valid data, it
 201 falls back to using the more inaccurate `scaling_cur_freq` file (which only
 202 represents the **current** CPU frequency, and doesn't account for any state
 203 changes which happen between updates).
 204
 205 It produces one chart with multiple lines (one line per core).
 206
 207 ### configuration
 208
 209 Sample:
 210
 211 ```yaml
 212 sys_dir: "/sys/devices"
 213 ```
 214
 215 If no configuration is given, module will search for cpufreq files in `/sys/devices` directory.
 216 Directory is also prefixed with `NETDATA_HOST_PREFIX` if specified.
 217
 218 ---
 219
 220 # cpuidle
 221
 222 This module monitors the usage of CPU idle states.
 223
 224 **Requirement:**
 225 Your kernel needs to have `CONFIG_CPU_IDLE` enabled.
 226
 227 It produces one stacked chart per CPU, showing the percentage of time spent in
 228 each state.
 229
 230 ---
 231
 232 # dovecot
 233
 234 This module provides statistics information from dovecot server.
 235 Statistics are taken from dovecot socket by executing `EXPORT global` command.
 236 More information about dovecot stats can be found on [project wiki page.](http://wiki2.dovecot.org/Statistics)
 237
 238 **Requirement:**
 239 Dovecot unix socket with R/W permissions for user netdata or dovecot with configured TCP/IP socket.
 240
 241 Module gives information with following charts:
 242
 243 1. **sessions**
 244  * active sessions
 245
 246 2. **logins**
 247  * logins
 248
 249 3. **commands** - number of IMAP commands
 250  * commands
 251
 252 4. **Faults**
 253  * minor
 254  * major
 255
 256 5. **Context Switches**
 257  * volountary
 258  * involountary
 259
 260 6. **disk** in bytes/s
 261  * read
 262  * write
 263
 264 7. **bytes** in bytes/s
 265  * read
 266  * write
 267
 268 8. **number of syscalls** in syscalls/s
 269  * read
 270  * write
 271
 272 9. **lookups** - number of lookups per second
 273  * path
 274  * attr
 275
 276 10. **hits** - number of cache hits
 277  * hits
 278
 279 11. **attempts** - authorization attemts
 280  * success
 281  * failure
 282
 283 12. **cache** - cached authorization hits
 284  * hit
 285  * miss
 286
 287 ### configuration
 288
 289 Sample:
 290
 291 ```yaml
 292 localtcpip:
 293   name     : 'local'
 294   host     : '127.0.0.1'
 295   port     : 24242
 296
 297 localsocket:
 298   name     : 'local'
 299   socket   : '/var/run/dovecot/stats'
 300 ```
 301
 302 If no configuration is given, module will attempt to connect to dovecot using unix socket localized in `/var/run/dovecot/stats`
 303
 304 ---
 305
 306 # elasticsearch
 307
 308 Module monitor elasticsearch performance and health metrics
 309
 310 **Requirements:**
 311  * python `requests` package.
 312
 313 You need to install it manually. (python-requests or python3-requests depending on the version of python).
 314
 315
 316 It produces:
 317
 318 1. **Search performance** charts:
 319  * Number of queries, fetches
 320  * Time spent on queries, fetches
 321  * Query and fetch latency
 322
 323 2. **Indexing performance** charts:
 324  * Number of documents indexed, index refreshes, flushes
 325  * Time spent on indexing, refreshing, flushing
 326  * Indexing and flushing latency
 327
 328 3. **Memory usage and garbace collection** charts:
 329  * JVM heap currently in use, commited
 330  * Count of garbage collections
 331  * Time spent on garbage collections
 332
 333 4. **Host metrics** charts:
 334  * Available file descriptors in percent
 335  * Opened HTTP connections
 336  * Cluster communication transport metrics
 337
 338 5. **Queues and rejections** charts:
 339  * Number of queued/rejected threads in thread pool
 340
 341 6. **Fielddata cache** charts:
 342  * Fielddata cache size
 343  * Fielddata evictions and circuit breaker tripped count
 344
 345 7. **Cluster health API** charts:
 346  * Cluster status
 347  * Nodes and tasks statistics
 348  * Shards statistics
 349
 350 8. **Cluster stats API** charts:
 351  * Nodes statistics
 352  * Query cache statistics
 353  * Docs statistics
 354  * Store statistics
 355  * Indices and shards statistics
 356
 357 ### configuration
 358
 359 Sample:
 360
 361 ```yaml
 362 local:
 363   host               :  'ipaddress'   # Server ip address or hostname
 364   port               : 'password'     # Port on which elasticsearch listed
 365   cluster_health     :  True/False    # Calls to cluster health elasticsearch API. Enabled by default.
 366   cluster_stats      :  True/False    # Calls to cluster stats elasticsearch API. Enabled by default.
 367 ```
 368
 369 If no configuration is given, module will fail to run.
 370
 371 ---
 372
 373 # exim
 374
 375 Simple module executing `exim -bpc` to grab exim queue.
 376 This command can take a lot of time to finish its execution thus it is not recommended to run it every second.
 377
 378 It produces only one chart:
 379
 380 1. **Exim Queue Emails**
 381  * emails
 382
 383 Configuration is not needed.
 384
 385 ---
 386
 387 # fail2ban
 388
 389 Module monitor fail2ban log file to show all bans for all active jails
 390
 391 **Requirements:**
 392  * fail2ban.log file MUST BE readable by netdata (A good idea is to add  **create 0640 root netdata** to fail2ban conf at logrotate.d)
 393
 394 It produces one chart with multiple lines (one line per jail)
 395
 396 ### configuration
 397
 398 Sample:
 399
 400 ```yaml
 401 local:
 402  log_path: '/var/log/fail2ban.log'
 403  conf_path: '/etc/fail2ban/jail.local'
 404  exclude: 'dropbear apache'
 405 ```
 406 If no configuration is given, module will attempt to read log file at `/var/log/fail2ban.log` and conf file at `/etc/fail2ban/jail.local`.
 407 If conf file is not found default jail is `ssh`.
 408
 409 ---
 410
 411 # freeradius
 412
 413 Uses the `radclient` command to provide freeradius statistics. It is not recommended to run it every second.
 414
 415 It produces:
 416
 417 1. **Authentication counters:**
 418  * access-accepts
 419  * access-rejects
 420  * auth-dropped-requests
 421  * auth-duplicate-requests
 422  * auth-invalid-requests
 423  * auth-malformed-requests
 424  * auth-unknown-types
 425
 426 2. **Accounting counters:** [optional]
 427  * accounting-requests
 428  * accounting-responses
 429  * acct-dropped-requests
 430  * acct-duplicate-requests
 431  * acct-invalid-requests
 432  * acct-malformed-requests
 433  * acct-unknown-types
 434
 435 3. **Proxy authentication counters:** [optional]
 436  * proxy-access-accepts
 437  * proxy-access-rejects
 438  * proxy-auth-dropped-requests
 439  * proxy-auth-duplicate-requests
 440  * proxy-auth-invalid-requests
 441  * proxy-auth-malformed-requests
 442  * proxy-auth-unknown-types
 443
 444 4. **Proxy accounting counters:** [optional]
 445  * proxy-accounting-requests
 446  * proxy-accounting-responses
 447  * proxy-acct-dropped-requests
 448  * proxy-acct-duplicate-requests
 449  * proxy-acct-invalid-requests
 450  * proxy-acct-malformed-requests
 451  * proxy-acct-unknown-typesa
 452
 453
 454 ### configuration
 455
 456 Sample:
 457
 458 ```yaml
 459 local:
 460   host       : 'localhost'
 461   port       : '18121'
 462   secret     : 'adminsecret'
 463   acct       : False # Freeradius accounting statistics.
 464   proxy_auth : False # Freeradius proxy authentication statistics.
 465   proxy_acct : False # Freeradius proxy accounting statistics.
 466 ```
 467
 468 **Freeradius server configuration:**
 469
 470 The configuration for the status server is automatically created in the sites-available directory.
 471 By default, server is enabled and can be queried from every client.
 472 FreeRADIUS will only respond to status-server messages, if the status-server virtual server has been enabled.
 473
 474 To do this, create a link from the sites-enabled directory to the status file in the sites-available directory:
 475  * cd sites-enabled
 476  * ln -s ../sites-available/status status
 477
 478 and restart/reload your FREERADIUS server.
 479
 480 ---
 481
 482 # haproxy
 483
 484 Module monitors frontend and backend metrics such as bytes in, bytes out, sessions current, sessions in queue current.
 485 And health metrics such as backend servers status (server check should be used).
 486
 487 Plugin can obtain data from url **OR** unix socket.
 488
 489 **Requirement:**
 490 Socket MUST be readable AND writable by netdata user.
 491
 492 It produces:
 493
 494 1. **Frontend** family charts
 495  * Kilobytes in/s
 496  * Kilobytes out/s
 497  * Sessions current
 498  * Sessions in queue current
 499
 500 2. **Backend** family charts
 501  * Kilobytes in/s
 502  * Kilobytes out/s
 503  * Sessions current
 504  * Sessions in queue current
 505
 506 3. **Health** chart
 507  * number of failed servers for every backend (in DOWN state)
 508
 509
 510 ### configuration
 511
 512 Sample:
 513
 514 ```yaml
 515 via_url:
 516   user       : 'username' # ONLY IF stats auth is used
 517   pass       : 'password' # # ONLY IF stats auth is used
 518   url     : 'http://ip.address:port/url;csv;norefresh'
 519 ```
 520
 521 OR
 522
 523 ```yaml
 524 via_socket:
 525   socket       : 'path/to/haproxy/sock'
 526 ```
 527
 528 If no configuration is given, module will fail to run.
 529
 530 ---
 531
 532 # hddtemp
 533
 534 Module monitors disk temperatures from one or more hddtemp daemons.
 535
 536 **Requirement:**
 537 Running `hddtemp` in daemonized mode with access on tcp port
 538
 539 It produces one chart **Temperature** with dynamic number of dimensions (one per disk)
 540
 541 ### configuration
 542
 543 Sample:
 544
 545 ```yaml
 546 update_every: 3
 547 host: "127.0.0.1"
 548 port: 7634
 549 ```
 550
 551 If no configuration is given, module will attempt to connect to hddtemp daemon on `127.0.0.1:7634` address
 552
 553 ---
 554
 555 # IPFS
 556
 557 Module monitors [IPFS](https://ipfs.io) basic information.
 558
 559 1. **Bandwidth** in kbits/s
 560  * in
 561  * out
 562
 563 2. **Peers**
 564  * peers
 565
 566 ### configuration
 567
 568 Only url to IPFS server is needed.
 569
 570 Sample:
 571
 572 ```yaml
 573 localhost:
 574   name : 'local'
 575   url  : 'http://localhost:5001'
 576 ```
 577
 578 ---
 579
 580 # isc_dhcpd
 581
 582 Module monitor leases database to show all active leases for given pools.
 583
 584 **Requirements:**
 585  * dhcpd leases file MUST BE readable by netdata
 586  * pools MUST BE in CIDR format
 587
 588 It produces:
 589
 590 1. **Pools utilization** Aggregate chart for all pools.
 591  * utilization in percent
 592
 593 2. **Total leases**
 594  * leases (overall number of leases for all pools)
 595
 596 3. **Active leases** for every pools
 597   * leases (number of active leases in pool)
 598
 599
 600 ### configuration
 601
 602 Sample:
 603
 604 ```yaml
 605 local:
 606   leases_path       : '/var/lib/dhcp/dhcpd.leases'
 607   pools       : '192.168.3.0/24 192.168.4.0/24 192.168.5.0/24'
 608 ```
 609
 610 In case of python2 you need to  install `py2-ipaddress` to make plugin work.
 611 The module will not work If no configuration is given.
 612
 613 ---
 614
 615
 616 # mdstat
 617
 618 Module monitor /proc/mdstat
 619
 620 It produces:
 621
 622 1. **Health** Number of failed disks in every array (aggregate chart).
 623
 624 2. **Disks stats**
 625  * total (number of devices array ideally would have)
 626  * inuse (number of devices currently are in use)
 627
 628 3. **Current status**
 629  * resync in percent
 630  * recovery in percent
 631  * reshape in percent
 632  * check in percent
 633
 634 4. **Operation status** (if resync/recovery/reshape/check is active)
 635  * finish in minutes
 636  * speed in megabytes/s
 637
 638 ### configuration
 639 No configuration is needed.
 640
 641 ---
 642
 643 # memcached
 644
 645 Memcached monitoring module. Data grabbed from [stats interface](https://github.com/memcached/memcached/wiki/Commands#stats).
 646
 647 1. **Network** in kilobytes/s
 648  * read
 649  * written
 650
 651 2. **Connections** per second
 652  * current
 653  * rejected
 654  * total
 655
 656 3. **Items** in cluster
 657  * current
 658  * total
 659
 660 4. **Evicted and Reclaimed** items
 661  * evicted
 662  * reclaimed
 663
 664 5. **GET** requests/s
 665  * hits
 666  * misses
 667
 668 6. **GET rate** rate in requests/s
 669  * rate
 670
 671 7. **SET rate** rate in requests/s
 672  * rate
 673
 674 8. **DELETE** requests/s
 675  * hits
 676  * misses
 677
 678 9. **CAS** requests/s
 679  * hits
 680  * misses
 681  * bad value
 682
 683 10. **Increment** requests/s
 684  * hits
 685  * misses
 686
 687 11. **Decrement** requests/s
 688  * hits
 689  * misses
 690
 691 12. **Touch** requests/s
 692  * hits
 693  * misses
 694
 695 13. **Touch rate** rate in requests/s
 696  * rate
 697
 698 ### configuration
 699
 700 Sample:
 701
 702 ```yaml
 703 localtcpip:
 704   name     : 'local'
 705   host     : '127.0.0.1'
 706   port     : 24242
 707 ```
 708
 709 If no configuration is given, module will attempt to connect to memcached instance on `127.0.0.1:11211` address.
 710
 711 ---
 712
 713 # mysql
 714
 715 Module monitors one or more mysql servers
 716
 717 **Requirements:**
 718  * python library [MySQLdb](https://github.com/PyMySQL/mysqlclient-python) (faster) or [PyMySQL](https://github.com/PyMySQL/PyMySQL) (slower)
 719
 720 It will produce following charts (if data is available):
 721
 722 1. **Bandwidth** in kbps
 723  * in
 724  * out
 725
 726 2. **Queries** in queries/sec
 727  * queries
 728  * questions
 729  * slow queries
 730
 731 3. **Operations** in operations/sec
 732  * opened tables
 733  * flush
 734  * commit
 735  * delete
 736  * prepare
 737  * read first
 738  * read key
 739  * read next
 740  * read prev
 741  * read random
 742  * read random next
 743  * rollback
 744  * save point
 745  * update
 746  * write
 747
 748 4. **Table Locks** in locks/sec
 749  * immediate
 750  * waited
 751
 752 5. **Select Issues** in issues/sec
 753  * full join
 754  * full range join
 755  * range
 756  * range check
 757  * scan
 758
 759 6. **Sort Issues** in issues/sec
 760  * merge passes
 761  * range
 762  * scan
 763
 764 ### configuration
 765
 766 You can provide, per server, the following:
 767
 768 1. username which have access to database (deafults to 'root')
 769 2. password (defaults to none)
 770 3. mysql my.cnf configuration file
 771 4. mysql socket (optional)
 772 5. mysql host (ip or hostname)
 773 6. mysql port (defaults to 3306)
 774
 775 Here is an example for 3 servers:
 776
 777 ```yaml
 778 update_every : 10
 779 priority     : 90100
 780 retries      : 5
 781
 782 local:
 783   'my.cnf'   : '/etc/mysql/my.cnf'
 784   priority   : 90000
 785
 786 local_2:
 787   user     : 'root'
 788   pass : 'blablablabla'
 789   socket   : '/var/run/mysqld/mysqld.sock'
 790   update_every : 1
 791
 792 remote:
 793   user     : 'admin'
 794   pass : 'bla'
 795   host     : 'example.org'
 796   port     : 9000
 797   retries  : 20
 798 ```
 799
 800 If no configuration is given, module will attempt to connect to mysql server via unix socket at `/var/run/mysqld/mysqld.sock` without password and with username `root`
 801
 802 ---
 803
 804 # nginx
 805
 806 This module will monitor one or more nginx servers depending on configuration. Servers can be either local or remote.
 807
 808 **Requirements:**
 809  * nginx with configured 'ngx_http_stub_status_module'
 810  * 'location /stub_status'
 811
 812 Example nginx configuration can be found in 'python.d/nginx.conf'
 813
 814 It produces following charts:
 815
 816 1. **Active Connections**
 817  * active
 818
 819 2. **Requests** in requests/s
 820  * requests
 821
 822 3. **Active Connections by Status**
 823  * reading
 824  * writing
 825  * waiting
 826
 827 4. **Connections Rate** in connections/s
 828  * accepts
 829  * handled
 830
 831 ### configuration
 832
 833 Needs only `url` to server's `stub_status`
 834
 835 Here is an example for local server:
 836
 837 ```yaml
 838 update_every : 10
 839 priority     : 90100
 840
 841 local:
 842   url     : 'http://localhost/stub_status'
 843   retries : 10
 844 ```
 845
 846 Without configuration, module attempts to connect to `http://localhost/stub_status`
 847
 848 ---
 849
 850 # nginx_log
 851
 852 Module monitors nginx access log and produces only one chart:
 853
 854 1. **nginx status codes** in requests/s
 855  * 2xx
 856  * 3xx
 857  * 4xx
 858  * 5xx
 859
 860 ### configuration
 861
 862 Sample for two vhosts:
 863
 864 ```yaml
 865 site_A:
 866   path: '/var/log/nginx/access-A.log'
 867
 868 site_B:
 869   name: 'local'
 870   path: '/var/log/nginx/access-B.log'
 871 ```
 872
 873 When no configuration file is found, module tries to parse `/var/log/nginx/access.log` file.
 874
 875 ---
 876
 877 # ovpn_status_log
 878
 879 Module monitor openvpn-status log file.
 880
 881 **Requirements:**
 882
 883  * If you are running multiple OpenVPN instances out of the same directory, MAKE SURE TO EDIT DIRECTIVES which create output files
 884  so that multiple instances do not overwrite each other's output files.
 885
 886  * Make sure NETDATA USER CAN READ openvpn-status.log
 887
 888  * Update_every interval MUST MATCH interval on which OpenVPN writes operational status to log file.
 889
 890 It produces:
 891
 892 1. **Users** OpenVPN active users
 893  * users
 894
 895 2. **Traffic** OpenVPN overall bandwidth usage in kilobit/s
 896  * in
 897  * out
 898
 899 ### configuration
 900
 901 Sample:
 902
 903 ```yaml
 904 default
 905  log_path     : '/var/log/openvpn-status.log'
 906 ```
 907
 908 ---
 909
 910 # phpfpm
 911
 912 This module will monitor one or more php-fpm instances depending on configuration.
 913
 914 **Requirements:**
 915  * php-fpm with enabled `status` page
 916  * access to `status` page via web server
 917
 918 It produces following charts:
 919
 920 1. **Active Connections**
 921  * active
 922  * maxActive
 923  * idle
 924
 925 2. **Requests** in requests/s
 926  * requests
 927
 928 3. **Performance**
 929  * reached
 930  * slow
 931
 932 ### configuration
 933
 934 Needs only `url` to server's `status`
 935
 936 Here is an example for local instance:
 937
 938 ```yaml
 939 update_every : 3
 940 priority     : 90100
 941
 942 local:
 943   url     : 'http://localhost/status'
 944   retries : 10
 945 ```
 946
 947 Without configuration, module attempts to connect to `http://localhost/status`
 948
 949 ---
 950
 951 # postfix
 952
 953 Simple module executing `postfix -p` to grab postfix queue.
 954
 955 It produces only two charts:
 956
 957 1. **Postfix Queue Emails**
 958  * emails
 959
 960 2. **Postfix Queue Emails Size** in KB
 961  * size
 962
 963 Configuration is not needed.
 964
 965 ---
 966
 967 # redis
 968
 969 Get INFO data from redis instance.
 970
 971 Following charts are drawn:
 972
 973 1. **Operations** per second
 974  * operations
 975
 976 2. **Hit rate** in percent
 977  * rate
 978
 979 3. **Memory utilization** in kilobytes
 980  * total
 981  * lua
 982
 983 4. **Database keys**
 984  * lines are creates dynamically based on how many databases are there
 985
 986 5. **Clients**
 987  * connected
 988  * blocked
 989
 990 6. **Slaves**
 991  * connected
 992
 993 ### configuration
 994
 995 ```yaml
 996 socket:
 997   name     : 'local'
 998   socket   : '/var/lib/redis/redis.sock'
 999
1000 localhost:
1001   name     : 'local'
1002   host     : 'localhost'
1003   port     : 6379
1004 ```
1005
1006 When no configuration file is found, module tries to connect to TCP/IP socket: `localhost:6379`.
1007
1008 ---
1009
1010 # sensors
1011
1012 System sensors information.
1013
1014 Charts are created dynamically.
1015
1016 ### configuration
1017
1018 For detailed configuration information please read [`sensors.conf`](https://github.com/firehol/netdata/blob/master/conf.d/python.d/sensors.conf) file.
1019
1020 ---
1021
1022 # squid
1023
1024 This module will monitor one or more squid instances depending on configuration.
1025
1026 It produces following charts:
1027
1028 1. **Client Bandwidth** in kilobits/s
1029  * in
1030  * out
1031  * hits
1032
1033 2. **Client Requests** in requests/s
1034  * requests
1035  * hits
1036  * errors
1037
1038 3. **Server Bandwidth** in kilobits/s
1039  * in
1040  * out
1041
1042 4. **Server Requests** in requests/s
1043  * requests
1044  * errors
1045
1046 ### configuration
1047
1048 ```yaml
1049 priority     : 50000
1050
1051 local:
1052   request : 'cache_object://localhost:3128/counters'
1053   host    : 'localhost'
1054   port    : 3128
1055 ```
1056
1057 Without any configuration module will try to autodetect where squid presents its `counters` data
1058
1059 ---
1060
1061 # tomcat
1062
1063 Present tomcat containers memory utilization.
1064
1065 Charts:
1066
1067 1. **Requests** per second
1068  * accesses
1069
1070 2. **Volume** in KB/s
1071  * volume
1072
1073 3. **Threads**
1074  * current
1075  * busy
1076
1077 4. **JVM Free Memory** in MB
1078  * jvm
1079
1080 ### configuration
1081
1082 ```yaml
1083 localhost:
1084   name : 'local'
1085   url  : 'http://127.0.0.1:8080/manager/status?XML=true'
1086   user : 'tomcat_username'
1087   pass : 'secret_tomcat_password'
1088 ```
1089
1090 Without configuration, module attempts to connect to `http://localhost:8080/manager/status?XML=true`, without any credentials.
1091 So it will probably fail.
1092
1093 ---
1094
1095 # varnish cache
1096
1097 Module uses the `varnishstat` command to provide varnish cache statistics.
1098
1099 It produces:
1100
1101 1. **Client metrics**
1102  * session accepted
1103  * session dropped
1104  * good client requests received
1105
1106 2. **All history hit rate ratio**
1107  * cache hits in percent
1108  * cache miss in percent
1109  * cache hits for pass percent
1110
1111 3. **Curent poll hit rate ratio**
1112  * cache hits in percent
1113  * cache miss in percent
1114  * cache hits for pass percent
1115
1116 4. **Thread-related metrics** (only for varnish version 4+)
1117  * total number of threads
1118  * threads created
1119  * threads creation failed
1120  * threads hit max
1121  * length os session queue
1122  * sessions queued for thread
1123
1124 5. **Backend health**
1125  * backend conn. success
1126  * backend conn. not attempted
1127  * backend conn. too many
1128  * backend conn. failures
1129  * backend conn. reuses
1130  * backend conn. recycles
1131  * backend conn. retry
1132  * backend requests made
1133
1134 6. **Memory usage**
1135  * memory available in megabytes
1136  * memory allocated in megabytes
1137
1138 7. **Problems summary**
1139  * session dropped
1140  * session accept failures
1141  * session pipe overflow
1142  * backend conn. not attempted
1143  * fetch failed (all causes)
1144  * backend conn. too many
1145  * threads hit max
1146  * threads destroyed
1147  * length of session queue
1148  * HTTP header overflows
1149  * ESI parse errors
1150  * ESI parse warnings
1151
1152 8. **Uptime**
1153  * varnish instance uptime in seconds
1154
1155 ### configuration
1156
1157 No configuration is needed.
1158
1159 ---