Plugins 〉Pagerduty


Developer

xginn8

Sign up to receive occasional product news and updates:


Grafana Cloud
ObservabilityCON on the Road: Chicago (Mar 11)

See demos of new Grafana Cloud observability workflows, hear community success stories, and leave with what you need to advance your observability roadmap.


The Pagerduty plugin has been deprecated and is no longer maintained.

Data Source
community

Pagerduty

  • Overview
  • Installation
  • Related content

PagerDuty Datasource for Grafana

Annotations-only datasource for PagerDuty events.

To configure:

Create a v2 PagerDuty API key, following the instructions here

Paste the key into the API Key configuration field for the PagerDuty datasource.

To use:

Add an annotation to a dashboard normally, selecting the PagerDuty datasource. There are a few filters available to limit the number of results, or the scope.

Filter by service ID (optional)

  • A PagerDuty service represents something you monitor (like a web service, email service, or database service). It is a container for related incidents that associates them with escalation policies. Documentation is available here

Filter by urgency (optional)

  • Urgencies is a feature which allows you to customize how your team is notified based on the criticality of an incident: incidents can be either high-urgency (requires immediate attention) or low-urgency (it can wait).

Filter by status (optional)

  • PagerDuty incidents can either be triggered, acknowledged, or resolved. Please see the PagerDuty documentation for further clarification.

Installing Pagerduty on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Data Source

Use the grafana-cli tool to install Pagerduty from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Configure the Data Source

Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.

Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.

To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.