Connect a una fonte di ServiceNow dati - Grafana gestito da Amazon
FunzionalitàConfigurazioneUtilizzoAvvisoAnnotazioniDomande frequenti

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect a una fonte di ServiceNow dati

Questa è la fonte di ServiceNow dati utilizzata per connettersi alle ServiceNow istanze.

Nota

Questa fonte di dati è solo per Grafana Enterprise. Per ulteriori informazioni, consulta Gestisci l'accesso ai plugin Enterprise.

Inoltre, nelle aree di lavoro che supportano la versione 9 o successiva, questa fonte di dati potrebbe richiedere l'installazione del plug-in appropriato. Per ulteriori informazioni, consulta Estendi il tuo spazio di lavoro con i plugin.

Funzionalità

  • Query

    • Interrogazioni Stat API

    • Tabella delle interrogazioni API

      • Incidenti, modifiche e qualsiasi altra tabella

  • Avvisi

  • Annotazioni (funzionalità beta)

  • Variabili del modello

Configurazione

Seleziona le fonti di dati nel pannello di sinistra di Grafana.

Seleziona Aggiungi origine dati:

Entra servicenow per trovare il plug-in della fonte di dati:

Inserisci ServiceNow l'URL:

Seleziona Salva ed esegui test. Dovresti vedere un messaggio verde con "ServiceNow Connessione OK».

Dashboard di esempio

I dashboard predefiniti sono inclusi nel plug-in e possono essere importati tramite la pagina di configurazione dell'origine dati, nella scheda dashboard.

Utilizzo

Esistono due modi per restituire i dati nell'editor di query.

  • Tabella API

  • API aggregata

Attualmente gli utenti possono scegliere tra l'interrogazione di tabelle predefinite, come le seguenti:

  • Modifiche

  • Incidenti

Oppure, a partire da un elenco di v1.4.0 tabelle e campi basato su API utilizzando l'opzione Altro (tabella personalizzata). Questa opzione ti consentirà di interrogare i dati presenti in qualsiasi tabella disponibile per l'utente utilizzato per configurare l'origine ServiceNow dati.

L'opzione Tabella personalizzata dovrebbe supportare tutte le stesse funzionalità degli elenchi di tabelle predefiniti.

Interrogazioni TableAPI

TableAPI restituisce dati adatti alla visualizzazione in un pannello tabellare. Consente una selezione ordinata di campi da visualizzare più opzioni di filtro. L'editor di query fornisce anche un campo per limitare il numero di righe restituite da una query.

Esempio di pannello di tabella che mostra i risultati della query precedente.

Mostra

La riga Mostra fornisce un selettore per la visualizzazione di un campo. È inoltre possibile specificare più campi. I campi verranno restituiti nell'ordine esatto specificato.

Valori di visualizzazione

Il flag Visualizza valori farà sì che la query restituisca valori intuitivi, o valori di visualizzazione, anziché valori numerici.

Ad esempio, verrebbe visualizzata solo una gravità pari a 1 senza questo flag. 1 Se il flag è abilitato, il valore visualizzato sarà1 - High.

Secondo la documentazione dell'ServiceNow API, ciò può avere un impatto negativo sulle prestazioni.

Nota

[...] la specificazione del valore di visualizzazione può causare problemi di prestazioni poiché non viene letto direttamente dal database e potrebbe includere il riferimento ad altri campi e record.

Filtri (generali)

La riga Filtri offre la possibilità di restringere le righe visualizzate in base a più criteri di campo e valore.

Tutti i filtri vengono combinati con un'operazione AND o OR.

I seguenti campi sono disponibili quando non si utilizza una tabella personalizzata (questo elenco verrà ampliato in futuro).

Active
Asset
Group
Assigned To
Escalation
Issue Number
Description
Priority
State
Type
Change Risk
Change State
Start Date
End Date
On Hold

Quando si seleziona una tabella personalizzata, i campi vengono compilati automaticamente dall'API Service Now.

Filtri di data
Campo orario Operatori Valore
Aperto a A o prima di oggi Non oggi prima o prima dopo o dopo timestamp JavaScript: gs.daysago (30)
Attività dovuta
Chiuso alle
Data di scadenza
Inizio previsto
Orario di riapertura
Risolto a
Fine del lavoro
Inizio del lavoro
Ignora il tempo

Per ulteriori valori di data, consulta: https://developer.servicenow.com/app.do #! /api_doc? v=newyork&id=r_sgsys-dategenerate_s_s

Operatori (generali, basati su stringhe)

  • Inizia con

  • Termina con (Termina con)

  • Piace

  • Non mi piace

  • Equals

  • Non è uguale

  • Is Empty (È vuoto)

Operatori (basati sul tempo)

  • Oggi

  • Non oggi

  • Prima

  • In o prima

  • Dopo

  • In o dopo

Valori

La selezione del valore dipende dal tipo di filtro selezionato.

  • I filtri booleani hanno le opzioni True/False

  • I filtri di testo consentiranno di digitare qualsiasi valore

  • Escalation, Priority ha un set fisso di valori numerici

Ordina per

