ubuntu/grafana-agent

Verified Publisher

By Canonical

Updated 7 days ago

Ubuntu ROCK for Grafana Agent, an open-source telemetry collector for logs, metrics, and traces.

Image
Monitoring & Observability

6.2K

grafana-agent | Ubuntu

Current grafana-agent Docker Image from Canonical, based on Ubuntu. Receives security updates and rolls to newer grafana-agent or Ubuntu release. This repository is free to use and exempted from per-user rate limits.

About grafana-agent

Grafana Agent is a batteries-included, open source telemetry collector for collecting logs, metrics, and traces. It uses established battle-tested code to be fully compatible with Prometheus, Loki and Tmepo telemetry stack. Grafana Agent can forward metrics to any Prometheus-compatible endpoint, logs to any Loki-compatible endpoint, and traces to any OpenTelemetry-compatible endpoint. Read more on the official website.

Tags and Architectures

LTS Up to 5 years of free security maintenance on LTS channels.

ESM Up to 10 years of customer security maintenance from Canonical's restricted repositories.

Channel TagsSupported untilCurrentlyArchitectures
0.44.2-24.04_stable0-24.04, 0-24.04_beta, 0-24.04_candidate, 0-24.04_edge, 0-24.04_stable, 0.44-24.04, 0.44-24.04_beta, 0.44-24.04_candidate, 0.44-24.04_edge, 0.44-24.04_stable, 0.44.2-24.04, 0.44.2-24.04_beta, 0.44.2-24.04_candidate, 0.44.2-24.04_edge05/2025grafana-agent 0.44.2 on Ubuntu 24.04 LTSamd64, arm64
0.40.3-22.04_stable0.40.3-22.04, 0.40.3-22.04_beta, 0.40.3-22.04_candidate, 0.40.3-22.04_edge05/2025grafana-agent 0.40.3 on Ubuntu 22.04 LTSamd64, arm64
0.40.5-22.04_stable0-22.04, 0-22.04_beta, 0-22.04_candidate, 0-22.04_edge, 0-22.04_stable, 0.40-22.04, 0.40-22.04_beta, 0.40-22.04_candidate, 0.40-22.04_edge, 0.40-22.04_stable, 0.40.5-22.04, 0.40.5-22.04_beta, 0.40.5-22.04_candidate, 0.40.5-22.04_edge05/2025grafana-agent 0.40.5 on Ubuntu 22.04 LTSamd64, arm64
0.39.2-22.04_stable0.39-22.04, 0.39-22.04_beta, 0.39-22.04_candidate, 0.39-22.04_edge, 0.39-22.04_stable, 0.39.2-22.04, 0.39.2-22.04_beta, 0.39.2-22.04_candidate, 0.39.2-22.04_edge03/2025grafana-agent 0.39.2 on Ubuntu 22.04 LTSamd64, arm64
0.40.2-22.04_stable0.40.2-22.04, 0.40.2-22.04_beta, 0.40.2-22.04_candidate, 0.40.2-22.04_edge03/2025grafana-agent 0.40.2 on Ubuntu 22.04 LTSamd64, arm64
0.38.0-22.04_stable0.38.0-22.04, 0.38.0-22.04_beta, 0.38.0-22.04_candidate, 0.38.0-22.04_edge03/2025grafana-agent 0.38.0 on Ubuntu 22.04 LTSamd64, arm64
0.39.1-22.04_stable0.39.1-22.04, 0.39.1-22.04_beta, 0.39.1-22.04_candidate, 0.39.1-22.04_edge03/2025grafana-agent 0.39.1 on Ubuntu 22.04 LTSamd64, arm64
0.39.0-22.04_stable0.39.0-22.04, 0.39.0-22.04_beta, 0.39.0-22.04_candidate, 0.39.0-22.04_edge03/2025grafana-agent 0.39.0 on Ubuntu 22.04 LTSamd64, arm64
0.37.4-22.04_stable0.37-22.04, 0.37-22.04_beta, 0.37-22.04_candidate, 0.37-22.04_edge, 0.37-22.04_stable, 0.37.4-22.04, 0.37.4-22.04_beta, 0.37.4-22.04_candidate, 0.37.4-22.04_edge03/2025grafana-agent 0.37.4 on Ubuntu 22.04 LTSamd64, arm64
0.40.4-22.04_stable0.40.4-22.04, 0.40.4-22.04_beta, 0.40.4-22.04_candidate, 0.40.4-22.04_edge05/2025grafana-agent 0.40.4 on Ubuntu 22.04 LTSamd64, arm64
0.35.4-22.04_stable0.35-22.04, 0.35-22.04_beta, 0.35-22.04_candidate, 0.35-22.04_edge, 0.35-22.04_stable, 0.35.4-22.04, 0.35.4-22.04_beta, 0.35.4-22.04_candidate, 0.35.4-22.04_edge03/2025grafana-agent 0.35.4 on Ubuntu 22.04 LTSamd64, arm64
0.38.1-22.04_stable0.38-22.04, 0.38-22.04_beta, 0.38-22.04_candidate, 0.38-22.04_edge, 0.38-22.04_stable, 0.38.1-22.04, 0.38.1-22.04_beta, 0.38.1-22.04_candidate, 0.38.1-22.04_edge03/2025grafana-agent 0.38.1 on Ubuntu 22.04 LTSamd64, arm64
track_risk

Channel Tags shows the most stable channel for that track ordered 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.

Commercial use and Extended Security Maintenance channels

If your usage includes commercial redistribution, or requires ESM or unavailable channels/versions, please get in touch with the Canonical team (or using rocks@canonical.com).

Usage

Launch this image locally:

docker run -d --name grafana-agent-container -e TZ=UTC -p 12345:12345 ubuntu/grafana-agent:0.44.2-24.04_stable

Access your Grafana Agent instance at http://localhost:12345.

Parameters

ParameterDescription
-e TZ=UTCTimezone.
-p 12345:12345Expose Grafana Agent on localhost:12345.
-v /path/to/agent/config.yaml:/etc/agent/agent.yamlLocal configuration file agent.yml.

Testing/Debugging

To debug the container:

docker logs -f grafana-agent-container

To get an interactive shell:

docker exec -it grafana-agent-container /bin/bash
Debugging

To debug the container:

docker logs -f grafana-agent-container

To get an interactive shell:

docker exec -it grafana-agent-container /bin/bash

Bugs and feature requests

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 "grafana-agent: <issue summary>". Make sure to include the digest of the image you are using, from:

docker images --no-trunc --quiet ubuntu/grafana-agent:<tag>

Deprecated channels & tags

These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out if you can't upgrade.

TrackVersionEOLUpgrade Path
track

Docker Pull Command

docker pull ubuntu/grafana-agent