CheckMK Notifications

From FojiSoft Docs

CheckMK keeps you informed about the health of your IT infrastructure through a robust notification system. Here's the key idea:

  • Events trigger notifications: CheckMK monitors various aspects of your hosts and services. When something deviates from normal operation (like a service going critical or a host becoming unreachable), CheckMK generates an event.
  • Configurable notifications: CheckMK doesn't just tell you there's a problem; it allows you to define how you want to be notified. You can set up rules to send email alerts, SMS messages, or even push notifications to specific teams or individuals based on the severity of the event and the affected host or service.

This article will guide you through the steps to allow CheckMK to send these notifications to FojiSoft.

Data Source Configuration

  1. Log into your Foji account
  2. Access Data Sources under Integrations in the Settings application
  3. Click New Data Source
  4. Select the CheckMK Notifications provider under Infrastructure or find it using the search box
  5. Complete the required data source fields
    • Name: Enter a descriptive name for the Data Source
    • Server Url: Enter the full url to your CheckMK site. For example: https://monitoring.example.com/sitename/check_mk
  6. You may configure the severity weights for each type of notification for hosts or services as you desire
  7. Click Create
  8. Download the Notification Script

CheckMK Notification Script

CheckMK uses notification scripts to send notifications. Further documentation for CheckMK notification configuration is available from CheckMK at https://docs.checkmk.com/latest/en/notifications.html

  1. Download the Notification Script for your CheckMK Notification Data Source in FojiSoft
  2. Enter your FojiSoft Personal Access Key and Secret in the Script
  3. Save the Notification Script on your CheckMK server in ~/local/share/check_mk/notifications where ~/ is the site root for your CheckMK site. While not required, it is recommended that you name the script fojisoft.
  4. Allow execute permission on the script
    chmod +x local/share/check_mk/notifications/fojisoft
    This is required for CheckMK to execute the script when sending notifications.
  5. Configure Alert rules in CheckMK to use the new FojiSoft notification method.