Built-in Metrics
Agento itself |
|
agento.GatherDuration |
Time used to gather metrics for Agento (ms) |
CPU speed |
|
Tag: core |
The cpu core |
cpu.Frequency |
The current CPU frequency (kHz) |
CPU statistics |
|
Tag: core |
The cpu core |
cpu.Guest |
Time spend on running guests (ticks/s) |
cpu.GuestNice |
Time spend on running nice guests (ticks/s) |
cpu.Idle |
Time spend idle (ticks/s) |
cpu.IoWait |
Time spend waiting for IO (ticks/s) |
cpu.Irq |
Time spend processing interrupts (ticks/s) |
cpu.Nice |
Time spend in user mode with low priority (ticks/s) |
cpu.SoftIrq |
Time spend processing soft interrupts (ticks/s) |
cpu.Steal |
Time spend waiting for the physical CPU on a guest (ticks/s) |
cpu.System |
Time spend in kernel mode (ticks/s) |
cpu.User |
Time spend in user mode (ticks/s) |
Disk Usage |
|
Tag: mountpoint |
The mount point of the volume |
du.Free |
Free space (b) |
du.Reserved |
Space reserved for uid 0 (b) |
du.Used |
Used space (b) |
du.FreeNodes |
Free inodes (n) |
du.UsedNodes |
Used inodes (n) |
Entropy |
|
misc.AvailableEntropy |
Available entropy in the kernel pool (b) |
File handle usage |
|
misc.OpenFilesFree |
The number of free file handles (n) |
misc.OpenFilesUsed |
The number of allocated file handles (n) |
IO |
|
Tag: device |
The block device |
io.IoInProgress |
The current queue size of IO operation ((n) |
io.IoTime |
Time spend on IO (ms/s) |
io.IoWeightedTime |
Time spend on IO times the IO queue. Please see https://www.kernel.org/doc/Documentation/iostats.txt (ms/s) |
io.ReadsCompleted |
Reads from device (reads/s) |
io.ReadSectors |
Sectors read (sectors/s) |
io.ReadsMerged |
Reads merged (merges/s) |
io.ReadTime |
Milliseconds spend reading (ms/s) |
io.WritesCompleted |
Writes to device (writes/s) |
io.WriteSectors |
Sectors written (sectors/) |
io.WritesMerged |
Writes merged (merges/s) |
io.WriteTime |
Time spend writing (ms/s) |
Miscellaneous |
|
misc.ActiveTasks |
Tasks running (n) |
misc.BlockedProcesses |
Number of processes currently blocke ((n) |
misc.ContextSwitches |
Number of context switches per second (/s) |
misc.Forks |
Number of forks per second (/s) |
misc.Interrupts |
Number of interrupts per second (/s) |
misc.Load1 |
System load in the last minute () |
misc.Load5 |
System load in the last 5 minutes () |
misc.Load15 |
System load in the last 15 minutes () |
misc.RunningProcesses |
Currently running processe ((n) |
misc.Tasks |
Number of tasks (n) |
Memory & Swap |
|
mem.Buffers |
Memory used for buffers (b) |
mem.Cached |
Memory used for cache (b) |
mem.Free |
Free memory (b) |
mem.Shared |
Memory shared among multiple processes (b) |
mem.Used |
Memory used (b) |
swap.Free |
Free swap (b) |
swap.Used |
Used swap (b) |
Network |
|
Tag: interface |
The network interface |
net.RxBytes |
Bytes received (b/s) |
net.RxCompressed |
Compressed frames received (frames/s) |
net.RxDropped |
Dropped packets (packets/s) |
net.RxErrors |
Receiver errors detected (errors/s) |
net.RxFifo |
FIFO buffer overruns (overruns/s) |
net.RxFrame |
Framing errors (errors/s) |
net.RxMulticast |
Multicast frames received (frames/s) |
net.RxPackets |
Packets received (packets/s) |
net.TxBytes |
Bytes transmitted (b/s) |
net.TxCarrier |
Carrier losses (losses/s) |
net.TxCollisions |
Network collisions detected (collisions/s) |
net.TxCompressed |
Compressed frames transmitted (frames/s) |
net.TxDropped |
Packets dropped (packets/s) |
net.TxErrors |
Transmission errors (errors/s) |
net.TxFifo |
FIFO buffer overruns (overruns/s) |
net.TxPackets |
Packets transmitted (packets/s) |
Socket usage |
|
sockets.Close |
Number of sockets in state CLOSE (n) |
sockets.CloseWait |
Number of sockets in state CLOSE_WAIT (n) |
sockets.Closing |
Number of sockets in state CLOSING (n) |
sockets.Established |
Number of sockets in state ESTABLISHED (n) |
sockets.FinWait1 |
Number of sockets in state FIN_WAIT1 (n) |
sockets.FinWait2 |
Number of sockets in state FIN_WAIT2 (n) |
sockets.LastAck |
Number of sockets in state LAST_ACK (n) |
sockets.Listen |
Number of sockets in state LISTEN (n) |
sockets.RootUser |
Number of sockets owned by root (n) |
sockets.SynReceived |
Number of sockets in state SYN_SENT2 (n) |
sockets.SynSent |
Number of sockets in state SYN_SENT1 (n) |
sockets.TimeWait |
Number of sockets in state TIME_WAIT (n) |
Configuration
Agento can is configured by a single configuration file: /etc/agento.conf.
Default configuration:
[client]
interval = 1
server = agento.{domain}
[server]
bind = "0.0.0.0"
port = 12345
[server.influxdb]
url = "http://localhost:8086/"
username = "root"
password = "root"
database = "agento"
retentionPolicy = "default"
InfluxDB
Agento requires InfluxDB 0.9rc31 or later. It can be installed on a Debian/Ubuntu system fairly easy.
root@influx01:~# wget http://get.influxdb.org/influxdb_0.9.0-rc31_amd64.deb
--2015-06-03 16:04:13-- http://get.influxdb.org/influxdb_0.9.0-rc31_amd64.deb
Resolving get.influxdb.org (get.influxdb.org)... 54.231.8.228
Connecting to get.influxdb.org (get.influxdb.org)|54.231.8.228|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6582776 (6.3M) [application/x-debian-package]
Saving to: ‘influxdb_0.9.0-rc31_amd64.deb’
100%[==============================================================>] 6,582,776 2.91MB/s in 2.2s
2015-06-03 16:04:16 (2.91 MB/s) - ‘influxdb_0.9.0-rc31_amd64.deb’ saved [6582776/6582776]
root@influx01:~# dpkg -i influxdb_0.9.0-rc31_amd64.deb
Selecting previously unselected package influxdb.
(Reading database ... 119950 files and directories currently installed.)
Preparing to unpack influxdb_0.9.0-rc31_amd64.deb ...
Unpacking influxdb (0.9.0-rc31) ...
Setting up influxdb (0.9.0-rc31) ...
Removing any system startup links for /etc/init.d/influxdb ...
Adding system startup for /etc/init.d/influxdb ...
/etc/rc0.d/K20influxdb -> ../init.d/influxdb
/etc/rc1.d/K20influxdb -> ../init.d/influxdb
/etc/rc6.d/K20influxdb -> ../init.d/influxdb
/etc/rc2.d/S20influxdb -> ../init.d/influxdb
/etc/rc3.d/S20influxdb -> ../init.d/influxdb
/etc/rc4.d/S20influxdb -> ../init.d/influxdb
/etc/rc5.d/S20influxdb -> ../init.d/influxdb
root@influx01:~#
InfluxDB doesn’t start by itself when just installed, you need to manually start it.
root@influx01:~# /etc/init.d/influxdb start
Starting the process influxd [ OK ]
influxd process was started [ OK ]
root@influx01:~#
As per default authentication is disabled, so you don’t have to add a user. But you do need to create the needed database.
root@influx01:~# /opt/influxdb/influx -execute "CREATE DATABASE agento"