Documentation Plugins Atlassian Statuspage

Atlassian Statuspage data source

The Atlassian Statuspage data source plugin lets you query the operational status of your page, incidents, and scheduled maintenances from your Atlassian Statuspage.

Supported features

Requirements

This plugin has the following requirements:

• A working Atlassian Statuspage with a public status page.
• A Grafana Cloud Pro or Advanced plan or an activated on-prem Grafana Enterprise license. Contracted Cloud customers should refer to their agreement.

Install the data source

To install the data source, refer to Installation.

Configure the data source in Grafana

Add a data source by filling in the following information.

Connection

The connection requires only the URL of your Atlassian Statuspage.

URL

This is your Atlassian Statuspage URL. Include the protocol (for example, https://) and remove the trailing /. Refer to the following examples.

Authentication

Authentication isn’t required for this data source. Any public Atlassian Statuspage can be used.

Configure the data source with provisioning

You can configure data sources using configuration files with Grafana’s provisioning system. To read about how it works, refer to Provisioning Grafana data sources.

Because authentication isn’t required, the only setting you provision is the url variable. Here is a provisioning example for this data source:

YAML Copy

apiVersion: 1
datasources:
  - name: Atlassian Statuspage
    type: grafana-atlassianstatuspage-datasource
    jsonData:
      variables:
        url: <YOUR_ATLASSIAN_STATUSPAGE_URL>

Query the data source

The plugin lets you query Summary, Status, Components, Unresolved incidents, All incidents, Upcoming scheduled maintenances, Active scheduled maintenances, and All scheduled maintenances. Each query type maps to an endpoint of the Atlassian Statuspage public API.

Status

The status query shows the operational status of your page.

Summary

The summary query gets the status rollup for the whole page. This endpoint includes an indicator - one of none, minor, major, or critical - as well as a human description of the blended component status. Examples of the blended status include “All Systems Operational”, “Partial System Outage”, and “Major Service Outage”.

Components

The components query gets the components for the page. Each component is listed along with its status - one of operational, degraded_performance, partial_outage, or major_outage.

Unresolved incidents

The unresolved incidents query gets a list of any unresolved incidents. This endpoint only returns incidents in the Investigating, Identified, or Monitoring state.

All incidents

The all incidents query gets a list of the 50 most recent incidents. This includes all unresolved incidents, as well as those in the Resolved and Postmortem state.

Upcoming scheduled maintenances

The upcoming scheduled maintenances query gets a list of any upcoming maintenances. This endpoint only returns scheduled maintenances still in the Scheduled state.

Active scheduled maintenances

The active scheduled maintenances query gets a list of any active maintenances. This endpoint only returns scheduled maintenances in the In Progress or Verifying state.

All scheduled maintenances

The all scheduled maintenances query gets a list of the 50 most recent scheduled maintenances. This includes the scheduled maintenances returned by the upcoming and active queries, as well as those in the Completed state.

Annotations

You can use annotations to visualize the relation between Atlassian Statuspage data and other data on your dashboards. For general information on how to use annotations, refer to the Annotations documentation.

Pre-built dashboards

The plugin includes a pre-built Atlassian Statuspage dashboard that you can import to get started quickly. The dashboard includes panels for the current page status and summary, as well as tables for incidents (all and unresolved) and scheduled maintenances (all, active, and upcoming).

To import the dashboard:

1. Click Connections in the left-side menu.
2. Select your Atlassian Statuspage data source.
3. Select the Dashboards tab.
4. Find the Atlassian Statuspage dashboard and click Import.

After import, select your Atlassian Statuspage data source for each input prompt to populate the panels.

Additional features

After configuring the data source, you can:

• Add Transformations to manipulate query results.
• Use Explore to query data without building a dashboard.

Known limitations

This data source has the following known limitations:

• The All incidents and All scheduled maintenances queries return a maximum of 50 of the most recent records.
• The plugin doesn’t support alerting.

Troubleshooting

This section describes common issues you might encounter when configuring or using the Atlassian Statuspage data source.

Connection errors

These errors occur when Grafana can’t reach your Atlassian Statuspage.

Symptoms:

• Save & test fails.
• Queries fail with network or connection errors.

Possible causes and solutions:

Save & test fails or returns an unexpected response

The data source health check queries the Statuspage summary endpoint and expects a JSON response.

Symptoms:

• Save & test fails even though the URL opens in a browser.
• Queries return parsing errors instead of data.

Possible causes and solutions:

No data or empty results

Some query types only return data when matching items exist.

Symptoms:

• A query runs without error but returns no rows.

Possible causes and solutions:

Get additional help

If you’ve tried these solutions and still encounter issues:

1. Check the Grafana community forums for similar issues.
2. Review the Atlassian Statuspage API documentation to confirm the expected response for an endpoint.
3. Contact Grafana Support if you’re an Enterprise, Cloud Pro, or Cloud Contracted user.
4. When reporting issues, include:
   • Grafana version
   • Plugin version
   • Error messages (redact sensitive information)
   • Steps to reproduce
   • The status page URL, if it’s public

Plugin updates

Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well.

Related resources

• Atlassian Statuspage API documentation
• Grafana community forum