Skip to content

smart plugin
Plugin name smart
Type read
Callbacks config, read
Status supported
Since 5.5
Copyright 2014 Vincent Bernat
License MIT License
Configuration collectd.conf(5)

The SMART plugin reads Self-Monitoring, Analysis and Reporting Technology (SMART) information from hard disk drives.

Synopsis

 <Plugin "smart">
   Disk "sda"
   IgnoreSelected false
 </Plugin>

Example graph

Example graphs from Graphite with Grafana 5.1.x

Smart.status.example.1.png Smart.status.example.2.png Smart.status.example.3.png Smart.status.example.4.png

Dependencies

  • libatasmart
  • libudev

Configuration

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

The smart plugin collects SMART information from physical disks. Values collectd include temperature, power cycle count, poweron time and bad sectors. Also, all SMART attributes are collected along with the normalized current value, the worst value, the threshold and a human readable value. The plugin can also collect SMART attributes for NVMe disks (present in accordance with NVMe 1.4 spec) and Additional SMART Attributes from Intel® NVMe disks.

Using the following two options you can ignore some disks or configure the collection only of specific disks.

Disk Name

Select the disk Name. Whether it is collected or ignored depends on the IgnoreSelected setting, see below. As with other plugins that use the daemon's ignorelist functionality, a string that starts and ends with a slash is interpreted as a regular expression. Examples:

Disk "sdd"
Disk "/hda[34]/"
Disk "nvme0n1"

See /"IGNORELISTS" for details.

IgnoreSelected true|false
Sets whether selected disks, i. e. the ones matches by any of the Disk statements, are ignored or if all other disks are ignored. The behavior (hopefully) is intuitive: If no Disk option is configured, all disks are collected. If at least one Disk option is given and no IgnoreSelected or set to false, only matching disks will be collected. If IgnoreSelected is set to true, all disks are collected except the ones matched.
IgnoreSleepMode true|false
Normally, the smart plugin will ignore disks that are reported to be asleep. This option disables the sleep mode check and allows the plugin to collect data from these disks anyway. This is useful in cases where libatasmart mistakenly reports disks as asleep because it has not been updated to incorporate support for newer idle states in the ATA spec.
UseSerial true|false
A disk's kernel name (e.g., sda) can change from one boot to the next. If this option is enabled, the smart plugin will use the disk's serial number (e.g., HGST_HUH728080ALE600_2EJ8VH8X) instead of the kernel name as the key for storing data. This ensures that the data for a given disk will be kept together even if the kernel name changes.