Creazione di un widget di misurazione IBM Cloud Logs

È possibile creare un widget indicatore da includere nei cruscotti personalizzati di IBM® Cloud Logs.

Utilizzare un widget indicatore per visualizzare un singolo valore all'interno di un intervallo specificato, spesso simile a un tachimetro o a un quadrante. In genere viene utilizzato per rappresentare a colpo d'occhio le metriche chiave e gli indicatori di prestazione.

I misuratori incorporano soglie che consentono di modificare l'aspetto della visualizzazione quando vengono raggiunti o superati determinati valori. Quando si raggruppa un set di dati in base a un parametro specifico, si crea un multimetro, in cui ogni metro rappresenta un sottoinsieme dei dati. Ciò consente un confronto simultaneo tra diverse categorie o gruppi, fornendo una visione più ampia delle prestazioni.

Passo 1: Inserire nome e descrizione

Completa i seguenti passi:

  1. In un dashboard personalizzato, fare clic su Aggiungi widget icona Aggiungi widget e trascinare e rilasciare il widget Misuratore dalla barra laterale.

  2. Sostituire New gauge con il nome del widget.

  3. Immetti una descrizione.

    Fare clic sull'icona Azione Icona Azione. Quindi, selezionare Aggiungi descrizione.

  4. Definire dove vengono visualizzati i valori della legenda. I valori validi sono: Side, Bottom, Auto, e Hide.

    Fare clic sull'icona Azione Icona Azione. Quindi, selezionare Impostazioni Leggend.

Passo 2: Configurare la query per definire l'insieme di dati

Completa i seguenti passi:

  1. Fare clic sull'icona Azione Icona Azione. Quindi, selezionare la modalità Modifica.

  2. Per il sito Query 1, completare i seguenti passaggi:

    Selezionare il tipo di dati. I valori validi sono: Logs, Metrics, e DataPrime.

    Selezionare la sorgente. Le opzioni valide sono: Priority Insights e Analyze and Alert.

    È possibile rinominare la query. Selezionare l' icona Azione e fare clic su Rinomina query.

  3. Inserire la query.

    Quando il tipo di dati è DataPrime, inserire una query Dataprime nel campo Query.

    Quando il tipo di dati è Logs, inserire una query Lucene nel campo Query. È possibile applicare filtri e aggregazioni.

    Quando il tipo di dati è Metrics, specificare la metrica o PromQL desiderata nel campo Query. È possibile applicare filtri e aggregazioni.

  4. [Facoltativo] Aggiungere uno o più filtri specifici al widget per restringere i dati visualizzati nell'indicatore.

    Selezionare un'etichetta e il valore corrispondente.

    I filtri vengono applicati a livello di widget e funzionano insieme ai filtri della dashboard. In caso di conflitto, i filtri del dashboard hanno la precedenza sui filtri dei widget.

  5. Aggiungere una funzione.

    Per una query il cui tipo di dati è Logs, è possibile mostrare un valore aggregato utilizzando una delle seguenti funzioni:

    Opzione di aggregazione durante la creazione di una query quando il tipo di dati è Registri
    Aggregazione Descrizione
    Conteggio Il numero totale di registri nell'intervallo di tempo selezionato.
    Conteggio distinti Il numero di registri unici nell'intervallo di tempo selezionato.
    Somma La somma di tutti i registri nell'intervallo di tempo selezionato.
    Minimo Il valore più piccolo tra i registri nell'intervallo di tempo selezionato.
    Max Il valore più grande tra i registri nell'intervallo di tempo selezionato.
    Media Il valore medio di tutti i registri nell'intervallo di tempo selezionato.
    Percentile XX Rappresenta il valore al di sotto del quale cade il XX% dei tronchi. Ad esempio, il Percentile 95 è il valore al di sotto del quale cade il 95% dei log.

    Per una query il cui tipo di dati è Metrics, è possibile mostrare un valore calcolato utilizzando una delle seguenti funzioni:

    Opzione Calcoli durante la creazione di una query quando il tipo di dati è Metriche
    Calcolo Descrizione
    Istantaneo Il valore al momento attuale.
    Ultimo Il valore più recente nell'intervallo di tempo selezionato.
    Minimo Il valore più piccolo all'interno dell'intervallo di tempo selezionato.
    Max Il valore più grande all'interno dell'intervallo di tempo selezionato.
    Med Il valore medio di tutti i punti dati nell'intervallo di tempo selezionato.
    Somma La somma totale di tutti i punti dati nell'intervallo di tempo selezionato.
    Nessuno Non viene applicato alcun calcolo. Vengono utilizzati dati grezzi.

  6. Aggiungere 1 o più campi in Group By per generare più indicatori.

Passo 3: Configurare il widget

Completa i seguenti passi:

  1. Fare clic sull'icona Azione Icona Azione. Quindi, selezionare la modalità Modifica.

  2. Scegliere un'opzione di gestione della legenda. I valori validi sono: Group e Threshold.

    Gruppo organizza la legenda in base a diverse entità di dati, come server o applicazioni, visualizzandole come voci separate.

    La soglia categorizza i valori in base a limiti predefiniti come normale, avviso, critico, aiutando a visualizzare se una metrica rientra in un intervallo accettabile o se è passata in uno stato di allarme.

  3. Nella sezione Gestione visiva, scegliere come visualizzare i dati.

    L'arco interno mostra il valore effettivo della query.

    L'arco esterno visualizza le soglie definite dall'utente.

    Abilita l' arco interno, l' arco esterno o entrambi per visualizzare un singolo valore all'interno di un intervallo specificato, spesso simile a un tachimetro o a un quadrante.

    Se l' arco interno e l' arco esterno sono disabilitati, il risultato numerico della query verrà visualizzato come widget STAT senza ulteriori visualizzazioni. In questo caso, è possibile stabilire se il colore di soglia verrà applicato al valore o allo sfondo. In questa parte della configurazione, si imposta l'opzione di colore di soglia desiderata. È possibile scegliere Valore per impostare il colore di soglia per il valore o Sfondo per impostare lo sfondo con il colore di soglia.

  4. Configurare la sezione Soglie.

    Una soglia è un valore impostato dall'utente che, una volta raggiunto o superato, modifica l'aspetto della visualizzazione in base ai risultati della query. Come valori si può scegliere tra numeri percentuali o assoluti.

    Scegliere il tipo di soglia. Le opzioni valide sono: absolute per definire numeri specifici come valore e percentage per definire valori relativi al valore minimo o massimo.

    È possibile modificare il colore di un valore di soglia.

    È possibile impostare i valori di una soglia e aggiungere etichette che la descrivano.

    È possibile aggiungere ulteriori soglie.

Passo 4: salvare il widget

Completa i seguenti passi:

  1. [Opzionale] Impostare l'ora del cruscotto del widget se si desidera utilizzare un intervallo di tempo diverso da quello selezionato per il cruscotto.

  2. Fare clic su Salva per salvare il widget.

  3. [Opzionale] Condividere un link diretto al widget. Fare clic sull'icona Azione Icona Azione. Quindi, selezionare Share Widget URL, e copiare il sito URL.

    Chiunque abbia accesso alla dashboard può aprire il link condiviso per visualizzare il widget nel contesto.

    Gli URL dei widget condivisi riflettono sempre l'ultima versione salvata della dashboard. Se si sono apportate modifiche al widget o al layout, salvare la dashboard prima di condividerla.

  4. [Opzionale] Aggiungere un'azione personalizzata. Per ulteriori informazioni, vedere Utilizzo delle azioni per l'integrazione con servizi di terze parti.