Excelero NVMesh telegraf statistics collector plugin

Introduction

The Excelero NVMesh telegraf statistics collector plugin is integrated through and configured in the Telegraf statistics collector inputs.exec interface.

The current and initial version collects the following volume/device statistics from the NVMesh client Volumes:

num_ops

The number of IO requests from the kernel to the NVMesh volume

size in_bytes

Total size of all the ios in bytes. Size/num_ops will give you the average size of the io.

io_latency

Reflects the typical time it takes under good conditions in micro seconds to sucessfully excecute the IO and return ack to the kernel

io_execution

Reflects the actual time it takes in micro seconds to execute the IO which may be higher tha the latency number due to SSD and/or network issues

io_e2e

End to end time it takes in micro seconds on from the kernel sending the IO request back to the ack back to the kernel considering all factors they may imact the execution time like throttleing, IO retries, path failure, etc.

io_latency^2

io_latency ^2, used to calculate variance

worst_latency

Highest/max latency

worst_execution

Highest/max execution time

worst_e2e

Highest/max end to end time

Installation

Move or copy the nvmesh_telegraf.py file to the /etc/opt/NVMesh/ folder on your NVMesh client server/host. Enable the execution bit on the script by using chmod +x to set the execution permission.

Telegraf configuration

If the Telegraf collector was not installed on your cleint server/host yet, please follow the download and install instruction they can be found here: https://portal.influxdata.com/downloads

Edit the /etc/telegraf/telegraf.conf and make sure that the following is enabled/uncommented in the [[inputs.exec]] section:

#Read metrics from one or more commands that can output to stdout
[[inputs.exec]]
#Commands array
commands = ["/etc/opt/NVMesh/nvmesh_telegraf.py"]
#Timeout for each command to complete.
timeout = "5s"
#measurement name suffix (for separating different commands)
#name_suffix = "_measurement"
#Data format to consume.
#Each data format has its own unique set of configuration options, read
#more about them here:
#https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md
data_format = "influx"

Restart the telegraf service. Done.

Here you can find documentation and How To install and configure the whole Telegraf, Influxdb and Grafana stack on CentOS 7 as a comprehensive example and to get you started

https://github.com/Excelero/telegraf-plugin/blob/master/Telegraf%2C%20InfluxDB%20%26%20Grafana%20Installation%2C%20Setup%20and%20Configuration%20to%20monitor%20NVMesh%20clients%20and%20targets%20on%20CentOS%207.pdf