Creating PagerDuty connections

Prerequisites

Before you create a PagerDuty connection, you must create a ChatOps connection. For more information, see Outgoing connections.

Creating PagerDuty connections

To create a PagerDuty connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Data and tool connections page, click Add connection.

4. From the list of available connections, find and click the PagerDuty tile.

   Note: If you do not immediately see the connection that you want to create, you can filter the tiles by type of connection. Click the type of connection that you want in the Category section.

5. On the side-panel, review the instructions and when ready to continue, click Connect.

6. On the Add connection page, define the general connection details:

   • Name: The display name of your connection.

   • Description: An optional description for the connection.

   • API key: The connection token for your PagerDuty instance.

   • Service IDs: An optional comma-separated list of PagerDuty service IDs. The service ID can be obtained from the PagerDuty URL. If you view a specific service, the PagerDuty URL might be something like the following URL: https://xyz.pagerduty.com/service-directory/P4FY6G2 In this example, the service ID is P4FY6G2.

   • Team IDs: An optional comma-separated list of PagerDuty team IDs. If you view a specific team, the PagerDuty URL might be something like the following URL: https://ibm.pagerduty.com/teams/PV429MG In this example, the team ID is PV429MG.

   • Base parallelism: It is recommended to use a higher value than 1 so that you can process data in parallel. In a small environment the available flinks slots is 16 and for a large environment, the maximum available slots is 32.

   • Sampling rate: The rate at which data is pulled from live source (in seconds). The default value is 60.

   • Data flow: Set the toggle to 'On' to enable event data from PagerDuty to flow to IBM Cloud Pak for Watson AIOps. For more information about enabling your connection, see Enabling PagerDuty connections.

     Note: When the body.cef\_details attribute is not present in the raw data from PagerDuty, there is no way to extract the entity and assign it to the resource attribute in the event input and the event cannot be associated with an application.

     You can test your connection by clicking Test connection.

   Note: PagerDuty mappings are the default mappings for IBM Cloud Pak for Watson AIOps's standard fields for events.

7. Click Done.

You created a PagerDuty connection in your instance.

To create more connections, see Configuring data and tool connections.

For more information about working with the insights provided by your connections, see ChatOps insight management.

Enabling and disabling PagerDuty connections

If you didn't enable your data collection during creation, you can enable your connection afterward. You can also disable a previously enabled connection the same way. To enable or disable a created connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Manage connections tab of the Data and tool connections page, click the PagerDuty connection type.

4. Click the connection that you want to enable or disable.

5. Set Data collection to On or Off to enable or disable log data collection. Disabling data collection for a connection does not delete the connection.

You enabled or disabled your connection. For more information about deleting a connection, see Deleting PagerDuty connections.

Editing PagerDuty connections

After you create your connection, your can edit the connection. To edit a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the PagerDuty connection type on the Manage connections tab of the Data and tool connections page.

4. On the PagerDuty connections page, click the name of the connection that you want to edit. Alternatively, you can click the options menu (three vertical dots) for the connection and click Edit. The connection configuration opens.

5. Edit your connection. Click Next to go through the connection configurationn pages. Click Save when you are done editing.

You edited your connection. If you did not previously enabled or disabled your application, you can enable or disable the connection directly from the interface. For more information about enabling and disabling your connection, see Enabling and disabling PagerDuty connections. For more information about deleting a connection, see Deleting PagerDuty connections.

Deleting PagerDuty connections

If you no longer need your PagerDuty connection and want to not only disable it, but delete it entirely, you can delete the connection from the console.

Note: You must disable data collection before you delete your connection. For more information about disabling data collection, see Enabling and disabling PagerDuty connections.

To delete a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the PagerDuty connection type on the Manage connections tab of the Data and tool connections page.

4. On the PagerDuty connections page, click the options menu (three vertical dots) for the connection that you want to delete and click Delete.

5. Enter the name of the connection to confirm that you want to delete your connection. Then, click Delete.

Your connection is deleted.