ServiceNow Provisioning

Services Provisioning

Services provisioning (PagerDuty Services Provisioning) allows users to provision configuration items from ServiceNow as Business and technical services in PagerDuty. Users may optionally configure preferences for bulk provisioning on this screen as well.

🚧

Required User Permissions

A x_pd_integration.admin role is required in ServiceNow to provision to PagerDuty.

πŸ‘

Best Practices

Before provisioning Configuration Items as services to PagerDuty, we recommend the following:

  • Read our Service Configuration Guide for best practices in planning your PagerDuty Technical and Business service relationships.
    • Given the dependency relationships between Business and Technical services, review how you would like to map configuration item relationships noting the higher level CMDB classes and lower level CMDB classes.
  • Set the corresponding Assignment Group for each of the Configuration Items you will be provisioning. This simplifies the provisioning process: when you provision a single Configuration Item, it will verify that the Assignment Group exists in PagerDuty (as an Escalation Policy). If not, it will also provision the corresponding Assignment Group as a PagerDuty Escalation Policy.

With the PagerDuty integration, each ServiceNow configuration item can have a corresponding PagerDuty service. This integration offers an easy way to quickly generate a new PagerDuty service and webhook (which is necessary to send information back to ServiceNow). It will also populate the associated fields within ServiceNow.

Any configuration item that extends the base cmdb_ci table can be mapped to PagerDuty because it inherits the same field that contains the PagerDuty service ID. This makes it easy to map any type of configuration item to services in PagerDuty, although provisioning only Business Services, Technical Services and/or Applications is recommended. For each configuration item type, the form view for it will need to be modified to show the PagerDuty object ID.

Step 1: Choose Provisioning Method

Under Provision using CMDB relationship table, you have two options for defining CI dependencies prior to provisioning:

πŸ‘

Best Practices

If you have a well-established CMDB, we recommend that you provision using the CMDB relationship table.

1.1 Provision Using CMDB Relationship Table (Option 1)

When provisioning based on the CMDB relationship table, you have two further options:

1.1.1. Provision CI items based on selected CI Classes

1.1.2 Use service classification where applicable

If you have defined the type of service classification on the CI class service items and would like to use that value to classify the service as business or technical service, select the Use service classification where applicable checkbox.

πŸ“˜

Note

  • If you select the checkbox, and you have defined the service classification values, we will honor the value. Only the CIs with business and technical service classification type will be provisioned, but the application service type will be ignored.
  • If the value is left empty, we will provision it based on the classification in the slush buckets below, else if the service class is selected under both service types then the CI will be provisioned as both a business and technical service.
  • CIs that are both business and technical services will have an additional relationship provisioned on PagerDuty platform with the Business service having a dependency on the technical service of the same CI.

1.1.3 CIs without defined service classification

If you have not defined the type of service classification on the CI class service items, or for other CI classes that you would like to provision into PagerDuty, select the CI classes which belong to business service type under the Business Services class slush bucket and select the CI classes which belong to Technical Services type under the technical service class slush bucket.

Behaviors:

  • Select the CI classes under Business Services for those CI’s which are to be provisioned as business service.
  • Select the CI classes under Technical Services for those CI’s which are to be provisioned as technical service.
  • Select the CI classes which could be both business and technical service under both the slush buckets.
  • Avoid the CI classes which you do not want to provision into PagerDuty on both the slush buckets.
  • The CIs and dependencies will all be considered based on the CI classes selected under both the slush buckets.
  • All other CIs which do not match the classification will be ignored.

1.1.4. Choose Table with CIs

Once the CI classes are classified, under Choose Table with CIs or a single CI to be provisioned along with dependencies, select the CI table from where the CIs should be fetched. The dependencies will be identified for the items in the table based on the classes and they will be defined in the Services Provisioning Table.

Example : Selecting cmdb_ci_service will provision the CIs from the service table along with its dependencies, which may or may not be restricted to the table.

1.1.5. Selecting a Filtered List of CIs (Optional)

If you would like to only select a filtered list of CIs from the selected table, then select the option Open selected table to set and save filter to save and select the filter in the next field. Note: The filter option will appear only after you set the table value. Also, you will need to manually select the saved filter name to apply the filter for your provisioning.

1.1.6. Select Column for Service Name

