Creazione di un widget a barra verticale IBM Cloud Logs

È possibile creare un grafico a barre verticali da includere nei dashboard personalizzati di IBM® Cloud Logs.

Utilizzate un grafico a barre verticali per ordinare i dati in ordine alfabetico in base al nome della colonna. Nei grafici a barre orizzontali, i dati vengono ordinati per valore.

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 Grafico a barre verticali dalla barra laterale.

  2. Sostituire Nuovo grafico a barre verticali 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 legenda.

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.

    Quando si crea un grafico a barre con le metriche come tipo di dati, le categorie specificate nella query PromQL appaiono automaticamente nel campo Group By. È possibile riordinare le categorie nel campo Raggruppa per trascinandole. Trascinare e rilasciare le categorie dal campo Categoria al campo Impilamento, per impilare in base a una particolare categoria.

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

    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 è Logs (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.

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 Stack.

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

    Stack mostra come più voci di dati sono raggruppate e stratificate sulla stessa barra orizzontale. I set di dati della stessa pila sono raggruppati in un unico grafico a barre orizzontale suddiviso in segmenti. Mostra un secondo livello di dati sul grafico.

    Schema di colore della legenda: selezionare se si desidera che i colori della legenda siano per gruppo, pila o aggregazione. Per impostazione predefinita, il grafico a barre orizzontali è di tipo aggregativo, il che significa che verrà visualizzato un unico colore per tutte le barre.

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

    La barra massima per grafico visualizza il numero massimo di barre individuali in una singola visualizzazione del grafico in base alla query.

    Il valore massimo di fette per barra visualizza il numero massimo di segmenti all'interno di una singola barra.

    Attivare la barra massima per grafico, le fette massime per barra o entrambe per visualizzare un singolo valore all'interno di un intervallo specificato.

  4. Configurare la sezione Scala.

    Una scala si riferisce al modo in cui i valori vengono visualizzati lungo l'asse delle ascisse e delle ordinate. È possibile scegliere tra valori lineari o logaritmici.

    Scegliere il tipo di scala. Le opzioni valide sono: Linear che definisce come i valori aumentino proporzionalmente e Logarithmic in cui il valore è definito da logaritmi invece che da intervalli lineari uguali.

    È possibile modificare il colore di un valore di soglia.

    L'impostazione predefinita è lineare. Tuttavia, se ci sono grandi differenze tra i diversi valori, può essere utile mostrare la scala logaritmica. Ad esempio, se la maggior parte dei valori è inferiore a 1k e un valore è 10k, utilizzando la scala logaritmica si otterrà un grafico a barre di più facile lettura rispetto alla scala lineare.

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.