Integrating Auvik with PagerDuty

For more information on editing, deleting, disabling, and enabling integrations, see How do I edit, delete, disable, or enable integrations?

• Auvik can trigger and resolve alerts in PagerDuty. 
• PagerDuty can notify on-call responders based on alerts sent from Auvik.
• You can create high- or low-urgency incidents based on the severity of the event from the Auvik alert.
• The integration is configured as a webhook in Auvik, and as a native app in PagerDuty.

Requirements

PagerDuty integrations require an admin role for account authorization. If you don’t have this role, reach out to your PagerDuty admin or account owner to configure the integration.

How it works

Auvik connects to PagerDuty for alert notifications using an incoming webhook. The webhook is initially configured in PagerDuty by installing the Auvik app. 

Integration walkthrough

To set up an Auvik integration to PagerDuty, first create the new incoming webhook by following the steps below. Then create the new integration in Auvik.

In Auvik, the PagerDuty integration can only be managed from the global view. The basic steps to configure the integration are as follows: 

• Installing the Auvik app in PagerDuty
• Adding a new PagerDuty integration in Auvik
• Configuring a notification channel and associating it with alerts
• Finding alerts
• Managing multiple locations

Installing the Auvik app in PagerDuty

1. In PagerDuty, navigate to your Services view and the Integrations subheading
2. Under Integrations, click Add a new integration to this service. 
3. Set an integration name. It can be anything you want.
4. Under Integration Type, search for and select Auvik.
5. Click Add Integration. This returns you to the Services view, where you should now see your newly installed integration. 
6. Click on the newly installed integration.
7. You’ll see a screen similar to the one below. Copy the integration URL. You’ll need this for the next step, which is to set up the integration in Auvik.

 

Adding a new PagerDuty integration to Auvik

1. In Auvik, at the global view, click Integrations in the side navigation bar.
2. Hover over the Add Integration button and select Webhook.

3. Fill in the following detail:
   1. Integration name. You can use the default name of PagerDuty or specify something more specific. 
   2. In the WebHook URL field, paste the integration URL you copied from PagerDuty.
4. Click Test Connection to confirm your settings are accurate.
5. Click Save.

If the test connection spins or a fail message appears, contact Auvik support. 

 

Configuring notification channels and associating them with alerts

1. In Auvik, add a new notification channel that uses the new PagerDuty integration. The end result should look something like this:

2. Associate the notification channel with the alerts you’d like to send to PagerDuty. You can do this from the global view or from a specific site dashboard.

 

Finding integrated alerts

Auvik is now configured to send alerts to PagerDuty. The alerts show up on your PagerDuty incident board with a Triggered status.

 

If the alert is resolved in Auvik (for example, a device went offline and triggered an alert but the device is now back online), the corresponding incident appears in PagerDuty as Resolved. 

 

 

Clicking on any alert in PagerDuty provides more information about the alert from Auvik, as well as a link to the alert in Auvik. You may be able to build additional custom conditions in PagerDuty off this data.

 

You can search for all alerts created by your Auvik integration by hovering over the Incidents tab and selecting Alerts. You can then filter by source (Auvik) or by the name of the integration you set in step 3.

 

 

Managing integrations for multiple locations

Managing a single network with multiple locations

Be aware that Auvik can’t currently distinguish alerts that come from different locations (say, the Cleveland office and the Houston office) that are running on a single Auvik site. All of your Auvik alerts will feed into a single PagerDuty service. 

You can, however, configure multiple Auvik app integrations within multiple different services in PagerDuty, and add a new webhook integration in Auvik for each PagerDuty integration. You can also choose to use the custom details in an alert to route alerts.

Managing multiple networks

You can send all the notifications to a single channel. Auvik will specify the site name for each notification so you know which notifications apply to which site or client.