# Telegraf

Telegraf is a standalone, statically compiled agent for collecting, processing, aggregating, and writing system metrics, logs, and arbitrary data to an InfluxDB server. It is open source and self-hosted, installable on Unraid, Docker Hub, Proxmox and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/4022/telegraf

## Description

Telegraf is a standalone, statically compiled agent for collecting, processing, aggregating, and writing system metrics, logs, and arbitrary data to an InfluxDB server. It ships over 300 plugins covering system monitoring, cloud services, and message passing, making it a lightweight choice for homelab operators who want comprehensive telemetry without heavy dependencies. Configuration is managed through a single TOML file, and the agent runs efficiently as a container alongside an InfluxDB and Grafana stack.

## Platform availability

Available on 3 of 10 platforms: Unraid, Proxmox, Helm.

## Health score

83/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 5 days ago)
- Popular: 85 (17,908 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 82 (no serious findings, 3 minor, CI, tests, OpenSSF Scorecard 8.2/10)

## Links

- Unraid: https://ca.unraid.net/apps/telegraf-199s8dw06qhm00?q=telegraf
- Docker Hub: https://hub.docker.com/r/bitnami/telegraf
- Official website: https://influxdata.com/telegraf
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=telegraf
- Kubernetes (Helm): https://artifacthub.io/packages/helm/influxdata/telegraf
- Documentation: https://docs.influxdata.com/telegraf

## Common questions

### Where should Telegraf run when monitoring multiple self-hosted VMs?

It needs to run on each VM or host that you want to monitor.

### How can I validate a Telegraf configuration before relying on it?

Run Telegraf with the -test flag to validate the configuration.

### What should I check if Telegraf is not sending metrics to a proxy?

Check DNS resolution, the hostname or IP configured for the proxy, and whether firewalls are blocking communication.

### How does Telegraf decide when to collect and send data?

It collects from inputs at each configured interval and sends to outputs at each flush interval.

## Alternatives

- Fluentd: Fluentd is an open-source log collector that gathers events from various data sources and writes them to files, RDBMS, NoSQL, IaaS, SaaS, H…
- Logstash: Logstash is a server-side data processing pipeline that ingests data from many sources, transforms it, and forwards it to a destination suc…
- fluent-bit: Fluent Bit is an open source and multi-platform Log Forwarder which allows you to collect data/logs from different sources, unify and send…

---
Source: Our Local Host (https://ourlocalhost.com/app/4022/telegraf), the self-hosted and open-source app directory.
