ubuntu/prometheus-alertmanager repository overview

⁠Prometheus Alertmanager | Ubuntu

Current Prometheus Alertmanager Docker Image from Canonical⁠, based on Ubuntu. Receives security updates and tracks the newest combination of Prometheus Alertmanager and Ubuntu. This repository is free to use and exempted from per-user rate limits.

⁠About Prometheus Alertmanager

The Alertmanager handles alerts sent by client applications such as the Prometheus server. It takes care of deduplicating, grouping, and routing them to the correct receiver integration such as email, PagerDuty, or OpsGenie. It also takes care of silencing and inhibition of alerts. Read more on the Prometheus Alertmanager website⁠.

⁠Tags and Architectures

Up to 5 years free security maintenance on LTS channels.

Up to 10 years customer security maintenance from canonical/prometheus-alertmanager. Request access⁠.

Tags in italics are not available in ubuntu/prometheus-alertmanager but are shown here for completeness.

Channel Tag shows the most stable channel for that track. A track is a combination of both the application version and the underlying Ubuntu series, eg 1.0-22.04. Channels are ordered from the most stable to the least 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 unavailable channels/versions, please get in touch with the Canonical team⁠ (or using [email protected]⁠).

⁠Usage

Launch this image locally:

docker run -d --name prometheus-alertmanager-container -e TZ=UTC -p 30093:9093 ubuntu/prometheus-alertmanager:0.23-22.04_beta

Access your Prometheus Alertmanager server at localhost:30093.

⁠Parameters

⁠Testing/Debugging

To debug the container:

docker logs -f prometheus-alertmanager-container

To get an interactive shell:

docker exec -it prometheus-alertmanager-container /bin/bash

⁠Deploy with Kubernetes

Works with any Kubernetes; if you don't have one, we recommend you install MicroK8s⁠ and microk8s.enable dns storage then snap alias microk8s.kubectl kubectl.

Download alertmanager.yml⁠ and prometheus-alertmanager-deployment.yml⁠ and set containers.prometheus-alertmanager.image in prometheus-alertmanager-deployment.yml to your chosen channel tag (e.g. ubuntu/prometheus-alertmanager:0.23-22.04_beta), then:

kubectl create configmap alertmanager-config --from-file=alertmanager=alertmanager.yml
kubectl apply -f prometheus-alertmanager-deployment.yml

You will now be able to connect to the Prometheus Alertmanager server on localhost:30093.

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

docker images --no-trunc --quiet ubuntu/prometheus-alertmanager:<tag>

⁠Deprecated channels & tags

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