ServiceNow Change Requests Integration Guide

Set up and configure the ServiceNow Change Requests integration

PagerDuty enhances ServiceNow effectiveness by allowing customers to quickly add real-time response capabilities to their critical change management process. PagerDuty’s Change Request Integration will create change events on services in PagerDuty whenever a change request is opened, including important details like priority and risk.

🚧

Requirements

Configure the PagerDuty ServiceNow Integration

  1. Configure the PagerDuty ServiceNow integration.
  2. Once the integration has been configured, provision the desired CI as a service in PagerDuty.
  3. In your ServiceNow instance, navigate to the Change Requests CI and click Provision PD Change Event Integration under Related links.

Send ServiceNow Change Events

  1. In your ServiceNow instance, search for Change, click Create New and then select which type of change is required: Normal, Standard or Emergency.
  2. Once the change request has been created, search and select the Service and Configuration Item that have been provisioned from ServiceNow to PagerDuty. Then select the Assignment Group and enter a Short description.
  3. In the Planning tab, enter a Justification, Implementation plan, Risk and impact analysis, Backout plan, Test plan if applicable. This information will appear in the change event’s details in PagerDuty.
  4. In the Schedule tab, select and save the Planned start date, Planned end date, Actual start date and Actual end date. This information will schedule the maintenance window on the selected service in PagerDuty. Click Submit.
  5. Click the change request Number that was just requested and then click Request Approval at the top right of the request. Once approved, navigate to the change request and click Implement at the top right. You should now be able to see the change event in PagerDuty in the following locations:
  • The Incidents Recent Changes page. If you click the change event’s Summary you will be able to see all of the details entered in the change request. You may also click the View CHG[NUMBER-HERE] link to the far right of the change event that will link back to the change request in ServiceNow.
  • On the Services Service Directory Maintenance Windows tab. Please Note: Maintenance windows will not be automatically ended if the change request is completed in ServiceNow. Users can either manually end the maintenance window in PagerDuty or they can wait until the window ends at its end time.
  • The connected service in PagerDuty will also have a Status of being in maintenance mode.

Edit ServiceNow Change Event Custom Details Format

  1. In your ServiceNow account, navigate to PagerDuty Configuration files Script Includes tab and search for change events.
  2. Click PagerDuty Change Events and then scroll down in the Script body to find the payload of the var chgEventBody. You may customize the details in this script directly.
  3. Click Update to save your customization.

Disable Maintenance Windows via Change Requests

To disable ServiceNow change requests from creating PagerDuty maintenance windows:

  1. In your ServiceNow account, navigate to PagerDuty Configuration files Application Files tab and search for *maint.
  2. Click the change event maintenance window system property and change the Value field to false.
  3. Click Update to save your customization.

Disable the ServiceNow Change Events Integration

  1. In your ServiceNow account, navigate to PagerDuty Configuration files Business Rules tab and search for change events.
  2. Click the PD Change Request to Change Event Name and deselect the Active checkbox.
  3. Click Update to disable change events.

Updated 2 months ago


ServiceNow Change Requests Integration Guide


Set up and configure the ServiceNow Change Requests integration

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.