La riga Ordina per offre la possibilità di restringere le righe visualizzate in base a più criteri di campo e valore.

Tutti i filtri sono combinati con un'operazione AND. Verrà aggiunto il supporto per altri operatori.

Limite

È possibile specificare un limite di riga per evitare la restituzione di troppi dati. Il valore predefinito è 25.

Campo orario

Time FieldQuesto è ciò che trasforma i dati richiesti in una serie temporale. I dati gestiti come serie temporali significa che i valori nel «campo temporale» selezionato che non rientrano nell'intervallo temporale della dashboard o del pannello non verranno visualizzati.

Il campo orario predefinito utilizzato è «Aperto a», ma può essere modificato in qualsiasi campo disponibile che contenga un valore temporale.

Viene fornito un valore speciale «Ignora ora» per consentire i risultati «fino ad ora» e anche per consentire ai filtri di controllare quali dati vengono visualizzati.

Interrogazioni API aggregate (Stats)

L'AggregateAPI restituirà sempre le metriche, con le seguenti aggregazioni: avg, min, max, sum. Il filtraggio è disponibile anche per restringere le query.

Mostra

La riga Mostra fornisce un selettore per la visualizzazione di una metrica. È inoltre possibile specificare più metriche.

Filtri (generali)

I filtri aggregati offrono la possibilità di restringere le metriche visualizzate in base a criteri di campo e valore, in modo simile all'opzione tabella.

Tutti i filtri sono combinati con un'operazione AND. Verrà aggiunto il supporto per altri operatori.

Le opzioni del filtro Stat sono le stesse di TableAPI.

Aggregazione

Esistono quattro tipi di aggregazioni metriche, più un «conteggio»:

  • Media

  • Minimo

  • Massimo

  • Somma

  • Conteggio: restituisce il «numero» di metriche restituite da una query

Raggruppa per

Questo selettore offre la possibilità di suddividere le metriche in aggregati minori. Il raggruppamento per «priorità» restituirebbe le metriche con un «tag» di priorità e i valori univoci separati.

Modellazione

Invece di codificare i nomi nelle query, puoi utilizzare delle variabili al loro posto. Le variabili vengono visualizzate come caselle di selezione a discesa nella parte superiore della dashboard. Puoi utilizzare queste caselle a discesa per modificare i dati visualizzati sulla dashboard.

Vedi l'esempio nella sezione Query Variable su come aggiungere una variabile di query e fai riferimento a quella con un valore Template.

Variabile di query

Se aggiungi una variabile modello di questo tipoQuery, puoi scrivere una query in grado di restituire elementi come nomi di categorie, nomi di chiavi o valori chiave visualizzati come una casella di selezione a discesa.

Ad esempio, è possibile avere una variabile che contiene tutti i valori per categories specificando una query come questa nell'impostazione Query della variabile di modello.

Quando si sceglie l'impostazione Query, viene visualizzata una sezione Filtro, che consente di scegliere un tipo e un campo. Attualmente, Type è limitato a Incidenti e Modifiche. Quando si seleziona un tipo, viene fornito un elenco di campi applicabili a quel tipo. Una volta selezionati un tipo e un campo, nella parte inferiore verrà visualizzata un'anteprima dei valori che mostra le opzioni disponibili per quel tipo/campo. Questi valori verranno visualizzati in un elenco a discesa sulla dashboard, che puoi utilizzare insieme a Templating per filtrare i dati nei pannelli della dashboard.

Ad esempio, se aggiungi una variabile denominata categoria, quindi seleziona Tipo = Incidenti e Campo = Categoria, vedrai un elenco di opzioni per Categoria. Se poi aggiungi un filtro a un pannello e selezioni Categoria è uguale a $ {category}, i dati del pannello mostreranno solo i dati per quella categoria selezionata dall'elenco a discesa della Dashboard.

Importa la dashboard Incidenti per categoria per vedere un esempio.

Utilizzo delle variabili nelle interrogazioni

Esistono due sintassi:

$<varname>Esempio con una variabile modello denominatahostname:

[[varname]]Esempio con una variabile modello denominatahostname:

Avviso

Sono supportati gli avvisi Grafana standard. Qualsiasi interrogazione definita in un pannello grafico può essere utilizzata per generare avvisi.

Di seguito sono riportati un esempio di interrogazione e di avviso. Questa query restituirà un grafico di tutti gli incidenti critici aperti ad alta priorità:

Questo avviso verrà avviato quando si verificano più di cinque incidenti critici ad alta priorità aperti:

Il test della regola di avviso mostrerà l'output della regola di avviso e la selezione della cronologia dello stato mostrerà la transizione dell'avviso da ok a pendente a avviso.

La visualizzazione del grafico mostrerà una linea verticale e l'icona a forma di cuore in alto diventerà arancione mentre l'avviso è in sospeso.

Una volta soddisfatti i criteri per gli avvisi, la regola diventa rossa.

Nella vista grafica, apparirà la linea verticale rossa e l'icona a forma di cuore in alto diventerà rossa.

Scrittura di incidenti per gli avvisi

