How to set up PagerDuty

This guide will provide step-by-step instructions on how to set up a PagerDuty Service, enabling you to easily view Fabric Events. You can use the Integration Key Details in the following POST fabric/v4/streamSubscriptions request

curl -X POST
'https://api.equinix.com/fabric/v4/streamSubscriptions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <bearer_token>' \
--data '{
"type": "STREAM_SUBSCRIPTION",
"name": "<pagerduty_subscription_name>",
"description": "<pagerduty_subscription_desc>",
"stream": {
"uuid": "<stream_id>"
},
"sink": {
"uri": "https://events.pagerduty.com",
"type": "PAGERDUTY",
"credential": {
"type": "INTEGRATION_KEY",
"integrationKey": "<pagerduty_integration_key>"
}
}
}'

Step-by-Step Instructions

1. Create a new Service Directory 

• Log in to your PagerDuty and follow the instructions in the Slack documentation to create a Service (Refer to PagerDuty Doc Create a Service). 
• Under Services, navigate to Service Directory and click on New Service.

1.1 Provide Name and Description

• Service Name: Provide a name based on the function that the service provides.
• Service Description: Provide a description based on the function that the service provides.
• Click Next to Continue.

1.2 Assign an Escalation Policy

• Select generate a new escalation policy or select an existing escalation policy.
• If you generate a new escalation policy, you will be placed as the first-level on-call for the service. You can edit the escalation policy at any time after the service is created.
• Click next to continue.

1.3 Configure Escalation Policy Alerts

• Select an escalation policy for the service. To understand the different selections for Intelligent, Content-based, and Time-based, refer to PagerDuty Documentation - Create a Service.
• Click next to continue.

1.4 Select Integration (s) for the Service

• Integrations: Select the integration (s) you use to send alerts to this service from the search bar, dropdown or from the list of most popular integrations.
• For Fabric events, select events API V2 Integration. You can add or edit the integrations at any time after the service is created.
• Click Create Service and you will be redirected to the service's integrations tab.

2. Save the Integration Key from the Service

• Ensure that the Integration key generated during this process is saved securely. The integration Key is required for further integration or data ingestion processes.

2.1 Copy the Integration Key

• Once the setup is complete, an Integration Key Value will be generated.
• Copy this Integration Key to your clipboard, as it will be needed later for the POST streamSubscription API in Stream Observability.

2.2 Start receiving Fabric events in the PagerDuty Service

• PagerDuty Alert Events create incidents on a service in PagerDuty that are assigned to the person on-call. This will generate a notification to acknowledge or resolve the incident. Alert Events are visible under the Open Incidents and Resolved Incidents Sections.
• PagerDuty Change Events create incidents that do not trigger any notification and provide context for an incident. Change events are visible under the recent changes section, and it requires PagerDuty AIOps to be enabled. 
• For more information regarding different PagerDuty event types, refer to this document.