Add `ServiceNow` integration (#21154)
Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud>
Joao Cardoso committed
Oct 16, 2025 at 08:20 UTC
9bc564598bb30bacbeec893f3ba9789dc413a687
1 file changed
+41
integrations/cloud-notifications/metadata.yaml
+41
@@ -708,3 +708,44 @@
708
- Notifications: The notifications which you want to be notified
709
- **Integration configuration**
710
- Alert Source API key: The key you copied in the ilert configuration step.
711
+
712
+- id: "notify-cloud-servicenow"
713
+ meta:
714
+ name: "ServiceNow"
715
+ link: "https://www.servicenow.com/"
716
+ categories:
717
+ - notify.cloud
718
+ icon_filename: "servicenow.png"
719
+ keywords:
720
+ - servicenow
721
+ setup:
722
+ description: |
723
+ ### Prerequisites
724
+
725
+ - Netdata Cloud account
726
+ - Access to the Space as an **Admin**
727
+ - The Space needs to be on a paid plan
728
+ - The ServiceNow **Event Management** plugin enabled on your instance
729
+ - A ServiceNow user with the `evt_mgmt_admin` role and a password for API access
730
+
731
+ ### ServiceNow Configuration
732
+
733
+ 1. Verify that the **Event Management** plugin is activated on your ServiceNow instance.
734
+ 2. Navigate to **System Security** --> **Users** and create a dedicated integration user if one does not already exist.
735
+ 3. Assign the `evt_mgmt_admin` role to this user and set a strong password. Keep the username and password available for the Netdata configuration step.
736
+
737
+ ### Netdata Configuration
738
+
739
+ 1. Click on the **Space settings** cog (located above your profile icon)
740
+ 2. Click on the **Alerts & Notifications** tab
741
+ 3. Click on the **+ Add configuration** button
742
+ 4. Add the ServiceNow Integration
743
+ 5. A modal will be presented to you to enter the required details to enable the integration:
744
+ - **Notification settings**
745
+ - Configuration name (optional): A descriptive name to identify this notification configuration
746
+ - Rooms: A list of Rooms for which you want to be notified
747
+ - Notifications: Event types for which you want to receive notifications.
748
+ - **Integration configuration**
749
+ - Instance URL: The base URL of your ServiceNow instance (for example, `https://my-instance.service-now.com/`).
750
+ - Username: The username of the ServiceNow integration user you created.
751
+ - Password: The password of the ServiceNow integration user you created.