Alertmanager Integration
========================

Iris can easily be integrated into an existing (Prometheus) Alertmanager implementation.

==================
Iris Configuration
==================

Enable the builtin Alertmanager webhook in Iris' configuration.

Configuration::

    webhooks:
      - alertmanager

Then create an application using the UI. In this example let's use the name 'alertmanager'.
Once you've created the application you'll be able to retrieve the application's key.
Here we'll use "abc".

==========================
Alertmanager Configuration
==========================

In alertmanager, you can configure Iris as a receiver, using the application and it's key
as parameters.

Configuration::

    receivers:
    - name: 'iris-team1'
      webhook_configs:
        - url: http://iris:16649/v0/webhooks/alertmanager?application=alertmanager&key=abc

Then create a rule which includes the label "iris_plan". This label will point to a plan
you created in Iris.

Alert Rule::

   ALERT some_metric_high
     IF some_metric > 2
     FOR 1m
     LABELS { iris_plan = "teamA" }
     ANNOTATIONS {
       summary = "Oh my, a problem {{ $labels.instance }}",
       description = "{{ $labels.instance }} - {{ $labels.job }} :: Dear oh dear. {{ $value }}",
     }