Tipi di variabile

È possibile scegliere tra diversi tipi di variabili.

Variabili a valore statico

È possibile definire manualmente un elenco fisso di valori di variabili, come un numero o una stringa di numeri separati da una virgola. Ad esempio, se si hanno nomi di paesi che non cambiano mai, è preferibile crearli come variabile a valore statico piuttosto che come variabile di query dell'origine dati.

Variabile di interrogazione

I valori delle variabili vengono recuperati da una query di log o da una fonte di dati metrici. Ad esempio, una variabile di query può generare un elenco di nomi di server, ID di sensori o centri dati, aggiornando dinamicamente i valori recuperando le opzioni tramite una query di origine dati. Le variabili di query sono utili quando si gestiscono più istanze di origine dati, soprattutto in ambienti diversi.

Definizione di variabili per cruscotti personalizzati

1. Accedere al proprio account IBM Cloud.

2. Accedere all'istanza di IBM Cloud Logs

3. Fare clic sull'icona Dashboard Dashboard > Dashboard personalizzati.

4. In un cruscotto nuovo o esistente, fare clic sull'icona Variabile gestita { }.

5. Fare clic su + Variabile.

6. Per tutti i tipi di variabili, configurare i seguenti campi:

   • Tipo di variabile.

   • Nome della variabile. Il testo inserito in questo campo determina il modo in cui il nome della variabile appare nella query, ad esempio {{ podvalues }}. Nel nome della variabile non sono ammesse lettere maiuscole o spazi.

   • Nome visualizzato (opzionale). Il testo inserito in questo campo appare nella selezione come parte dell'elenco a discesa, ad esempio "I miei Pod".

   • Opzione di selezione.

     Multi-valore

     Multivalore specifica che l'utente può selezionare più valori all'interno di una specifica variabile. Alcune query non supportano valori multipli, come {{ variablename }}. Scegliere questa opzione solo se la query supporta più valori.

     Includi tutto

     L'opzione Includi tutto può essere selezionata quando è attiva l'opzione multivalore. La query selezionerà tutti i valori disponibili e futuri per un determinato periodo di tempo, indipendentemente dalla selezione specifica. Quando sono selezionate entrambe le opzioni, tutte le variabili sono selezionate per impostazione predefinita, mentre una o più possono essere deselezionate. Se non viene specificata nessuna delle due opzioni, è possibile selezionare un valore di variabile alla volta.

7. Per le variabili di tipo query :

   • Specificare l'origine della query (logs o metrics).

   • Per variable type specificare values per logs. Per metrics specificare metric names, metric labels, o label values. Se si seleziona metric labels, selezionare l'etichetta da utilizzare per i valori visualizzati.

   • Per logs, definire il campo selezionando una chiave di registro che si desidera interrogare. L'elenco dei valori correnti delle variabili viene visualizzato nell'Anteprima valori in ordine alfanumerico.

   • Per metrics, in Metrics regex, inserire un'espressione regex per ottenere l'elenco di metriche che si desidera visualizzare. Ad esempio, ^kube(.*) restituisce tutti i nomi delle metriche che iniziano con kube.

     • Per label values, per Etichetta metrica, scegliere l'etichetta per i valori visualizzati. Per rendere dinamica l'etichetta, inserire una variabile, ad esempio Pod Name = {{ pod }}.

     • Per label values, per i filtri Label, creare una o più variabili annidate e un livello di filtro aggiuntivo per la query. Ad esempio, si può scegliere di filtrare le etichette per cluster, selezionando un valore che è {{ podvalue }} o il nome codificato del cluster.

     • Per metrics, per Nome di visualizzazione del valore della variabile, definire la modalità di visualizzazione dei valori nell'elenco di selezione a discesa.

       Nell'Anteprima valori viene visualizzato un elenco dei valori correnti della variabile per il campo.

   • Per Ordinare i valori, selezionare come ordinare i dati nell'Anteprima dei valori.

8. Fare clic su Salva.

Le variabili possono anche essere modificate o eliminate dall'elenco delle variabili definite.

Utilizzo di variabili nelle query

Oltre a utilizzare le variabili nei dashboard personalizzati, è possibile utilizzare le variabili definite nelle query di Lucene, DataPrime, e PromQL.

sum_over_time(kube_pod_owner[${__range}])