Funzionalità beta

  • Configura un canale di notifica per la tua fonte di ServiceNow dati.

Questo configurerà un canale di notifica Grafana che utilizza l'utente configurato per creare incidenti sull' ServiceNow istanza per questa fonte di dati.

Questa azione richiede che l'utente dell'origine ServiceNow dati disponga delle autorizzazioni per la scrittura degli incidenti.

Utilizzo di un proxy HTTP

Quando si utilizza un proxy HTTP, Amazon Managed Grafana avrà bisogno delle seguenti variabili di ambiente impostate sulla posizione del proxy:

  • HTTP_PROXY (o http_proxy)

    • Percorso completo - http://host:port

    • o semplicemente: host:port

  • HTTPS_PROXY(oppurehttps_proxy):

    • Percorso completo - https://host:port

    • o semplicemente: host:port

Annotazioni

Le annotazioni Grafana sono una funzionalità beta a partire da questa fonte v1.4.0 di dati. Le annotazioni ti danno la possibilità di sovrapporre gli eventi ai grafici.

La query Annotations supporta le stesse opzioni dell'editor di query standard con alcune piccole differenze:

  • È selezionabile solo una colonna «Mostra». È probabile che questo problema verrà risolto con future migliorie.

  • Il campo orario è obbligatorio.

Domande frequenti

Cosa succede se non abbiamo il plugin ITSM Roles?

È necessario l'accesso dell'amministratore per eseguire le seguenti azioni

Opzione 1: concedere le autorizzazioni di amministratore utente Grafana per consentire l'accesso a tutte le tabelle.

Opzione 2: crea un ruolo e applica gli ACL a tutte le tabelle a cui Grafana deve accedere.

È necessario l'accesso come amministratore per eseguire le seguenti azioni.

  1. L'amministratore che ha effettuato l'accesso deve elevare l'accesso a security_admin.

    1. Nel riquadro di navigazione in alto a destra, scegli l'icona del profilo. L'icona del profilo ha un indicatore cursore a discesa.

    2. Dall'elenco a discesa, scegli Elevate Roles.

    3. Dalla modalità mostrata, seleziona la casella di controllo security_admin.

    4. Scegli OK.

  2. Crea un nuovo ruolo con la convenzione di denominazione che desideri.

    1. Vai alla sezione dei ruoli nella barra di navigazione a sinistra Sicurezza del sistema => Utenti e gruppi => Ruoli

    2. Scegli Nuovo in alto.

    3. Inserisci un nome per il ruolo e una descrizione pertinente.

    4. Scegli Invia.

  3. Crea un nuovo utente o modifica un utente esistente con i ruoli necessari.

    1. Il ruolo che crei nella Fase 2

    2. personalize_dictionary

    3. personalizza le scelte

    4. cmdb_read (questo garantirà l'accesso in lettura a tutte le tabelle cmdb)

  4. Crea gli ACL delle tabelle per le tabelle e i campi richiesti.

    1. Create un ACL per la tabella sys_db_object.

      1. Nella seconda colonna dell'intestazione di ricerca Name, immettete e premete Invio. sys_db_object

      2. Il risultato filtrato dovrebbe mostrare Tabella. Scegli Tabella per accedere al record.

      3. Nella sezione della scheda, scegli Controlli.

      4. Nella parte inferiore della pagina, assicurati che Access Controls sia la scheda selezionata.

      5. Scegliete Nuovo per creare un nuovo ACL.

      6. Modificate la selezione dell'operazione da leggere.

      7. Nella sezione Ruolo richiesto nella parte inferiore dello schermo, scegliete (doppio clic) Inserisci nuova riga e cercate il ruolo che avete creato.

      8. Dopo aver selezionato il ruolo che hai creato, scegli il segno di spunta verde.

      9. Scegli Invia nella parte inferiore dello schermo per creare l'ACL, quindi scegli Continua quando appare la modalità modale.

  5. Crea ACL per campi sys_db_object specifici. I seguenti passaggi devono essere ripetuti per ciascuno dei seguenti campi: Name, Label, Display Name e Extends table.

    1. Mentre siete ancora nella visualizzazione dei record della tabella per sys_db_object, selezionate la scheda Colonne nel gruppo di schede più vicino alla parte superiore dello schermo.

    2. Individuate il nome del campo e selezionatelo.

    3. Nella sezione inferiore della scheda, scegli Nuovo nella scheda Controlli di accesso.

    4. Cambia l'operazione da leggere

    5. Scegli (doppio clic) il testo di inserimento di una riga nella tabella «Ruolo richiesto» in basso.

    6. Cerca il ruolo che hai creato e scegli il segno di spunta verde.

    7. Scegli Invia.

    8. Assicurati di aver ripetuto questi passaggi per tutti i campi obbligatori: Nome, Etichetta, Nome visualizzato e Tabella delle estensioni.

  6. Ripeti i passaggi dalla 4.1 su Change, Incident e qualsiasi altra tabella non CMDB che desideri interrogare da Grafana. Non ripetete i passaggi della versione 4.2; quel passaggio è richiesto solo per sys_db_object.