Configurare i collegamenti dati

Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.

Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. Lavorare nella versione 9 di Grafana

Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. Funzionamento in Grafana versione 8

I collegamenti dati consentono di fornire un contesto più granulare ai collegamenti. È possibile creare collegamenti che includono il nome della serie o anche il valore sotto il cursore. Ad esempio, se la visualizzazione mostra quattro server, puoi aggiungere un datalink a uno o due di essi. È inoltre possibile collegare i pannelli utilizzando collegamenti dati.

Il link stesso è accessibile in diversi modi a seconda della visualizzazione. Per la visualizzazione delle serie temporali, ad esempio, si sceglie un punto o una linea di dati. Per visualizzazioni di grandi aree, come stat, gauge o bar gauge, puoi scegliere un punto qualsiasi della visualizzazione per aprire il menu contestuale.

Se nella visualizzazione è presente un solo collegamento dati, scegliendo un punto qualsiasi della visualizzazione si apre il collegamento anziché il menu contestuale.

Visualizzazioni supportate

• Grafico a barre

• Manometro a barra

• Candelabro

• Canvas

• Gauge

• Geomappa

• Mappa termica

• Istogramma

• Grafico a torta

• Stat

• Cronologia dello stato

• Cronologia dello stato

• Tabella

• Serie temporali

• Tendenza

Variabili di collegamento dati

Le variabili nei link dati consentono di indirizzare le persone a una dashboard dettagliata con filtri di dati conservati. Ad esempio, è possibile utilizzare una variabile per specificare un'etichetta, un intervallo di tempo, una serie o una selezione di variabili.

Per visualizzare un elenco di variabili disponibili, digita $ nel campo URL del collegamento dati.

Puoi anche utilizzare variabili modello negli URL dei link dati, vediVariables.

Intervallo di tempo: variabili del pannello

Queste variabili consentono di includere l'intervallo di tempo corrente nell'URL del collegamento dati.

• __url_time_range— intervallo di tempo della dashboard corrente (ad es.?from=now-6h&to=now)

• $__from – Per ulteriori informazioni, consulta Variabili globali.

• $__to – Per ulteriori informazioni, consulta Variabili globali.

Variabili di serie

Le variabili specifiche della serie sono disponibili nello __series spazio dei nomi:

• __series.name— nome della serie nell'URL

Variabili di campo

Le variabili specifiche del campo sono disponibili nello spazio dei nomi__field:

• __field.name— il nome del campo

• __field.labels.<LABEL>— il valore dell'etichetta rispetto all'URL. Se l'etichetta contiene punti, usa la __field.labels["<LABEL>"] sintassi.

Variabili di valore

Le variabili specifiche del valore sono disponibili nello spazio dei nomi__value:

• __value.time— data e ora del valore (epoca Unix ms) all'URL (ad es.) ?time=1560268814105

• __value.raw— valore grezzo

• __value.numeric— rappresentazione numerica di un valore

• __value.text— rappresentazione testuale di un valore

• __value.calc— nome del calcolo se il valore è il risultato del calcolo

L'utilizzo di una variabile con un valore specifico nei collegamenti dati può mostrare risultati diversi a seconda dell'opzione impostata della modalità Tooltip.

Variabili di dati

Per accedere ai valori di altri campi usa:

• __data.fields[i]— Valore del campo i (sulla stessa riga).

• __data.fields["NameOfField"]— Valore del campo che utilizza il nome anziché l'indice.

• __data.fields[i].labels.cluster— Accedere alle etichette di un altro campo.

Variabili del modello

Quando ti colleghi a un'altra dashboard che utilizza variabili modello, seleziona i valori delle variabili per chiunque faccia clic sul link.

${var-myvar:queryparam}— dove var-myvar è il nome della variabile modello che corrisponde a quella della dashboard corrente che desideri utilizzare.

Stato variabile	Risultato nell'URL creato
ha selezionato un valore	var-myvar=value1
valori multipli selezionati	var-myvar=value1&var-myvar=value2
selezionato All	var-myvar=All

Se desideri aggiungere tutte le variabili della dashboard corrente all'URL, usa${__all_variables}.

Aggiungere un collegamento dati

Puoi aggiungere collegamenti dati ai tuoi pannelli.

1. Passa al pannello a cui desideri aggiungere il collegamento dati.

2. Passa il mouse sul pannello per visualizzare l'icona del menu nell'angolo in alto a destra.

3. Dal menu, scegliete Modifica per aprire l'editor del pannello.

4. Nel riquadro di modifica del pannello, scorri verso il basso fino alla sezione Collegamenti dati ed espandila.

5. Scegli Aggiungi link.

6. Nella finestra di dialogo che si apre, inserisci un titolo. Si tratta di un'etichetta leggibile dall'uomo per il collegamento, che verrà visualizzata nell'interfaccia utente.

7. Inserisci l'URL o la variabile a cui desideri collegarti.

   Per aggiungere una variabile di collegamento dati, seleziona il campo URL, quindi immetti $ o premi Ctrl+Spazio o Cmd+Spazio per visualizzare un elenco di variabili disponibili.

8. Se desideri che il link si apra in una nuova scheda, seleziona Apri in una nuova scheda.

9. Scegli Salva per salvare le modifiche e chiudere la finestra di dialogo.

10. Salva le modifiche nella dashboard.