The system check is shipped with the agent by default and requires no configuration. This article will provide additional information about the system check.
Configuring the agent to monitor system metrics
The agent will collect system metrics by default, without any extra configuration required.
Verifying the configuration
Execute info to verify the configuration with the following:
sudo /etc/init.d/sd-agent info
or
/usr/share/python/sd-agent/agent.py info
If the agent has been configured correctly you'll see an output such as:
===================
Collector (v 2.2.4)
===================
Status date: 2019-02-21 12:24:08 (58s ago)
Pid: 16928
Platform: Linux-3.10.0-862.14.4.el7.x86_64-x86_64-with-centos-7.6.1810-Core
Python Version: 2.7.5, 64bit
Logs: <stderr>, /var/log/sd-agent/collector.log, syslog:/dev/log
Clocks
======
NTP offset: -0.0005 s
System UTC time: 2019-02-21 12:25:07.160607
Paths
=====
conf.d: /etc/sd-agent/conf.d
checks.d: /usr/share/python/sd-agent/checks.d
Hostnames
=========
socket-hostname: sd-agent-v2
hostname: sd-agent-v2
socket-fqdn: sd-agent-v2
You can also view the metrics returned with the following command:
sudo -u sd-agent /usr/share/python/sd-agent/agent.py check system
Configuring graphs
Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the system metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.
Monitored metrics
| Metric | Values |
|---|---|
| system.disk.in_use_pct Percent of disk space in in use. |
percent / Type: int |
| system.io.KBt | kibibyte / second Type: float |
| system.io.MBs | mebibyte / second Type: float |
| system.io.avgqu-sz Size of i/o requests queue, on average. |
request / Type: float |
| system.io.avgrq-sz Size of average i/o request. |
sector / Type: float |
| system.io.await How long, on average, read and write requests take to be served. Includes time waiting and the time spent being served. |
millisecond / millisecond Type: float |
| system.io.bytes_per_s Byte transfer rate per second. |
byte / second Type: float |
| system.io.r_await How long, on average, read requests take to be served. Includes time waiting and the time spent being served. |
millisecond / millisecond Type: float |
| system.io.r_s How many read requests to device each second. |
request / second Type: float |
| system.io.rkB_s How many kibibytes are read from the device each second. |
kibibyte / second Type: float |
| system.io.rrqm_s Read requests merged each second. |
request / millisecond Type: float |
| system.io.rsec_s | sector / Type: float |
| system.io.rwratio | percent / Type: float |
| system.io.svctm Time, on average, for I/O requests issued to the device to be serviced. |
millisecond / millisecond Type: float |
| system.io.tps | transaction / second Type: int |
| system.io.util Percentage of CPU time where the device received I/O requests. |
percent / Type: float |
| system.io.w_await How long, on average, write requests take to be served. Includes time waiting and the time spent being served. |
millisecond / millisecond Type: float |
| system.io.w_s How many write requests to device each second. |
request / second Type: float |
| system.io.wkB_s Kibibytes written to device per second. |
kibibyte / second Type: float |
| system.io.wrqm_s Write requests merged each second. |
request / second Type: float |
| system.io.wsec_s | sector / Type: float |
| system.load.1 Average system load per minute. |
/ Type: float |
| system.load.15 Average system load per 15 minutes. |
/ Type: float |
| system.load.5 Average system load per 5 minutes. |
/ Type: float |
| system.mem.buffered RAM used for file buffers. |
mebibyte / Type: float |
| system.mem.cached RAM used as cache memory. |
mebibyte / Type: float |
| system.mem.free RAM not currently in use. |
mebibyte / Type: float |
| system.mem.pct_usable Percent of Ram that is usable. |
percent / Type: float |
| system.mem.shared Total RAM used as shared memory. |
mebibyte / Type: float |
| system.mem.total Total RAM in the system |
mebibyte / Type: float |
| system.mem.usable Available RAM (from /proc/meminfo) |
mebibyte / Type: float |
| system.mem.used Total RAM in use. |
mebibyte / Type: float |
| system.net.tcp.backlog_drops The number of packets dropped because there wasn't room in the TCP backlog. Available since Agent v5.14.0. |
packet / None Type: float |
| system.net.tcp.listen_drops The number of times connections have dropped out of listen. Available since Agent v5.14.0. |
None / None Type: float |
| system.net.tcp.listen_overflows The number of times connections have overflowed the accept buffer. Available since Agent v5.14.0. |
None / None Type: float |
| system.net.tcp.rcv_packs The number of TCP packets received. |
packet / second Type: float |
| system.net.tcp.retrans_packs The number of TCP packets retransmitted. |
packet / second Type: float |
| system.net.tcp.sent_packs The number of TCP packets transmitted. |
packet / second Type: float |
| system.swap.free Total free swap memory. |
mebibyte / Type: float |
| system.swap.pct_free Percentage of swap memory that's free. |
percent / Type: float |
| system.swap.total Total swap memory in the system. |
mebibyte / Type: float |
| system.swap.used Total swap memory in use. |
mebibyte / Type: float |
Comments