Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Configurebreadcrumb arrow Integrationsbreadcrumb arrow Integration referencebreadcrumb arrow Incident integrationsbreadcrumb arrow StatusPage
Grafana Cloud

StatusPage integration for Grafana IRM

The StatusPage integration for Grafana IRM helps you provide consistent and reliable updates to your customers during incidents. By linking your StatusPage.io account, you can automatically create StatusPage incidents when you declare incidents in IRM, ensuring timely communication with your users.

Key benefits

  • Automatically creates StatusPage incidents when IRM incidents are declared
  • Maintains consistent messaging across internal and external communications
  • Reduces manual work during critical incidents
  • Helps mitigate the volume of customer support inquiries during outages
  • Streamlines post-incident communications

Before you begin

To use the StatusPage integration, you need:

  • A StatusPage.io account with administrative access
  • Your StatusPage Page ID (found in your StatusPage URL: https://manage.statuspage.io/pages/<PAGE_ID>)
  • A StatusPage API key with appropriate permissions
  • Editor or Admin permissions in Grafana IRM

Configure the StatusPage integration

To install and configure the StatusPage integration:

  1. In Grafana, navigate to Alerts & IRM > IRM > Integrations.
  2. Select Apps.
  3. Locate and click StatusPage.
  4. Click Install Integration.
  5. Enter your StatusPage Page ID and API key.
  6. Click Save.

Configure event triggers

After installation, configure when the integration creates a StatusPage incident.

  1. From the StatusPage integration settings, click + Run when an event fires under the Create an incident action.
  2. From the Run this action when dropdown, select an event trigger.
  3. If you have the Grafana Cloud app for Slack installed, optionally enable Run this action on private incidents to include private incidents.
  4. Click Save.

The following event triggers are available:

  • Incident is declared: Creates a StatusPage incident whenever a new incident is declared in IRM.
  • Incident changes: Creates a StatusPage incident whenever an existing incident is updated.
  • Manually triggered through the UI: Allows you to manually trigger StatusPage incident creation from the incident details view.
  • Incident matches a filter: Creates a StatusPage incident only when an incident matches a filter expression using incident query syntax. When selected, an additional Filter field appears for you to enter the filter expression.

For example, to create a StatusPage incident only for critical severity incidents, select Incident matches a filter and enter the following filter:

severity:critical

Using the integration

Once configured, the integration:

  • Automatically creates a StatusPage incident when an incident is declared in IRM
  • Uses the IRM incident title as the StatusPage incident name
  • Links the StatusPage incident to your IRM incident for reference
  • Updates the StatusPage incident title when the IRM incident title changes

You can also click the StatusPage link in the incident details to open and update the incident directly in StatusPage.

Limitations

The native StatusPage integration provides basic incident creation functionality. The integration does not support:

  • Selecting specific StatusPage components to associate with the incident
  • Setting incident visibility or impact level
  • Customizing the initial incident status or message body

For more granular control over StatusPage incident creation, including component selection and impact settings, use outgoing webhooks to call the StatusPage API directly.

Next steps