ServiceNow data source
The ServiceNow data source allows you to query and visualize data from ServiceNow tables within Grafana. Use it to build dashboards for incident management, change tracking, and operational visibility using your ServiceNow instance data.
Note
The ServiceNow data source is an Enterprise plugin. It’s available with Grafana Cloud (Pro and Advanced tiers) and Grafana Enterprise. For installation instructions, refer to Install Grafana Enterprise plugins.
Supported features
The following table lists the features available with the ServiceNow data source:
Get started
The following documents help you set up and use the ServiceNow data source:
- Configure the ServiceNow data source
- ServiceNow query editor
- Template variables
- Annotate dashboards
- Set up alerting
- Troubleshoot ServiceNow
Additional features
After configuring the data source, you can also:
- Use Explore to query data without building a dashboard.
- Add transformations to manipulate query results.
- Annotate dashboards with ServiceNow events like incidents and change requests.
- Set up alerting rules with ServiceNow queries.
- Create template variables for dynamic, reusable dashboards.
Pre-built dashboards
The ServiceNow data source includes the following pre-built dashboards:
- Incident Overview – Displays open incidents grouped by priority and category.
- Change Overview – Displays recent change requests and their status.
To import a pre-built dashboard:
- Navigate to the ServiceNow data source configuration page.
- Click the Dashboards tab.
- Click Import next to the dashboard you want to use.
Version compatibility
The following version requirements apply to this plugin:
The current version of the plugin has been tested against the Washington DC and Xanadu releases of ServiceNow. Older ServiceNow releases may work but aren’t validated.
Known limitations
The following limitations apply to the ServiceNow data source:
- Filters in the query editor don’t support fields of reference type. You can still query reference fields in the Show Fields selector and use dot notation to access sub-fields, but you can’t filter on them directly.
- Field references expand to one level deep only. Nested references beyond the first level can’t be expanded in the field selector.
- When the Use Sys Tables? option is enabled and the ServiceNow user has access to a large number of tables, you may experience slower load times in the query editor. Grant the user access only to the tables it needs.
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.
Note
Plugins are automatically updated in Grafana Cloud.
