ubuntu/grafana-agent

Verified Publisher

By Canonical

Updated 5 months ago

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

Image
Monitoring & observability
0

10K+

ubuntu/grafana-agent repository overview

ubuntu/grafana-agent is a rock for grafana-agent maintained by Canonical.

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.

[Learn more about grafana-agent]

Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels.

TagsSupported untilVersionBaseArchitectures
View deprecated tags
TagsSupport ended onUpgrade Path
0.44-24.04_stable
aliases0-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
03/2026 -
0.44.2-24.04_stable
aliases0.44.2-24.04, 0.44.2-24.04_beta, 0.44.2-24.04_candidate, 0.44.2-24.04_edge
05/2025 -
0.43.4-24.04_stable
aliases0.43-24.04, 0.43-24.04_beta, 0.43-24.04_candidate, 0.43-24.04_edge, 0.43-24.04_stable, 0.43.4-24.04, 0.43.4-24.04_beta, 0.43.4-24.04_candidate, 0.43.4-24.04_edge
03/2025 -
0.40.3-22.04_stable
aliases0.40.3-22.04, 0.40.3-22.04_beta, 0.40.3-22.04_candidate, 0.40.3-22.04_edge
05/2025 -
0.40.5-22.04_stable
aliases0-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_edge
05/2025 -
0.39.2-22.04_stable
aliases0.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_edge
03/2025 -
0.40.2-22.04_stable
aliases0.40.2-22.04, 0.40.2-22.04_beta, 0.40.2-22.04_candidate, 0.40.2-22.04_edge
03/2025 -
0.38.0-22.04_stable
aliases0.38.0-22.04, 0.38.0-22.04_beta, 0.38.0-22.04_candidate, 0.38.0-22.04_edge
03/2025 -
0.39.1-22.04_stable
aliases0.39.1-22.04, 0.39.1-22.04_beta, 0.39.1-22.04_candidate, 0.39.1-22.04_edge
03/2025 -
0.39.0-22.04_stable
aliases0.39.0-22.04, 0.39.0-22.04_beta, 0.39.0-22.04_candidate, 0.39.0-22.04_edge
03/2025 -
0.37.4-22.04_stable
aliases0.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_edge
03/2025 -
0.40.4-22.04_stable
aliases0.40.4-22.04, 0.40.4-22.04_beta, 0.40.4-22.04_candidate, 0.40.4-22.04_edge
05/2025 -
0.35.4-22.04_stable
aliases0.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_edge
03/2025 -
0.38.1-22.04_stable
aliases0.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_edge
03/2025 -
0.35.2-22.04_stable
aliases0.35.2-22.04, 0.35.2-22.04_beta, 0.35.2-22.04_candidate, 0.35.2-22.04_edge
03/2025 -

Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

[Learn more about Pebble]

Inspect

To view the Pebble services and checks defined in this rock:

docker run --rm ubuntu/grafana-agent:0.44-24.04_stable plan
For an older version that is not a rock

The container spins up with the default entrypoint. To inspect the entrypoint and command:

docker inspect --format='{{.Config.Entrypoint}} {{.Config.Cmd}}' ubuntu/grafana-agent:0.44-24.04_stable
Run

To run this rock, use any of the usual container runtimes, for example, docker:

docker run --name grafana-agent-container \
    -p 12345:12345 \
    ubuntu/grafana-agent:0.44-24.04_stable

Grafana Agent starts and listens on port 12345. Access the Grafana Agent instance at http://localhost:12345.

Get logs

To view the logs of the running container, run:

docker exec grafana-agent-container pebble logs

Or, for a specific service:

docker exec grafana-agent-container pebble logs <service>
For an older version that is not a rock

To view the logs of the running container, run:

docker logs grafana-agent-container
Monitor health checks

Rocks may have predefined health checks that you can list by running:

docker exec grafana-agent-container pebble checks

The overall health of your container can be inspected via:

docker exec grafana-agent-container pebble health

Configuration

Environment variables
OptionDescriptionDefault
TZTimezone.UTC
Volumes
OptionDescriptionDefault
-v <path>:/etc/agent/agent.yamlLocal configuration file agent.yaml.None
Ports
OptionDescriptionDefault
-p <port>:12345Expose port 12345 on the host.None

[Report a bug]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with Canonical’s IP Policy.

Tag summary

Content type

Image

Digest

sha256:10ef811eb

Size

101.2 MB

Last updated

5 months ago

docker pull ubuntu/grafana-agent:0.44-24.04_stable

This week's pulls

Pulls:

269

Last week