Cisco Catalyst Center ITSM Integration Guide, Release 3.2.x

PDF

About Catalyst Center-to-PagerDuty integration

Want to summarize with AI?

Log in

Overview

This section introduces the integration of Catalyst Center with PagerDuty for incident management and event notifications.

You can integrate Catalyst Center with PagerDuty.

Note

PagerDuty is an incident management platform that provides reliable notifications to detect and correct infrastructure problems. For information about PagerDuty, see https://www.pagerduty.com/.

This table displays the supported Catalyst Center-to-PagerDuty integration workflow.

Table 1. Catalyst Center-to-PagerDuty integration workflow
Step Description

Step 1

Review these Catalyst Center-to-PagerDuty integration requirements:

  • The latest Catalyst Center release.

  • PagerDuty

Note

PagerDuty integration with Catalyst Center is accomplished using the PagerDuty Events REST APIs and the Catalyst Center Events framework.

Step 2

Configure the integration settings. From the main menu, choose System > Settings > System Configuration > Integration Settings. Enter your callback URL hostname or IP address.

Step 3

Select and subscribe one or more events to forward notifications from Catalyst Center to PagerDuty.

To access an event in Catalyst Center, click the menu icon and choose Platform > Developer Toolkit > Event Notifications > Event Catalog. Event Catalog displays all the events.

Click the Notification tab to subscribe to an event.

Step 4

In the Notifications tab, create a new notification for the event.

Follow the steps in the Create a New Notification wizard and select PagerDuty as the notification channel.

This data must be entered in the Catalyst Center platform GUI for the selected event:

  • PagerDuty Events API URL

  • PagerDuty Integration key (routing key)

For detailed information about this event configuration procedure, see Subscribe Catalyst Center event notifications to PagerDuty.

Step 5

Notifications for the selected event are now forwarded to PagerDuty from Catalyst Center.

These are the supported workflow connections between Catalyst Center issues and PagerDuty events:

  • Open Catalyst Center to trigger PagerDuty.

Step 6

PagerDuty responds to Catalyst Center with one of these REST API responses:

  • 202: The event has been accepted by PagerDuty.

  • 400: Bad Request - Check that the JSON is valid.

  • 429: Too many API calls at a time.

  • 500 or other 5xx: Internal Server Error - the PagerDuty server experienced an error while processing the event.

  • Networking Error: Error while trying to communicate with PagerDuty servers.

Step 7

Review and change (if necessary) the incident status in PagerDuty.

Note
See your PagerDuty documentation for information about doing this step.

Step 8

Close the incident in PagerDuty.

Note
See your PagerDuty documentation for information about doing this step.

Step 9

PagerDuty integration is a one-way notification from Catalyst Center to PagerDuty. Catalyst Center is not dependent on PagerDuty status to close an issue.