PagerDuty Integration
Caveat: each of the following integration directions was based on the UI when it was written. The UIs may change by the time you read this, so UI updates are beyond the scope of these articles. Please go to the integration target sites for their latest information on integration directions.
PagerDuty + Apica Integration Benefits
Notify on-call responders based on alerts sent from Apica ASM.
Send enriched event data from Apica, including links to visualizations and metrics that triggered the event.
Create high and low urgency incidents based on the severity of the event from the Apica-triggered event.
Incidents will automatically resolve in PagerDuty when the metric in Apica ASM returns to normal.
How it Works
Any service availability check in Apica ASM be configured to trigger events of varying severity based on the thresholds set. When a service or collection of services violates the configured thresholds, Events can be escalated and routed directly to PagerDuty for alerting.
When the services return to normal, PagerDuty is automatically updated.Â
Requirements
Only active Apica and PagerDuty accounts are needed to use this integration..
Support
If you need help with this integration, please contact: support@apica.io
Integration Walkthrough
Â
In PagerDuty
Integrating With a PagerDuty Service
From the Configuration menu, select Services.
There are two ways to add an integration to a service:
If you are adding your integration to an existing service, click the name of the service to which you want to add the integration, and click the name of the service to which you want to add the integration. Then, select the Integrations tab and click the New Integration button.
If you are creating a new service for your integration, please read our documentation in the Configuring Services and Integrations section, please read our documentation in the Configuring Services and Integrations section and follow the steps outlined in the Create a New Service section, selecting Apica as the Integration Type in step 4. Continue with the In Apica section (below) once you have finished these steps.
Enter an Integration Name in the formatÂ
monitoring-tool-service-name
 (e.g.  Apica-Shopping-Cart) and select  Apica from the Integration Type menu.Click the Add Integration button to save your new integration. You will be redirected to the Integrations tab for your service.
An Integration Key will be generated on this screen. Keep this key saved in a safe place, as it will be used when you configure the integration with  Apica in the next section.
Configure PagerDuty Within ASM
To Setup Synthetic Monitoring with PagerDuty, you need to authorize Apica in PagerDuty, and configure at least one service. It is possible to set up Apica to work with multiple PagerDuty services, by simply repeating the setup for each service.
Authorize
The first step of the PagerDuty integration is authorizing Apica in PagerDuty.
To authorize Apica:
Click Add PagerDuty Account
The PagerDuty integration dialog is shown:
Enter the Email address for your PagerDuty account
Enter a Password for your PagerDuty account
Click Authorize Integration
PagerDuty (Existing Service)
If you already have a service set up, you can select it directly.
Add Existing Service
To add an existing service:
Check the Use existing service option
Select a service from the dropdown list
PagerDuty (New Service)
If you don't have any existing services, or if you want to create a new service. To add a new service:
Check the Crete a new service option
Enter a Service Name
The escalation polices configured in PagerDuty is shown in the dropdown list.
Select an Escalation Policy from the dropdown list
Finish PagerDuty Integration
After authorization, and selecting a service or creating one, you can finish the integration.
Click Finish Integration
The account is added to the list:
Once the PagerDuty account has been added, you can set up a PagerDuty alert within ASM. When that is done, any alert which triggers within Apica will trigger a PagerDuty alert, and any alert which resolves within Apica will resolve the corresponding PagerDuty alert.
How to Uninstall
In Apica ASM
Go to Integrations -> Pagerduty
Click the trashcan icon next to the PagerDuty integration you want to remove.
Â
Can't find what you're looking for? Send an E-mail to support@apica.io