Skip to content

canonical/karma-alertmanager-proxy-k8s-operator

Repository files navigation

Karma Alertmanager Proxy (k8s)

CharmHub Badge Release Discourse Status

Description

Proxy charm to provide the details of an Alertmanager server to Karma. This is a sidecar-only charm (no workload) that is used to pass data to Karma over a relation.

Usage

juju deploy karma-alertmanager-proxy-k8s
juju relate karma-alertmanager-proxy-k8s karma-k8s

Configuration

juju config karma-alertmanager-proxy-k8s url="http://some.url.somewhere:9093"

Note that an instance of the proxy app is needed for every alertmanager unit. Therefore, if more than one alertmanager unit needs to be registered in karma, multiple proxy apps should be used:

juju deploy karma-alertmanager-proxy-k8s proxy1
juju deploy karma-alertmanager-proxy-k8s proxy2

juju config proxy1 url="http://some.uri.somewhere:9093"
juju config proxy2 url="http://some.uri.somewhere.else:9093"

Actions

None.

Scale out usage

You may add additional units for high availability

juju add-unit karma-alertmanager-proxy-k8s

Relations

Currently, supported relations are:

  • karma-dashboard, which forwards the configured alertmanager unit data to karma, over the karma_dashboard: interface. Set up with: juju relate karma-alertmanager-proxy-k8s karma-k8s.

OCI Images

This is a no-workload charm, but currently, due to juju limitations, an image must be provided nonetheless. Either alpine or busybox are good choices for a small footprint, stand-in image.