Next, select the column which will define the service name in PagerDuty. The Name value is set by default, you may change it to another value if required.

1.1.7. Provision a Single Cl With Dependencies

The ability to provision a single CI along with its dependencies based on the configuration is now available within the same UI. Select the Provisioning single CI along with its dependencies checkbox, and then select the CI that you would like to provision with its dependencies, matching the CI classification set above.

Users can do bulk and single CI provisioning at the same time through the same configuration.

Save the different combinations of configurations if you would like to set different types of relationships, allowing you to set all the services and dependencies before provisioning.

Click Save Configuration.

1.2: Provision Using Custom Relationships (Option 2)

The custom relationships provisioning configuration allows users to define the relationships between CIs without taking into consideration the relationship that exists within ServiceNow CMDB.

Please read this user guide carefully before provisioning in bulk, as we do not currently support bulk deprovisioning.

Field

Expected Value

Provision using CMDB relationship table

No (Custom Relationships)

Select CI Table containing services

Select the table which contains the configuration items you would like to provision.

Example: Service(cmdb_ci_service) If you would like to provision the items from this table.

Select Filter

Open the selected table and save a filter, or save a filter on the table view before selecting this value.

The filter selected will be applied to fetch a filtered list of items from the table selected in the previous field.

Select the type of service to be provisioned

Business Service or Technical Service.

This selected value will apply to all the items on the selected table.

Select column for service name

This value will be used for the name to set on the service on PagerDuty.

Default value : Name

Select the relationship between services to be provisioned

  • Consumes: First being parent and second being child CI.

OR

  • Consumed by: First being child and second being parent CI.

The first selected table and the second selected table items will have the above relationship between the services.

Once the values are set, click Save Configuration.

The custom relationship is set between each item on both the tables, or if only one table is selected in both the values, then relationships are set between each item and the other items within the same table.

Example: A table is selected and filtered to provision the following list of configuration items:

If table cmdb_ci_A contains:

  • CI 1
  • CI 2
  • CI 3

If table cmdb_ci_B contains:

  • CI 4
  • CI 5
  • CI 6

Then the following relationships will be defined on the view services table:

Parent CI 1:

  • Child CIs:
    • CI 4
    • CI 5
    • CI 6

Parent CI 2:

  • Child CIs:
    • CI 4
    • CI 5
    • CI 6

Parent CI 3:

  • Child CIs:
    • CI 4
    • CI 5
    • CI 6

Users will need to review this information and delete the relationships and services which do not meet the requirements, to ensure only the expected services and relationships are provisioned.

The custom relationship merely creates all possible relationships between the selected list of items for the customer to remove those which are not required.

Step 2: View Services

Once saved, the configuration will populate the potential services and dependencies in the Services Provisioning table (PagerDuty Services Provisioning Table), along with the service type.

Review the table information before provisioning the services.

The Validation warnings column will load any missing information on the services, which allows users to fix these errors before provisioning. Once the errors are fixed, click Revalidate services.

Change the service type if there are any service types not as expected on the view services table, also remove any services and dependencies which you do not want to provision into PagerDuty.

Step 3: Provision Services

Once you have reviewed the list of services, click Provision Services. If there are any errors while provisioning, they will be captured in the Provisioning errors column. Fix the errors and retry provisioning.

Note:
If there are older services which were not provisioned due to errors or any other reason, delete these services/relationships from the View Services table before provisioning new services again.

Provision Users to PagerDuty

  1. The integration also allows you to provision users from ServiceNow to PagerDuty. In your ServiceNow Users list, you can see directly which users have already been created in PagerDuty as their PagerDuty ID field will be populated.
  2. Select a user that has not already been provisioned to PagerDuty and click on the Provision PagerDuty User link to add them to your PagerDuty account:
  1. You will then see a notice that the user is being provisioned. Upon completion, the PagerDuty ID field is automatically populated. The user also shows up within PagerDuty, with the same name and email address.
  2. If the user has their Business phone or Mobile phone fields populated in ServiceNow, these settings will also be automatically provisioned as Contact Methods and Notification Rules in PagerDuty.
  3. You can also provision multiple users at once by selecting them and clicking on the Provision PagerDuty User option from the dropdown menu on the Users screen.

Updated about a month ago


ServiceNow Provisioning


Suggested Edits are limited on API Reference Pages

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