Sign inSign up

ubuntu/metrics-proxy

Verified Publisher

By Canonical

•Updated 3 months ago

A lightweight proxy designed to expose a unified metrics endpoint for multiple Kubernetes pods.

Image
0

10K+

ubuntu/metrics-proxy repository overview

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⁠]

⁠Tags and Architectures

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

TagsSupported untilVersionBaseArchitectures
0.1-26.04_edge08/20260.126.04amd64
View deprecated tags
TagsSupport ended onUpgrade Path
0.1.1-24.04_stable
aliases0-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 -
0.1.1-22.04_stable
aliases0-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 -

⁠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/metrics-proxy:0.1.1-24.04_stable plan
⁠Run

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⁠.

⁠Get logs

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>
⁠Monitor health checks

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

⁠Configuration

⁠Environment variables
OptionDescriptionDefault
TZTimezone setting for the container.UTC
POD_LABEL_SELECTORSpecify labels to filter Kubernetes pods for metrics aggregation, using the format foo=bar.None
SCRAPE_TIMEOUTConfigures the timeout duration for scraping metrics from the pods.9s
PORTThe port on which the metrics-proxy listens for scrape requests.15090
⁠Ports
OptionDescriptionDefault
-p <port>:15090Port mapping for accessing the metrics-proxy aggregated metrics endpoint. Replace port 15090 if any other port is passed to the environmental variable PORT.None

[Report a bug⁠] [Contribute⁠]

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:f3b99195c…

Size

67.2 MB

Last updated

3 months ago

docker pull ubuntu/metrics-proxy:0.1-26.04_edge

This week's pulls

Pulls:

258

Last week