Back to Telegraf

HDDtemp Input Plugin

plugins/inputs/hddtemp/README.md

1.38.32.0 KB
Original Source

HDDtemp Input Plugin

This plugin reads data from a hddtemp daemon.

[!IMPORTANT] This plugin requires hddtemp to be installed and running as a daemon.

As the upstream project is not activly maintained anymore and various distributions (e.g. Debian Bookwork and later) don't ship packages for hddtemp anymore, the binary might not be available (e.g. in Ubuntu 22.04 or later).

[!TIP] As an alternative consider using the smartctl relying on SMART information or sensors plugins to retrieve temperature data of your hard-drive.

⭐ Telegraf v1.0.0 🏷️ hardware, system 💻 all

Global configuration options <!-- @/docs/includes/plugin_config.md -->

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See CONFIGURATION.md for more details.

Configuration

toml
# Monitor disks' temperatures using hddtemp
[[inputs.hddtemp]]
  ## By default, telegraf gathers temps data from all disks detected by the
  ## hddtemp.
  ##
  ## Only collect temps from the selected disks.
  ##
  ## A * as the device name will return the temperature values of all disks.
  ##
  # address = "127.0.0.1:7634"
  # devices = ["sda", "*"]

Metrics

  • hddtemp
    • tags:
      • device
      • model
      • unit
      • status
      • source
    • fields:
      • temperature

Example Output

text
hddtemp,source=server1,unit=C,status=,device=sdb,model=WDC\ WD740GD-00FLA1 temperature=43i 1481655647000000000
hddtemp,device=sdc,model=SAMSUNG\ HD103UI,unit=C,source=server1,status= temperature=38i 148165564700000000
hddtemp,device=sdd,model=SAMSUNG\ HD103UI,unit=C,source=server1,status= temperature=36i 1481655647000000000