DiskIO

DiskIO#

The diskio plugin gathers metrics about disk IO by device.

Configuration:

# Read metrics about disk IO by device
[[inputs.diskio]]
## Essential component for nJAMS Server. Do not modify!
tags = {type="server"}

## By default, nJAMS Agent will gather stats for all devices including
## disk partitions.
## Setting devices will restrict the stats to the specified devices.
## NOTE: Globbing expressions (e.g. asterix) are not supported for
##       disk synonyms like '/dev/disk/by-id'.
# devices = ["sda", "sdb", "vd*", "/dev/disk/by-id/nvme-eui.00123deadc0de123"]
## Uncomment the following line if you need disk serial numbers.
# skip_serial_number = false
#
## On systems which support it, device metadata can be added in the form of
## tags.
## Currently only Linux is supported via udev properties. You can view
## available properties for a device by running:
## 'udevadm info -q property -n /dev/sda'
## Note: Most, but not all, udev properties can be accessed this way. Properties
## that are currently inaccessible include DEVTYPE, DEVNAME, and DEVPATH.
# device_tags = ["ID_FS_TYPE", "ID_FS_USAGE"]
#
## Using the same metadata source as device_tags, you can also customize the
## name of the device via templates.
## The 'name_templates' parameter is a list of templates to try and apply to
## the device. The template may contain variables in the form of '$PROPERTY' or
## '${PROPERTY}'. The first template which does not contain any variables not
## present for the device is used as the device name tag.
## The typical use case is for LVM volumes, to get the VG/LV name instead of
## the near-meaningless DM-0 name.
# name_templates = ["$ID_FS_LABEL","$DM_VG_NAME/$DM_LV_NAME"]
Example Output:

{
    "fields": {
        "io_time": 4232,
        "iops_in_progress": 0,
        "merged_reads": 0,
        "merged_writes": 0,
        "read_bytes": 9486336,
        "read_time": 724,
        "reads": 3124,
        "weighted_io_time": 724,
        "write_bytes": 0,
        "write_time": 0,
        "writes": 0
    },
    "name": "diskio",
    "tags": {
        "host": "vslems01",
        "id": "vslems01",
        "name": "loop6",
        "type": "server"
    },
    "timestamp": 1711456050
}