Connection

Connect On-Call Optimizer to a supported on-call product so you can create schedules by copying them from it, and keep its schedules up to date with your assignments.

You need permission to manage integrations in your organization. Without it, the Add an on-call product button is disabled. See Organizations for roles and permissions.

1. Open the On-call products tab

1. Click your organization’s name in the top navigation bar. (On narrow screens the name is hidden. Open the navigation menu and click Organization instead.)
2. Open the On-call products tab.
3. Click Add an on-call product at the right end of the tab bar.

The Select on-call product dialog opens.

2. Select your on-call product

1. Choose your product at the top of the dialog, e.g. PagerDuty or OpsGenie. The dialog lists what On-Call Optimizer imports from it.
2. Click Begin connection.

3. Enter your API key

The connection page opens with the status Authentication required.

1. Enter the API key from your on-call product in the API key card. Splunk also needs an API ID, so its card is titled API credentials. See the page for your product for how to create a key and which permissions it needs.
2. Click Save at the top right of the page.

Screencast

This short recording shows steps 1 to 3 for PagerDuty.

Done

On-Call Optimizer tests the key and fetches the schedules available in your on-call product. While this happens the status reads Attempting initial data fetch…. It may take a couple of minutes.

When the fetch is complete, the connection page shows the connection Status and a Schedule status table listing each schedule found. The Shifts column shows which On-Call Optimizer schedule synchronizes with it (or (unused)). Use the search box to filter the list by name. Click the refresh icon next to the status to fetch the schedules again. To replace the key later, click Change API key at the top of the page.

Next: copy a schedule

The connection page shows status only. To create an On-Call Optimizer schedule from one of the schedules in your on-call product, go to Schedules → Create new schedule → Copy a schedule from your on-call product. See Integrate an existing schedule.

Removing a connection

A connection can only be removed when no On-Call Optimizer schedule uses it. Each card on the On-call products tab shows how many schedules reference the connection. See the page for your product for the steps to stop using a connection.

1. On the On-call products tab, click the Disconnect icon (a circled cross) at the top right of the connection card, or open the connection and click Disconnect at the top of the page.
2. Click Disconnect in the Disconnect product dialog (for example Disconnect PagerDuty) to confirm.

While any schedule uses the connection, Disconnect is disabled.