Custom Webhook Alarm Notifications | Cloudmon

Custom Hook

Third Party Integration

Custom Hook

Send Cloudmon alarm notifications to any webhook endpoint. Custom hooks allow you to integrate Cloudmon with any system that accepts HTTP callbacks, enabling customized notification and automation workflows beyond the built-in integrations.

Overview

The Custom Hook integration sends an HTTP payload to a URL of your choice whenever an alarm fires in Cloudmon. This makes it possible to connect Cloudmon to any system that exposes a webhook endpoint, including internal automation tools, custom dashboards, ticketing systems not natively supported, or any platform that can receive and process HTTP requests.

To open, update, and close tickets in a tool with a REST API, see Custom Integration.

Step 1: Configure in Cloudmon

  1. Navigate to Settings → General Settings → Integrations.
  2. Locate the Custom Hook widget and click the + Add button. A form titled Add Webhook opens.
  3. Fill in the fields as described in the following table.
  4. Click Test Connection to check that Cloudmon can reach the endpoint.
  5. Click Save. Click Reset to clear the form, or Close to discard it.
FieldDescription
Name*A display name to identify this webhook in Cloudmon, such as "Internal Automation" or "Custom Alert Receiver".
Hook URL*The HTTP method, POST by default or GET, and the webhook endpoint URL that Cloudmon sends the request to when the alarm fires. The URL must be reachable from the Cloudmon controller.
Verify SSL CertificateSelect to verify the SSL certificate of the endpoint.
Data Type*How the request body is encoded: Form Data, Form URL Encoded, or Raw. Raw is the default.
Content TypeThe format of a raw body: JSON, XML, Text, HTML, or None.
Request HeadersExtra headers to send, as name and value pairs. Add each one with the plus icon. The Content-Type header is added automatically.
Body ContentThe request body. Type $ to insert a replaceable tag with alarm or device details. See Replaceable Tags. Leave it empty to send the default alarm payload.
User AgentAn optional user agent string for the request.
Time Out (sec)How long Cloudmon waits for the endpoint to respond, in seconds.
AuthenticationNo Authentication or Basic Authentication. With Basic Authentication, enter the Username and Password the endpoint expects.

Replaceable Tags

Replaceable tags insert alarm and monitor details into the request body when the request is sent. In Body Content, type $ to open the tag list, search for a tag, and select it. For example:

{
"summary": "$message",
"severity": "$severity",
"source": "$device_ip",
"customer": "$customer_name",
"groups": "$device_groups",
"tags": "$device_tags"
}

The list offers the following tags under Alarm Properties.

TagName in the list
$messageMessage
$severitySeverity
$categoryCategory
$statusStatus
$metricMetric
$currentValueCurrent Value
$thresholdThreshold
$reasonReason
$createdAtCreated At
$alarmIdAlarm Id
$customerCustomer
$customer_idCustomer Id
$cleared_byCleared By
$clear_messageClear Message

It offers the following tags under Monitor Properties.

TagName in the list
$device_nameDisplay Name
$device_typeMonitor Type
$device_ipIP Address
$device_hostnameHost Name
$device_categoryCategory
$device_osOperating System
$device_vendorVendor
$device_last_polled_atLast Polled At
$device_depend_on_monitorsDependent Monitors
$device_groupsMonitor Groups
$device_tagsMonitor Tags
$customer_nameCustomer Name

Step 2: Enable in Alarm Rules

  1. Navigate to Settings → Configurations → Alarm Rules.
  2. Click the Add button to create a new alarm rule, or open an existing one.
  3. Add a trigger and configure the alarm conditions.
  4. In the THEN section, enable Third Party Services and select the configured custom hook from the dropdown.
  5. Click Save.

When this alarm fires, Cloudmon sends the request to the configured Hook URL, with your body content or, if it is empty, the default alarm payload.