A lightweight proxy designed to expose a unified metrics endpoint for multiple Kubernetes pods.
10K+
ubuntu/metrics-proxy is a rock for metrics-proxy maintained by Canonical.
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 in the project repo.
[Learn more about metrics-proxy]
NOTE: These tags follow a specific naming convention that respects the concept of channels.
| Tags | Supported until | Version | Base | Architectures |
|---|---|---|---|---|
0.1-26.04_edge | 08/2026 | 0.1 | 26.04 | amd64 |
| Tags | Support ended on | Upgrade Path | |
|---|---|---|---|
0.1.1-24.04_stable | aliases0-24.040-24.04_beta0-24.04_candidate0-24.04_edge0-24.04_stable0.1-24.040.1-24.04_beta0.1-24.04_candidate0.1-24.04_edge0.1-24.04_stable0.1.1-24.040.1.1-24.04_beta0.1.1-24.04_candidate0.1.1-24.04_edge | 03/2025 | - |
0.1.1-22.04_stable | aliases0-22.040-22.04_beta0-22.04_candidate0-22.04_edge0-22.04_stable0.1-22.040.1-22.04_beta0.1-22.04_candidate0.1-22.04_edge0.1-22.04_stable0.1.1-22.040.1.1-22.04_beta0.1.1-22.04_candidate0.1.1-22.04_edge | 11/2025 | - |
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.
To view the Pebble services and checks defined in this rock:
docker run --rm ubuntu/metrics-proxy:0.1.1-24.04_stable plan
To run this rock, use any of the usual container runtimes, for example, docker:
docker run --name metrics-proxy-container \
-e TZ=UTC -p 15090:15090 \
ubuntu/metrics-proxy:0.1.1-24.04_stable
Metrics Proxy listens on port 15090. Access aggregated metrics at http://localhost:15090.
To view the logs of the running container, run:
docker exec metrics-proxy-container pebble logs
Or, for a specific service:
docker exec metrics-proxy-container pebble logs <service>
Rocks may have predefined health checks that you can list by running:
docker exec metrics-proxy-container pebble checks
The overall health of your container can be inspected via:
docker exec metrics-proxy-container pebble health
| Option | Description | Default |
|---|---|---|
| TZ | Timezone setting for the container. | UTC |
| POD_LABEL_SELECTOR | Specify labels to filter Kubernetes pods for metrics aggregation, using the format foo=bar. | None |
| SCRAPE_TIMEOUT | Configures the timeout duration for scraping metrics from the pods. | 9s |
| PORT | The port on which the metrics-proxy listens for scrape requests. | 15090 |
| Option | Description | Default |
|---|---|---|
-p <port>:15090 | Port mapping for accessing the metrics-proxy aggregated metrics endpoint. Replace port 15090 if any other port is passed to the environmental variable PORT. | None |
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.
Content type
Image
Digest
sha256:f3b99195c…
Size
67.2 MB
Last updated
3 months ago
docker pull ubuntu/metrics-proxy:0.1-26.04_edgePulls:
258
Last week