ubuntu/metrics-proxy
A lightweight proxy designed to expose a unified metrics endpoint for multiple Kubernetes pods.
401
Current metrics-proxy Docker Image from Canonical, based on Ubuntu. Receives security updates and rolls to newer metrics-proxy or Ubuntu release. This repository is free to use and exempted from per-user rate limits.
Metrics Proxy is a lightweight proxy designed to expose a unified metrics endpoint for multiple Kubernetes pods. The proxy watches for pods in a Kubernetes cluster and listens on a configurable port, where it exposes aggregated metrics on a configurable endpoint. Read more on the project repo.
Up to 5 years of free security maintenance on LTS channels.
Up to 10 years of customer security maintenance from Canonical's restricted repositories.
Channel Tags | Supported until | Currently | Architectures | |
---|---|---|---|---|
0.1.1-24.04_stable | 0-24.04 , 0-24.04_beta , 0-24.04_candidate , 0-24.04_edge , 0-24.04_stable , 0.1-24.04 , 0.1-24.04_beta , 0.1-24.04_candidate , 0.1-24.04_edge , 0.1-24.04_stable , 0.1.1-24.04 , 0.1.1-24.04_beta , 0.1.1-24.04_candidate , 0.1.1-24.04_edge | 03/2025 | metrics-proxy 0.1.1 on Ubuntu 24.04 LTS | amd64 |
0.1.1-22.04_stable | 0-22.04 , 0-22.04_beta , 0-22.04_candidate , 0-22.04_edge , 0-22.04_stable , 0.1-22.04 , 0.1-22.04_beta , 0.1-22.04_candidate , 0.1-22.04_edge , 0.1-22.04_stable , 0.1.1-22.04 , 0.1.1-22.04_beta , 0.1.1-22.04_candidate , 0.1.1-22.04_edge | 11/2025 | metrics-proxy 0.1.1 on Ubuntu 22.04 LTS | amd64 |
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
.
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).
Launch this image locally:
docker run -d --name metrics-proxy-container -e TZ=UTC -p 15090:15090 ubuntu/metrics-proxy:0.1.1-24.04_stable
Access aggregated metrics at http://localhost:15090
.
Parameters
Parameter | Description |
---|---|
-e TZ=UTC | Timezone setting for the container. |
-p 15090:15090 | Port mapping for accessing the metrics-proxy aggregated metrics endpoint. |
-e POD_LABEL_SELECTOR="foo=bar" | Specify labels to filter Kubernetes pods for metrics aggregation. |
-e PORT="15090" | The port on which the metrics-proxy listens for scrape requests. |
-e SCRAPE_TIMEOUT="9s" | Configures the timeout duration for scraping metrics from the pods. |
Testing/Debugging
To debug the container:
docker logs -f metrics-proxy-container
To get an interactive shell:
docker exec -it metrics-proxy-container /bin/bash
To debug the container:
docker exec -it metrics-proxy-container pebble logs -f metrics-proxy
To get an interactive shell:
docker exec -it metrics-proxy-container /bin/bash
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 "metrics-proxy: <issue summary>
". Make sure to include the digest of the image you are using, from:
docker images --no-trunc --quiet ubuntu/metrics-proxy:<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 |
---|---|---|---|
track |
docker pull ubuntu/metrics-proxy