Prima di iniziare

Per configurare il widget Geomap, è necessario disporre di informazioni sulla posizione nei dati. La posizione può essere fornita come coordinate geografiche o come identificatore di posizione supportato.

È possibile passare le informazioni sulla posizione utilizzando una delle seguenti opzioni:

• Opzione 1: Includere i campi latitudine e longitudine in ogni record

  È possibile utilizzare direttamente i campi di latitudine e longitudine per configurare il widget Geomap.

  I campi devono contenere valori di coordinate numeriche validi.

• Opzione 2: Includere un campo che contenga un valore di indirizzo IP e utilizzare la funzione di arricchimento geografico

  È necessario configurare l'arricchimento geografico sul campo IP corrispondente. L'arricchimento geografico ricava i valori numerici di latitudine e longitudine dagli indirizzi IP e fornisce una fonte coerente di dati sulla posizione per Geomap. Per ulteriori informazioni, vedere Configurazione degli arricchimenti geografici.

Per configurare il widget, i campi latitudine e longitudine devono essere conformi a uno dei formati supportati:

I dati visualizzati attraverso un widget Geomap sono raggruppati per coordinate di latitudine e longitudine in cluster. Pensate a un cluster come a un insieme virtuale di dati che hanno in comune latitudine e longitudine.

La query configurata in un widget Geomap valuta solo i 2.000 record di log più recenti nell'intervallo di tempo selezionato. Se alcuni di questi record di log non contengono campi geografici, vengono esclusi dalla mappa, il che può portare a una visualizzazione vuota o scarsamente popolata. Per garantire che i record valutati contengano dati geografici, è necessario filtrare esplicitamente i campi di località non nulli nel costruttore di query del widget.

Ad esempio, è possibile utilizzare una query dataprime che filtra i record di log che non includono campi geografici:

source logs
| filter $d.latitude != null
| filter $d.longitude != null
xxxxx

Considerate le seguenti informazioni quando interagite con la mappa:

• L'ingrandimento e la riduzione cambiano il livello di aggregazione geografica, consentendo di passare da modelli regionali di alto livello a posizioni più granulari.
• Passando il mouse sui punti o sui cluster si visualizza un tooltip con informazioni contestuali basate sulla configurazione corrente.
• Facendo clic su un cluster si scende a raggruppamenti geografici più piccoli, facilitando l'analisi di aree con valori misti o aggregati.

Passo 1: Inserire nome e descrizione

Completa i seguenti passi:

1. In cruscotto personalizzato, fare clic su Aggiungi widget e trascinare il widget Geomappa dalla barra laterale.

2. Sostituire New Geomap con il nome del widget.

3. 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:

1. Fare clic sull'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' 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 raggruppare e aggregare i dati per la Geomap.

Passo 3: Configurare il widget

Completa i seguenti passi:

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

2. Nella sezione Gestione posizione > Coordinate, selezionare i campi da utilizzare che contengono le informazioni di latitudine e longitudine.

   I campi contenenti i valori di latitudine e longitudine non possono essere di tipo stringa.

   È possibile configurare solo 1 campo per fornire le informazioni sulla latitudine e 1 campo per fornire le informazioni sulla longitudine per ogni widget.

   Se i dati geografici sono disponibili attraverso campi diversi in record diversi, utilizzare le regole di parsing per consolidare i dati in uno solo.

   Il widget Geomap non rileva o deduce automaticamente i campi di posizione. È necessario selezionare esplicitamente i campi utilizzati per la risoluzione della posizione.

3. In Gestione località > Calcolo dei valori dei cluster, selezionare la modalità di calcolo dei valori per ciascun cluster geografico. Se si seleziona un calcolo numerico, Sum, Average, Minimum o Maximum, è necessario selezionare un campo numerico in Per campo che verrà utilizzato per calcolare i dati che andranno in un gruppo di cluster.

   I valori validi sono: Count, Sum, Average, Minimum o Maximum.

   I valori vengono ricalcolati per un cluster in modo dinamico con l'ingrandimento e la riduzione della mappa.

   L'ingrandimento aumenta la granularità, rivelando cluster più piccoli o singoli punti.

   Lo zoom out aggrega i cluster vicini in raggruppamenti di livello superiore.

   I calcoli basati sul volume, utilizzando Count o Sum, accumulano i valori man mano che i cluster si fondono.

   I calcoli basati sul valore, utilizzando Average, Minimum o Maximum, vengono ricalcolati dai dati sottostanti.

   I calcoli di aggregazione numerica, utilizzando Sum, Average, Minimum o Maximum, richiedono la presenza di un campo numerico nei risultati della query.

   I risultati senza un valore numerico valido sono esclusi dall'aggregazione.

   Se un valore numerico è memorizzato come stringa nei dati, potrebbe essere necessario convertirlo in un tipo numerico nella query o analizzarlo durante l'ingestione prima di usarlo con le aggregazioni numeriche. Questo assicura che il valore possa essere incluso nei calcoli di Sum, Average, Minimum o Maximum.

   I risultati delle query che non possono essere ricondotti a una località geografica sono esclusi.

   Count conta il numero di eventi all'interno di ciascun cluster geografico. È possibile utilizzare count per identificare gli hotspot, la concentrazione del traffico o le regioni con elevati volumi di errori. Quando si esegue lo zoom out, i conteggi vengono sommati dai cluster più piccoli.

   Sum aggiunge i valori di un campo numerico per tutti gli eventi di ciascun cluster. Si può usare per metriche cumulative come i byte totali, le richieste totali o il costo totale. Quando si esegue lo zoom out, le somme vengono sommate tra i cluster.

   Average calcola il valore medio di un campo numerico per cluster. È possibile utilizzarlo per le metriche delle prestazioni, come la latenza o la durata. Quando si esegue lo zoom out, le medie vengono ricalcolate dai cluster sottostanti, non sommate.

   Minimum o Maximum visualizza il valore più basso o più alto osservato all'interno di ciascun cluster. È possibile utilizzare queste opzioni per identificare i valori migliori e peggiori, i valori anomali o i picchi. Quando si esegue lo zoom out, il minimo o il massimo viene ricalcolato sui cluster uniti.

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

5. Nella sezione Gestione visiva, definire il modo in cui i valori vengono rappresentati sulla mappa.

   Le opzioni valide sono Size e Color range.

   Scegliere Size per le analisi basate sul volume, dove il volume e la concentrazione sono i segnali principali.

   Scegliete la gamma di colori per un'analisi mirata alle prestazioni. È possibile selezionare una tavolozza di colori e controllare la corrispondenza tra valori e colori. È possibile definire soglie per controllare come i valori dei cluster si traducono in colori. Le soglie vengono valutate rispetto al calcolo del valore del cluster selezionato e si aggiornano dinamicamente al variare dei valori del cluster.

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