PagerDuty Integration

From OSNEXUS Online Documentation Site
Jump to: navigation, search

PagerDuty is an ITSM (IT Service Management) for IT organizations to manage their support process and ticketing. Quantastor integrates with PagerDuty to forward a copy of all alerts that are severity "Error", "Warning", or "Critical". Integration with PagerDuty is done via a webhook URL which must be added to the QuantaStor Alert Manager screen as a new Alert Endpoint.

Step 1 - Add a Service to PagerDuty

After logging into your PagerDuty account navigate to *Services* -> *Service Directory* then choose the "+ New Service" to add a new service endpoint.

Enter a name for the service such as "QuantaStor Alerts" or something more specific to the storage grid you'll have alerts originating from "qs-grid-1 alerts".

Step 2 - Add an Integration

QuantaStor integrates with PagerDuty via the "Events API V2" so you'll need to add that integration to the service.

Step 3 - Get the Integration Key

After adding the integration click on the gear icon so that you can view the "Integration Key" which is also known as the "Routing Key" or "Routing Token". It will look something like this:


Step 4 - Add the Endpoint to QuantaStor

Login to your QuantaStor storage grid and then select the "Alert Manager" button to bring up the dialog for adding more alert endpoints. On the second page select "PagerDuty" from the dropdown list of ITSM integrations and then input the URL endpoint.

All PagerDuty endpoints must start with this HTTPS URL as the prefix:

Continuing the example above the full URL endpoint to put into QuantaStor will look like this with the Integration Key at the end:

Step 5 - Apply Changes and Test

Apply your changes then use the "Generate Test Alert" button to generate a test alert to verify everything is configured correctly and alerts are making it to PagerDuty. Note that "INFO" level alerts are not sent to the ITSM modules so be sure to generate a "WARNING" or "ERROR" level alert for testing.