Skip to content

ServiceNow/itom-grafana-datasource

 
 

Repository files navigation

ServiceNow Grafana Plugin

drawing drawing

Latest Version Number

Table of Content

Change Notes

Breaking changes are distinguised by this symbol: 🔧

  • V1.1.3
    • Filled some of the datasource config values by default
    • Cache timeout is now fully controlled by the user
      • Global cache time is set in the datasource config and defaults to 60s
      • The global cache time can also be overrode in each panel for greater control over your cache
  • V1.1.2
    • Added ability to fire UI Actions
    • Datasource config settings modified (You will see updated instructions inside the datasource) 🔧
  • v1.1.1
    • Added limit field to generic variable query
    • Added global image variable. Set it's value inside the datasource settings
  • v1.1.0
    • Fixed bug in Sysparam Query field where AND/OR selection had no default 🔧

Supported ServiceNow Versions

  • Rome
  • Quebec
  • Paris

Datasource Instructions

  1. Enter the url of your ServiceNow instance with the api included
    Ex. https://<instance_name>.service-now.com/api/snc/grafana_api
  2. Toggle on the 'Basic Auth' & 'With Credentials' switches
  3. Enter your username and password for the ServiceNow instance
  4. Click on 'Save & Test' at the bottom to ensure a working connection

Variables

There are 2 important fields when creating a new dashboard variable. Namespace and Query

Namespace Query Description Query Query Fields Field Seperator
metric_names Retrieves a list of all metrics for the given ci(s) a20ce336db42b010d41e9fd2ca96199e
  1. One or many CI SysID R
,
golden_metric_names Retrieves a list of KPIs for the given ci(s) a20ce336db42b010d41e9fd2ca96199e
  1. One or many CI SysID R
,
custom_kpis Retrieves a list of Preset KPIs for the given ci(s). Results will vary based on CI Class a20ce336db42b010d41e9fd2ca96199e
  1. One or many CI SysID R
,
generic Create your own custom list based on the table, columns, and sysparam provided. The first column field will determine the display value users see and the second column is the actual value used in the list. If you need to force a column to be read as display value add suffix :d and for actual value add suffix :v. Learn more about Display vs Actual values here
FYI dotwalking will only work if you use the :d suffix
em_alert||group_source||group_source||state!=Closed||1000
  1. Table Name R
  2. Display Table Column R
  3. Value Table Column R
  4. Sysparam Query
  5. Limit
||
nested_cis Retrieves the nested/related CIs that are shown in the topology panel. Values should match your topology query for best results. 4577fd32db1627002ef1400e0b961921||1||1||parent.sys_class_nameNOT INsn_agent_cmdb_ci_agent
  1. CI SysID R
  2. Parent Depth R
  3. Child Depth R
  4. Sysparam Query
||
nested_classes Retrieves the Classes of all nested/related CIs that are shown in the topology panel. Values should match your topology query for best results. 4577fd32db1627002ef1400e0b961921||1||1||parent.sys_class_nameNOT INsn_agent_cmdb_ci_agent
  1. CI SysID R
  2. Parent Depth R
  3. Child Depth R
  4. Sysparam Query
||

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 90.8%
  • Shell 7.4%
  • Batchfile 1.5%
  • Other 0.3%