Configuring Splunk On-Call

Published on January 20th, 2023

Introduction

This page describes how to set up Splunk On-Call plugin.

Steps

Step 1: Create an API token

In order for the Backstage integration to work we must first generate our api key.

In order to create a key, create an integration in your Splunk On-Call account by navigating to URL https://portal.victorops.com/dash/<your-organization>#/api-management. In there you can copy the API id and the existing key, or create a new key for Roadie integration purposes.

Step 2: Store the credentials in Roadie

Visit https://<tenant-name>.roadie.so/administration/settings/secrets and enter the copied values into SPLUNK_ON_CALL_API_ID & SPLUNK_ON_CALL_API_KEY secrets.

Set Splunk On-Call secrets via UI

Step 3: Configure Roadie with your Splunk On-Call account details

In order to be able to perform certain actions (create-acknowledge-resolve an action), you need to provide a REST Endpoint for the plugin.

To enable the REST Endpoint integration you can go on https://portal.victorops.com/ inside Integrations > 3rd Party Integrations > REST – Generic. You can now copy the URL to notify: <SPLUNK_ON_CALL_REST_ENDPOINT>/$routing_key

Visit https://<tenant-name>.roadie.so/administration/settings/splunk-on-cal and enter the REST endpoint for the configuration. In case you don’t want to enable incident management via the Roadie application, you can check the “Read Only” checkbox to configure the plugin to only show incidents.

Set Splunk On-Call Config

Step 4: Add the Splunk On-Call UI elements

The Splunk On-Call plugin provides two type of UI elements.

The card EntitySplunkOnCallCard is a card component and can be added to component dashboards. The tab SplunkOnCallPage is a content component which can be added as a separate tab to entity pages.

Step 5: Add needed annotations to your entities

The information displayed for each entity is based on either an associated team name or an associated routing key. To use this plugin for an entity, the entity must be labeled with either a splunk.com/on-call-team or a splunk.com/on-call-routing-key annotation.

For example, by specifying a splunk.com/on-call-team, the plugin displays Splunk On-Call data associated with the specified team:

annotations:
    splunk.com/on-call-team: <SPLUNK_ON_CALL_TEAM_NAME>

Alternatively, by specifying a splunk.com/on-call-routing-key, the plugin displays Splunk On-Call data associated with each of the teams associated with the specified routing key:

annotations:
  splunk.com/on-call-routing-key: <SPLUNK_ON_CALL_ROUTING_KEY>

References