Creazione di una mappa di calore IBM Cloud Logs
È possibile creare una mappa di calore da includere nei dashboard personalizzati di IBM® Cloud Logs.
Utilizzate il widget della mappa di calore per visualizzare la distribuzione o l'intensità dei dati su due dimensioni e identificare rapidamente le aree ad alta attività o le tendenze, individuare rapidamente i punti caldi, le tendenze e le anomalie nel tempo o per categoria, oppure eseguire il drill dagli eventi direttamente nei log o nelle metriche per un'analisi più approfondita.
Prima di iniziare
Una mappa di calore visualizza l'intensità dei valori dei dati utilizzando i colori. Ogni cella rappresenta il valore aggregato dei dati all'intersezione di 2 dimensioni come tempo - servizio, endpoint - latenza o regione - codice di stato. In questo modo è facile identificare picchi e schemi che potrebbero essere difficili da vedere in un grafico a linee o a barre.
Quando si configura la Heatmap, tenere conto delle seguenti informazioni:
-
Mantenere sotto le 2.000 righe di dati il numero totale di combinazioni X×Y restituite dalla query.
-
Se la query restituisce più di 2000 record, aumentare l'intervallo di tempo o ridurre il numero di campi Group By.
-
Utilizzare non più di 5 campi di raggruppamento per ogni widget. Campi aggiuntivi potrebbero influire sulla leggibilità e sulle prestazioni.
-
Evitare di raggruppare per etichette ad alta cardinalità come user_id.
-
Limitare i campi di raggruppamento per evitare risultati di visualizzazione sovraffollati.
Passo 1: Inserire nome e descrizione
Completa i seguenti passi:
-
In cruscotto personalizzato, fare clic su Aggiungi widget
e trascinare il widget Mappa di calore dalla barra laterale.
-
Sostituire New heatmap con il nome del widget.
-
Immetti una descrizione.
Fare clic sull'icona Azione
. Quindi, selezionare Aggiungi descrizione.
Passo 2: Configurare la query per definire l'insieme di dati
Completa i seguenti passi:
-
Fare clic sull'icona Azione
. Quindi, selezionare la modalità Modifica. -
Per il sito
Query 1, completare i seguenti passaggi:Selezionare il tipo di dati. I valori validi sono:
Logs,Metrics, eDataPrime.Selezionare la sorgente. Le opzioni valide sono:
Priority InsightseAnalyze and Alert.È possibile rinominare la query. Selezionare l'
e fare clic su Rinomina query.
-
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. -
[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.
-
Aggiungere una funzione per raggruppare e aggregare i dati per la mappa di calore.
Selezionare una funzione di aggregazione come
Count,Sum, oAverageper calcolare il valore rappresentato dall'intensità del colore.Selezionare Raggruppa per campi. Questi campi sono utilizzati per gli assi delle mappe di calore. Questi campi devono essere di tipo stringa, timestamp o severity. Se un campo è numerico, come status_code, è possibile trasformarlo in una stringa in una query DataPrime prima del raggruppamento. Ad esempio, è possibile utilizzare nella query:
status_code:string
Passo 3: Configurare il widget
Completa i seguenti passi:
-
Fare clic sull'icona Azione
. Quindi, selezionare la modalità Modifica. -
Nella sezione Gestione visuale, selezionare fino a 5 categorie o campi che si desidera far apparire sugli assi X e Y.
Per controllare quale campo appare sull'asse X e quale sull'asse Y, trascinare i campi tra
Y-axiseX-axis.Quando sull'asse X viene visualizzato un campo timestamp, selezionare la modalità di visualizzazione delle etichette temporali. L'impostazione predefinita è
Auto, che regola il formato in base all'intervallo di tempo selezionato. Sono disponibili i seguenti formati:Formati per i campi timestamp Formato Esempio Automatico Si regola automaticamente DD/MM 25/04 dd/mm 04/25 HH:mm 14:30 GG/MM HH:mm 25/04 14:30 HH:mm GG/MM 14:30 25/04 MM/DD HH:mm 04/25 14:30 HH:mm MM/GG 14:30 04/25 -
Mostra i valori delle celle. Alterna per sovrapporre i valori numerici all'interno di ogni cella. È utile quando le celle sono più grandi e leggibili.
-
Selezionare una tavolozza di colori predefinita per rappresentare l'intensità dei dati. È possibile invertire l'ordine dei colori (chiaro → scuro o scuro → chiaro).
Selezionare lo schema di colori utilizzando la configurazione della legenda. Per impostazione predefinita, mappa i valori da chiaro → scuro. Utilizzare le soglie Min e Max per controllare la gamma di colori e migliorare la leggibilità dei dati con distribuzioni ampie o non uniformi.
-
Scegliere il tipo di scala. I valori validi sono
Linear(predefinito), dove i colori cambiano uniformemente tra i valori, oppureLogarithmic, dove il colore si applica globalmente all'accesso Z (barra dell'intensità del colore) per i set di dati con ampi intervalli di valori. -
Nella sezione Gestione delle indicazioni, personalizzare le informazioni che appaiono quando si passa il mouse su un punto o un cluster della mappa. Aggiungere il messaggio e selezionare le etichette o gli attributi da includere nel suggerimento.
Aggiungere il messaggio o il valore che viene visualizzato quando si passa il mouse su un punto o un cluster. È possibile fare riferimento a campi dinamici, come il valore aggregato, utilizzando la sintassi
{{ }}.Quando un campo referenziato si risolve in più valori distinti all'interno di un cluster, il tooltip visualizza un'etichetta generica come "multiple" invece di un valore specifico. Questo indica che il cluster contiene valori misti e incoraggia a scendere nei dettagli.
Selezionare le etichette o gli attributi da includere nel tooltip, come il servizio, l'applicazione o il paese.
Passo 5: salvare il widget
Completa i seguenti passi:
-
[Opzionale] Impostare l'ora del cruscotto del widget se si desidera utilizzare un intervallo di tempo diverso da quello selezionato per il cruscotto.
-
Fare clic su Salva per salvare il widget.
-
[Opzionale] Aggiungere un'azione personalizzata. Per ulteriori informazioni, vedere Utilizzo delle azioni per l'integrazione con servizi di terze parti.
Azioni su una mappa
Utilizzate le azioni rapide per analizzare i dati direttamente dalla mappa.
Quando si seleziona un punto o un cluster, un menu contestuale fornisce le seguenti azioni:
-
Open Explore: Apre i registri nella vista Esplora, pre-filtrati in base alla posizione e al contesto del cluster selezionato. -
Filter in: Aggiunge la posizione e il contesto di valore selezionati alla query del cruscotto. -
Filter out: Esclude la località e il contesto di valori selezionati dalla query del dashboard. -
Copy name: Copia l'etichetta di posizione o la coppia chiave=valore associata al punto o al cluster selezionato.