telegraf/plugins/inputs/hddtemp
Paweł Żak 6f80899e13
chore: Fix linter findings for `revive:unused-receiver` in `plugins/inputs/[f-k]` (#16308)
2024-12-17 15:33:30 +01:00
..
go-hddtemp chore: Fix linter findings for `revive:unused-receiver` in `plugins/inputs/[f-k]` (#16308) 2024-12-17 15:33:30 +01:00
README.md docs(inputs.hddtemp): Document hddtemp removal and alternatives (#15658) 2024-07-24 12:22:32 -05:00
hddtemp.go chore: Fix linter findings for `revive:exported` in `plugins/inputs/h*` (#16050) 2024-10-23 15:09:07 +02:00
hddtemp_test.go chore: Fix linter findings for `revive:unused-receiver` in `plugins/inputs/[f-k]` (#16308) 2024-12-17 15:33:30 +01:00
sample.conf chore(inputs_a-l): migrate sample configs into separate files (#11132) 2022-05-18 11:31:52 -05:00

README.md

HDDtemp Input Plugin

This plugin reads data from hddtemp daemon.

Hddtemp should be installed and its daemon running.

OS Support & Alternatives

This plugin depends on the availability of the hddtemp binary. The upstream project is not active and Debian made the decision to remove it in Debian Bookworm. This means the rest of the Debian ecosystem no longer has this binary in later releases, like Ubuntu 22.04.

As an alternative consider using the smartctl plugin. This parses the full JSON output from smartctl, which includes temperature data, in addition to much more data about devices in a system.

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# 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

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