This section lists the prerequisites and steps to integrate your VMware Pulse IoT Center instance with ServiceNow.

Prerequisites

You must have access to the following instances:
  • VMware Pulse IoT Center console
  • ServiceNow

Procedure

  1. Create a REST-based Notification Destination:
    1. Log in to the VMware Pulse IoT Center console and navigate to Settings > Notification Destinations.
    2. To create a notification destination, click CREATE.
      The Create Destination wizard is displayed.
    3. In the Details step, enter the name of your notification destination, an optional description, and click NEXT.
    4. In the Settings step, enable Secure Protocol. Enter the Host URL of the ServiceNow instance. For example, dev79872.service-now.com. Enter the port number as 443.
    5. Copy the security certificate from the ServiceNow browser and paste it in the Certificate text box.
    6. Select the Authentication Type as Basic and enter your ServiceNow credentials in the Username and Password text boxes. Click NEXT.
    7. In the Review step, review the details and click SAVE.
  2. Create a Notification Definition:
    1. Navigate to Alerts and Notifications > Notification Definitions.
    2. In the Alerts and Notifications - Notification Definitions page, click CREATE.
      The Create Definition wizard is displayed.
    3. In the Details step, enter a name for the notification definition, enter an optional description, and click NEXT.
    4. In the Settings step, select the Type as REST Notification, and select that destination that you created in step 1.
      Note: ServiceNow provides multiple tables to which you can insert or create a record. In this example, we use the Incident table to create a record. To view the full list of tables in ServiceNow, go to the ServiceNow instance and navigate to REST API Explorer.
    5. In the URL field, append the URL with the path /api/now/table/incident.
    6. Under Advanced Settings, add a new header with the header name as Content-Type. Enter the header value as application/json. Click DONE.
    7. In the Body Template text box, enter the keys to be populated in ServiceNow. You can derive the keys from the ServiceNow instance. The following example illustrates a sample body template:
      {
      	"caller_id": "Test User",
      	"short_description": "Notification for Alert ${alertState}",
      	"description": "This is an automated notification from VMware Pulse IoT Center.\n\n Device Id : ${deviceId}, \n deviceTemplateId: ${deviceTemplateId}, \n Alert Name : ${alertTemplate}, \n Alert State : ${alertState}, \n Severity : ${alertSeverity}, \n  Recommendation : ${recommendation}, \n Alert Definition ID : ${alertDefinitionId}, \n Metric Value : ${lambda}. \n\n To view additional details, go to the VMware Pulse IoT Center Server."
      }
    8. Click NEXT.
  3. Review the details that you have entered and click SAVE.

Results

You have successfully integrated VMware Pulse IoT Center with ServiceNow. When you associate an alert definition with this ServiceNow notification definition, ServiceNow files an incident whenever an alert is triggered.