ubuntu/telegraf
Telegraf collects, processes, aggregates & writes metrics. Long-term tracks maintained by Canonical.
10K+
Deprecation Notice
This Docker image is deprecated, and will not receive further updates. v1.21 will be the final version published.
Current Telegraf™ software Docker Image from Canonical, based on Ubuntu. Receives security updates and tracks the newest combination of Telegraf™ software and Ubuntu. This repository is free to use and exempted from per-user rate limits.
Telegraf is an agent for collecting, processing, aggregating, and writing metrics. Design goals are to have a minimal memory footprint with a plugin system so that developers in the community can easily add support for collecting metrics. Read more on the Telegraf website.
Up to 5 years free security maintenance on LTS channels.
Up to 10 years customer security maintenance
from canonical/telegraf
. Request access.
Tags in italics are not available in ubuntu/telegraf but are shown here for completeness.
Channel Tag | Currently | Architectures | ||
---|---|---|---|---|
1.21-22.04_beta | Telegraf™ software 1.21 on Ubuntu 22.04 LTS | amd64 , arm64 , ppc64el , s390x | ||
track_risk |
Channel Tag shows the most stable channel for that track. A track is a combination of both the application version and the underlying Ubuntu series, eg 1.0-22.04
.
Channels are ordered from the most stable to the least stable
, candidate
, beta
, edge
.
More risky channels are always implicitly available.
So if beta
is listed, you can also pull edge
. If candidate
is listed, you can pull beta
and edge
.
When stable
is listed, all four are available.
Images are guaranteed to progress through the sequence edge
, beta
, candidate
before stable
.
If your usage includes commercial redistribution or requires unavailable channels/versions, please get in touch with the Canonical team (or using rocks@canonical.com).
Launch this image locally:
docker run -d --name telegraf-container -e TZ=UTC -p 30273:9273 ubuntu/telegraf:1.21-22.04_beta
Access your Telegraf server at localhost:30273
.
Parameters
Parameter | Description |
---|---|
-e TZ=UTC | Timezone. |
-p 30273:9273 | Expose Telegraf on localhost:30273 . |
-v /path/to/telegraf.conf:/etc/telegraf/telegraf.conf | Local configuration filetelegraf.conf (try this example). |
Testing/Debugging
To debug the container:
docker logs -f telegraf-container
To get an interactive shell:
docker exec -it telegraf-container /bin/bash
Works with any Kubernetes; if you don't have one, we recommend you install MicroK8s and microk8s.enable dns storage
then snap alias microk8s.kubectl kubectl
.
Download
telegraf.conf and
telegraf-deployment.yml and set containers.telegraf.image
in telegraf-deployment.yml
to your chosen channel tag (e.g. ubuntu/telegraf:1.21-22.04_beta
), then:
kubectl create configmap telegraf-config --from-file=main-config=telegraf.conf
kubectl apply -f telegraf-deployment.yml
You will now be able to connect to the Telegraf server on localhost:30073
.
If you find a bug in our image or want to request a specific feature, please file a bug here:
https://bugs.launchpad.net/ubuntu-docker-images/+filebug
Please title the bug "telegraf: <issue summary>
". Make sure to include the digest of the image you are using, from:
docker images --no-trunc --quiet ubuntu/telegraf:<tag>
These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out if you can't upgrade.
Track | Version | EOL | Upgrade Path |
---|---|---|---|
Telegraf™ software 1.19.2 on Ubuntu 21.10 | 07/2022 | 1.21-22.04_beta | |
Telegraf™ software 1.17.2 on Ubuntu 21.04 | 01/2022 | ||
Telegraf™ software 1.15.2 on Ubuntu 20.04 LTS | 01/2021 | ||
track |
docker pull ubuntu/telegraf