telegraf/plugins/inputs/monit/README.md

149 lines
4.8 KiB
Markdown
Raw Normal View History

2020-01-22 22:45:18 +00:00
# Monit Plugin
The monit plugin gathers metrics and status information about local processes,
remote hosts, file, file systems, directories and network interfaces managed and watched over by Monit.
To install Monit agent on the host please refer to the link https://mmonit.com/wiki/Monit/Installation
Minimum Version of Monit tested with is 5.16
### Configuration:
```toml
# Read metrics and status information about processes managed by Monit
[[inputs.monit]]
#SampleConfig
address = "http://127.0.0.1:2812"
basic_auth_username = "test"
basic_auth_password = "test"
```
### Tags:
All measurements have the following tags:
- address
- version
- service
- paltform_name
- status
- monitoring_status
- monitoring_mode
### Measurements & Fields:
<optional description>
### Fields:
Fields for all Monit service types:
- status_code
- monitoring_status_code
- monitoring_mode_code
### Measurement & Fields:
Fields for Monit service type Filesystem:
- Measurement:
- monit_filesystem
- Fields:
- mode
- block_percent
- block_usage
- block_total
- inode_percent
- inode_usage
- inode_total
Fields for Monit service type directory:
- Measurement:
- monit_directory
- Fields:
- permissions
Fields for Monit service type file:
- Measurement:
- monit_file
- Fields:
- size
- permissions
Fields for Monit service type process:
- Measurement:
- monit_process
- Fields:
- cpu_percent
- cpu_percent_total
- mem_kb
- mem_kb_total
- mem_percent
- mem_percent_total
- pid
- parent_pid
- threads
- children
Fields for Monit service type remote host:
- Measurement:
- monit_remote_host
- Fields:
- hostname
- port_number
- request
- protocol
- type
Fields for Monit service type system:
- Measurement:
- monit_system
- Fields:
- cpu_system
- cpu_user
- cpu_wait
- cpu_load_avg_1m
- cpu_load_avg_5m
- cpu_load_avg_15m
- mem_kb
- mem_percent
- swap_kb
- swap_percent
Fields for Monit service type fifo:
- Measurement:
- monit_fifo
- Fields:
- permissions
Fields for Monit service type program:
- Measurement:
- monit_program
- Fields:
- last_started_time
- program_status
Fields for Monit service type network:
- Measurement:
- monit_network
- Fields:
- link_state
- link_mode
- link_speed
- download_packets_now
- download_packets_total
- download_bytes_now
- download_bytes_total
- download_errors_now
- download_errors_total
- upload_packets_now
- upload_packets_total
- upload_bytes_now
- upload_bytes_total
- upload_errors_now
- upload_errors_total
### Example Output:
```
$ ./telegraf -config telegraf.conf -input-filter monit -test
monit_system,address=http://localhost:2812,host=verizon-onap,hostname=verizon-onap,monitoring_mode=Monitoring\ mode:\ \ active,monitoring_status=Monitoring\ status:\ \ Monitored,platform_name=Linux,service=verizon-onap,status=Running,version=5.16 status_code=0i,cpu_system=1.9,cpu_user=4.7,cpu_wait=1.5,cpu_load_avg_1m=1.24,cpu_load_avg_5m=1.68,mem_percent=67.1,monitoring_status_code=1i,monitoring_mode_code=0i,cpu_load_avg_15m=1.64,mem_kb=10961012i,swap_kb=2322688,swap_percent=13.9 1578636430000000000
monit_remote_host,address=http://localhost:2812,host=verizon-onap,hostname=verizon-onap,monitoring_mode=Monitoring\ mode:\ \ passive,monitoring_status=Monitoring\ status:\ \ Monitored,platform_name=Linux,service=testing,status=Failure,version=5.16 status_code=32i,monitoring_status_code=1i,monitoring_mode_code=1i,remote_hostname="192.168.10.49",port_number=2220i,request="",protocol="DEFAULT",type="TCP" 1578636430000000000
monit_fifo,address=http://localhost:2812,host=verizon-onap,hostname=verizon-onap,monitoring_mode=Monitoring\ mode:\ \ active,monitoring_status=Monitoring\ status:\ \ Monitored,platform_name=Linux,service=test2,status=Running,version=5.16 status_code=0i,monitoring_status_code=1i,monitoring_mode_code=0i,permissions=664i 1578636430000000000
monit_network,address=http://localhost:2812,host=verizon-onap,hostname=verizon-onap,monitoring_mode=Monitoring\ mode:\ \ active,monitoring_status=Monitoring\ status:\ \ Monitored,platform_name=Linux,service=test1,status=Failure,version=5.16 monitoring_status_code=1i,monitoring_mode_code=0i,download_packets_total=0i,upload_bytes_now=0i,download_errors_total=0i,status_code=8388608i,link_speed=-1i,link_mode="Unknown Mode",download_bytes_now=0i,download_bytes_total=0i,download_errors_now=0i,upload_packets_total=0i,upload_bytes_total=0i,upload_errors_now=0i,upload_errors_total=0i,link_state=0i,download_packets_now=0i,upload_packets_now=0i 1578636430000000000
monit_directory,address=http://localhost:2812,host=verizon-onap,hostname=verizon-onap,monitoring_mode=Monitoring\ mode:\ \ passive,monitoring_status=Monitoring\ status:\ \ Monitored,platform_name=Linux,service=test,status=Running,version=5.16 status_code=0i,monitoring_status_code=1i,monitoring_mode_code=1i,permissions=755i 1578636430000000000
```