How-to add Prometheus Alert Manager

Owned by Former user (Deleted)
Last updated: Dec 11, 2023 by Matthew Hierholzer
2 min read


This short how-to shows you how to add the Prometheus Alert Manager via Special Agent.

LAST TESTED ON CHECKMK 2.1.0P1

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 the Prometheus Alert Manager Host with "API integrations, no Checkmk Agent"
    Screenshot detailing the Checkmk agent API integrations option when adding a new host.

  2. Create the rule:

    Setup →  Agents → VM, Cloud, Container → Alertmanager → Add Rule
    Screenshot of a new alertmanger rule. Ignore alert rules selected.

    • Name of Piggyback Host: We suggest the alert manager host, but feel free to choose what fits you best.

    • All other options, according to your settings

    • For connection options. Make sure to connect to the Prometheus instance!

    • Explicit host: the Prometheus Alert Manager host 


Screenshot of the alertmanager rule with an explicit hosts set.