Configurare i collegamenti dati

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

Per le aree di lavoro Grafana che supportano la versione 10.x di Grafana, vedere. Funzionamento nella versione 10 di Grafana

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

È possibile utilizzare variabili di collegamento dati o collegamenti dati per creare collegamenti tra i pannelli.

Variabili di collegamento dati

È possibile utilizzare le variabili nei collegamenti dati per fare riferimento a campi, etichette e valori delle serie. Per ulteriori informazioni sui collegamenti dati, consultaCollegamenti dati.

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

Nota

Queste variabili sono cambiate nella versione 6.4, quindi se hai una versione precedente di Grafana, usa il selettore di versione per selezionare i documenti per una versione precedente di Grafana.

Puoi anche usare variabili modello negli URL dei tuoi link dati, vedi. Aggiungere e gestire le variabili del dashboard

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.? da=ora-6h&a=adesso)

• $__from e $__to - Per ulteriori informazioni, vedi. Variabili globali

Variabili di serie

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

• __series.name - nome della serie all'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. <LABEL>Se l'etichetta contiene punti, usa la sintassi __field.labels [» «].

Variabili di valore

Le variabili specifiche del valore sono disponibili nello spazio dei nomi __value:

• __value.time - il timestamp del valore (epoca Unix ms) rispetto 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

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 nella dashboard corrente che desideri utilizzare.

Stato variabile	Risultato nell'URL creato
ha selezionato un valore	var-myvar=valore1
valori multipli selezionati	var-myvar=valore1&var-myvar=valore2
selezionato Tutto	var-myvar=Tutti

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

Collegamenti dati

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, è possibile aggiungere un collegamento dati a uno o due di essi.

Il link stesso è accessibile in diversi modi a seconda della visualizzazione. Per il grafico è necessario fare clic su un punto o una linea dati, per un pannello come Stat, Gauge o Bar Gauge è possibile fare clic in un punto qualsiasi della visualizzazione per aprire il menu contestuale.

Puoi utilizzare le variabili nei link dati per indirizzare le persone a una dashboard dettagliata con filtri di dati conservati. Ad esempio, è possibile utilizzare le variabili per specificare un intervallo di tempo, una serie e una selezione di variabili. Per ulteriori informazioni, consulta Variabili di collegamento dati.

Suggerimenti Typeahead

Quando crei o aggiorni un collegamento dati, premi Cmd+Spazio o Ctrl+Spazio sulla tastiera per aprire i suggerimenti di digitazione automatica per aggiungere più facilmente variabili all'URL.

Aggiungi un collegamento dati

1. Posiziona il cursore sul pannello a cui desideri aggiungere un collegamento, quindi premi e. Oppure fai clic sulla freccia a discesa accanto al titolo del pannello, quindi fai clic su Modifica.

2. Nella scheda Campo, scorri verso il basso fino alla sezione Collegamenti dati.

3. Espandi Collegamenti dati, quindi fai clic su Aggiungi collegamento.

4. Inserisci un titolo. Il titolo è un'etichetta leggibile dall'uomo per il collegamento che verrà visualizzato nell'interfaccia utente.

5. Inserisci l'URL a cui desideri collegarti.

   Puoi anche aggiungere una delle variabili del modello definite nella dashboard. Fai clic nel campo URL e quindi digita $ o premi Ctrl+Space o Cmd+Space per visualizzare un elenco di variabili disponibili. Aggiungendo variabili modello al link del pannello, il link rimanda l'utente al contesto giusto, con le variabili pertinenti già impostate. Per ulteriori informazioni, consulta Variabili di collegamento dati.

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

7. Fai clic su Salva per salvare le modifiche e chiudere la finestra.

8. Fai clic su Salva in alto a destra per salvare le modifiche nella dashboard.

Aggiorna un collegamento dati

1. Nella scheda Campo, trova il link a cui desideri apportare modifiche.

2. Fai clic sull'icona Modifica (matita) per aprire la finestra Modifica link.

3. Apporta le modifiche necessarie:

4. Fai clic su Salva per salvare le modifiche e chiudere la finestra.

5. Fai clic su Salva in alto a destra per salvare le modifiche nella dashboard.

Eliminare un collegamento dati

1. Nella scheda Campo, trova il link che desideri eliminare.

2. Fai clic sull'icona X accanto al link che desideri eliminare.

3. Fai clic su Salva in alto a destra per salvare le modifiche nella dashboard.