Alert dashboard for Prometheus Alertmanager.
Alertmanager UI is useful for browsing alerts and managing silences, but it's
lacking as a dashboard tool - karma aims to fill this gap.
0.7.0 release it can also aggregate alerts from multiple
Alertmanager instances, running either in HA mode or separate. Duplicated alerts
are deduplicated so only unique alerts are displayed. Each alert is tagged with
names of all Alertmanager instances it was found at and can be filtered based
on those tags (
@alertmanager). Note that
@alertmanager tags will be visible
only if karma is configured with multiple Alertmanager instances.
Alerts are displayed grouped preserving group_by configuration option in Alertmanager. If a group contains multiple alerts only first few alerts will be presented, the rest can be expanded or hidden using - / + buttons. The default number of alerts can be configured in the UI settings module. Each individual alert will only show unique labels and annotations, labels and annotations that are shared between all alerts will be moved to the footer. Example:
Each group can be collapsed to only show the title bar using top right toggle icon.
To get notifications about new karma releases you can subscribe to the RSS feed that GitHub provides To get email notifications please use one of the free services providing RSS to email notifications, like Blogtrottr.
I created karma while working for Cloudflare, originally it was called unsee. This project is based on that code but the UI part was rewritten from scratch using React. New UI required changes to the backend so the API is also incompatible. Given that the React rewrite resulted in roughly 50% of new code and to avoid confusion for user I've decided to rename it to karma, especially that the original project wasn't being maintained anymore.
Supported Alertmanager versions
Alertmanager's API isn't stable yet and can change between releases, see
VERSIONS in internal/mock/Makefile for list of all
Alertmanager releases that are tested and supported by karma.
Due to API differences between those releases some features will work
differently or be missing, it's recommended to use the latest supported
The karma process doesn't send any API request to the Alertmanager that could modify alerts or silence state, but it does provide a web interface that allows a user to send such requests directly to the Alertmanager API. If you wish to deploy karma as a read-only tool please ensure that:
- the karma process is able to connect to the Alertmanager API
- read-only users are able to connect to the karma web interface
- read-only users are NOT able to connect to the Alertmanager API
karma process metrics are accessible under
/metrics path by default.
If you set the
--listen.prefix option a path relative to it will be
Building and running
Building from source
To clone git repo and build the binary yourself run:
git clone https://github.com/prymitive/karma $GOPATH/src/github.com/prymitive/karma cd $GOPATH/src/github.com/prymitive/karma
To finally compile
karma the binary run:
Note that building locally from sources requires Go, nodejs and yarn. See Docker build options below for instructions on building from withing docker container.
karma can be configured using config file, command line flags or environment
variables. Config file is the recommended method, it's also the only way to
configure karma to use multiple Alertmanager servers for collecting alerts.
To run karma with a single Alertmanager server set
environment variable or pass
--alertmanger.uri flag on the command line, with
Alertmanager URI as argument, example:
ALERTMANAGER_URI=https://alertmanager.example.com karma karma --alertmanager.uri https://alertmanager.example.com
There is a make target which will compile and run karma:
By default it will listen on port
8080 and Alertmanager mock data will be
used, to override Alertmanager URI set
make PORT=5000 ALERTMANAGER_URI=https://alertmanager.example.com run
Running pre-build docker image
Official docker images are built and hosted on hub.docker.com.
Images are built automatically for:
- release tags in git -
- master branch commits -
To start a release image run:
docker run -e ALERTMANAGER_URI=https://alertmanager.example.com lmierzwa/karma:vX.Y.Z
Latest release details can be found on GitHub.
To start docker image build from lastet master branch run:
docker run -e ALERTMANAGER_URI=https://alertmanager.example.com lmierzwa/karma:latest
Note that latest master branch might have bugs or breaking changes. Using release images is strongly recommended for any production use.
Building a Docker image
This will build a Docker image from sources.
Running the Docker image
Will run locally built Docker image. Same defaults and override variables
apply as with
make run. Example:
make PORT=5000 ALERTMANAGER_URI=https://alertmanager.example.com run-docker
Please see CONTRIBUTING for details.
Apache License 2.0, please see LICENSE.