This plugin sends alarms and metrics from the Collector to the ServiceNow Event Management module.
Once active, it collects all generated alerts and metrics and regularly posts them to ServiceNow via REST API.
Alarms are sent as ServiceNow EM events, metrics are sent as metric events.
It is possible to define several plugins, for example if a secondary collector is in place.
Configuration
From the plugin menu, select “ServiceNow Event Management” type and click on “Add” to create a new plugin. This will open the plugin configuration screen.
Fill the plugin settings form:
Enabled: Enable or disable the plugin
Name: The plugin display name
User: ServiceNow API user
Password: ServiceNow API password
ServiceNow Instance URL: The base URL of the ServiceNow instance
Config API URL: REST endpoint used to push configuration items to the CMDB (Leave empty to use the default)
Events API URL: REST endpoint used to send alarm events (Leave empty to use the default)
Metrics API URL: REST endpoint used to send metric events (Leave empty to use the default)
Chunk size: Maximum number of alerts or metrics sent per HTTP request
How it works
The plugin registers as a listener on both the alarm and metric pipelines.
Alarms and metrics are buffered internally (up to 50,000 items each).
Every 30 seconds, the plugin flushes the buffers and sends the data in chunks to ServiceNow.
Each alarm is mapped to a ServiceNow EM event with the following severity mapping:
RedPeaks Severity
ServiceNow EM Severity
CRITICAL
1 (Critical)
MAJOR
2 (Major)
MINOR
3 (Minor)
WARNING
4 (Warning)
INFO
5 (OK)
CLEAR
0 (Clear)
If the Config API URL is set, the plugin also pushes SAP system metadata to the ServiceNow CMDB, allowing EM events to be linked to the correct Configuration Items (CI)
Test Connection
Use the test button (flask icon) to verify that the Collector can reach the ServiceNow instance with the provided credentials