/
How-to add Prometheus Alert Manager

How-to add Prometheus Alert Manager

This how-to shows you how to monitor the Prometheus Alertmanager via our special agent.

LAST TESTED ON CHECKMK 2.5.0P7

Table of Contents

The alertmanager special agent queries the "API/v1/rules" endpoint of Prometheus. This allows it to show which alarms have been triggered by Prometheus.

 

Step-by-step guide

  1. Create a host in Checkmk, which is supposed to represent your Prometheus Alertmanager.

  2. Set the option Checkmk agent / API integrations  to with "Configured API integrations, no Checkmk Agent"

    Screenshot detailing the Checkmk agent API integrations option when adding a new host.

     

  3. Create a rule in the rule set Prometheus Alertmanager. You find this rule set via Setup →  Agents → VM, Cloud, Container → Prometheus Alertmanager.

  4. Configure the rule to fit your needs.

    Important: Please add the URL and port of your Prometheus server into the field URL server address and not the address of the Alertmanager server itself. As mentioned above, the special agent queries the endpoint API/v1/rules of your Prometheus instance to get the information about your configured alerts.

    image-20260626-065927.png

     

  5. Make sure to nail this rule to the host you created in step 1.

    image-20260626-070041.png

     

 

Related articles