---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from HDDtemp
url: https://docs.influxdata.com/telegraf/v1/input-plugins/hddtemp/
estimated_tokens: 975
product: Telegraf
version: v1
---

-   Telegraf v1.0.0+

# HDDtemp Input Plugin

This plugin reads data from a [hddtemp](https://savannah.nongnu.org/projects/hddtemp/) daemon.

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).

As an alternative consider using the [smartctl](/telegraf/v1/plugins/#input-smartctl) relying on SMART information or [sensors](/telegraf/v1/plugins/#input-sensors) plugins to retrieve temperature data of your hard-drive.

**Introduced in:** Telegraf v1.0.0 **Tags:** hardware, system **OS support:** all

## Global configuration options

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](/telegraf/v1/configuration/#plugins) 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
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [HDDtemp Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/hddtemp/README.md)