Visualizzazioni di tipo griglia

Le griglie o le tabelle vengono comunemente usate per presentare i dati agli utenti. È possibile applicare singolarmente uno stile alle colonne della griglia nelle cartelle di lavoro per offrire un'interfaccia utente completa per i report. Sebbene anche una tabella normale mostri i dati, è difficile da leggere e le informazioni dettagliate non sono sempre evidenti. L'applicazione di stili alla griglia consente di semplificare la lettura e l'interpretazione dei dati.

L'esempio seguente mostra una griglia che usa una combinazione di icone, mappe termiche e barre spark per presentare informazioni complesse. La cartella di lavoro fornisce anche opzioni di ordinamento, una casella di ricerca e un pulsante per l’accesso all’analisi.

Screenshot che mostra una griglia basata su log.

Aggiungere una griglia basata su log

  1. Passare la cartella di lavoro alla modalità di modifica selezionando Modifica sulla barra degli strumenti.
  2. Selezionare Aggiungi query per aggiungere un controllo della query di log alla cartella di lavoro.
  3. Per Tipo di query selezionare Log. In Tipo di risorsa selezionare, ad esempio, Application Insights e selezionare le risorse di destinazione.
  4. Usare l'editor di query per immettere KQL per l'analisi. Ad esempio, macchine virtuali con memoria inferiore a una determinata soglia.
  5. Impostare Visualizzazione su Griglia.
  6. Impostare parametri come intervallo di tempo, dimensioni, tavolozza dei colori e legenda, se necessario.

Screenshot che mostra una query su una griglia basata su log.

Parametri del grafico dei log

Parametro Descrizione Esempi
Tipo di query Tipo di query da usare. Log, Azure Resource Graph
Tipo di risorsa Tipo di risorsa di destinazione. Application Insights, Log Analytics o prima Azure
Risorse Set di risorse da cui ottenere il valore delle metriche. MyApp1
Intervallo di tempo Intervallo di tempo a cui si riferisce il grafico dei log. Ultima ora, ultime 24 ore
Visualizzazione Visualizzazione da usare. Griglia
Dimensione Dimensione verticale del controllo. Piccolo, medio, grande o completo
Query Qualsiasi query KQL che restituisce i dati nel formato previsto dalla visualizzazione del grafico. requests | summarize Requests = count() by name

Griglia semplice

Le cartelle di lavoro possono eseguire il rendering dei risultati KQL come tabella semplice. La griglia seguente mostra il numero di richieste e utenti univoci per tipo di richiesta in un'app:

requests
| where name !endswith('.eot')
| summarize Requests = count(), Users = dcount(user_Id) by name
| order by Requests desc

Screenshot che mostra una griglia basata su log in modalità di modifica.

Stile griglia

Colonne in stile mappa termica:

Screenshot che mostra una griglia basata su log con colonne in stile mappa termica.

Colonne in stile barre:

Screenshot che mostra una griglia basata su log con colonne in stile barre.

Applicare uno stile a una colonna della griglia

  1. Selezionare il pulsante Impostazione colonna sulla barra degli strumenti del controllo query.
  2. Nel riquadro Modifica impostazioni colonna selezionare la colonna a cui applicare lo stile.
  3. In Renderer colonne selezionare Mappa termica, Barra o Barra sottostante e selezionare le impostazioni correlate per applicare uno stile alla colonna.

L'esempio seguente mostra la colonna Richieste in stile barre:

Screenshot che mostra una griglia basata su log con la colonna Richieste in stile barra.

Questa opzione in genere consente di passare ad altre visualizzazioni, con il contesto proveniente dalla cella, o di aprire un URL.

Formattazione personalizzata

È anche possibile impostare la formattazione numerica dei valori delle celle nelle cartelle di lavoro. Per impostare questa formattazione, selezionare la casella di controllo Formattazione personalizzata quando è disponibile.

Opzione di formattazione Descrizione
Unità Unità per la colonna, con varie opzioni per percentuale, conteggi, tempo, byte, conteggio/ora e byte/ora. Ad esempio, è possibile impostare l'unità per un valore pari a 1234 su millisecondi ed eseguire il rendering come 1,234 s.
Style Formato utilizzato per eseguire il rendering, ad esempio decimale, valuta, percentuale.
Mostra separatore di gruppo Casella di controllo per visualizzare i separatori di gruppo. Esegue il rendering di 1234 come 1,234 negli Stati Uniti.
Numero minimo di cifre intere Numero minimo di cifre intere da usare (impostazione predefinita 1).
Numero minimo di cifre frazionarie Numero minimo di cifre frazionarie da usare (valore predefinito 0).
Numero massimo di cifre frazionarie Numero massimo di cifre frazionarie da usare.
Numero minimo di cifre significative Numero minimo di cifre significative da usare (valore predefinito 1).
Numero massimo di cifre significative Numero massimo di cifre significative da usare.
Testo personalizzato per i valori mancanti Quando un punto dati non contiene un valore, mostra questo testo personalizzato invece di uno spazio vuoto.

Formattazione data personalizzata

Dopo aver specificato che una colonna è impostata sul renderer di data/ora, è possibile specificare opzioni di formattazione della data personalizzate con la casella di controllo Formattazione data personalizzata.

Opzione di formattazione Descrizione
Stile Formato di rendering di una data come breve, lungo o completo oppure di un'ora come breve o lunga.
Mostra periodo come Consente di decidere se visualizzare l’ora nell'ora locale (impostazione predefinita) o nell’ora UTC. A seconda dello stile del formato data selezionato, le informazioni sul fuso orario/UTC potrebbero non essere visualizzate.

Impostazione della larghezza colonna personalizzata

È possibile personalizzare la larghezza di qualsiasi colonna nella griglia tramite il campo Larghezza colonna personalizzata in Impostazioni colonna.

Screenshot che mostra le impostazioni delle colonne con il campo Larghezza colonna personalizzata indicato da una casella rossa.

Se il campo viene lasciato vuoto, la larghezza viene determinata automaticamente in base al numero di caratteri nella colonna e al numero di colonne visibili. L'unità predefinita è "car", l'abbreviazione di "caratteri".

Se si seleziona il pulsante (Larghezza corrente) nell'etichetta, il campo di testo viene riempito con la larghezza corrente della colonna selezionata. Se il campo Larghezza colonna personalizzata contiene un valore senza unità di misura, viene usato il valore predefinito.

Le unità di misura disponibili sono:

Unit of measurement Definizione
ch caratteri (impostazione predefinita)
px pixel
fr unità frazionarie
% percentage

Convalida dell'input: se la convalida ha esito negativo, sotto il campo viene visualizzato un messaggio di indicazioni rosso, benché sia comunque possibile applicare la larghezza. Se un valore è presente nell'input, viene analizzato. Se non viene trovata alcuna unità di misura valida, viene usata l'impostazione predefinita.

È possibile impostare la larghezza su qualsiasi valore. Non esiste una larghezza minima o massima. Il campo Larghezza colonna personalizzata è disabilitato per le colonne nascoste.

Esempi

Di seguito sono riportati alcuni esempi.

Linee spark e barra sottostante

L'esempio seguente mostra il numero di richieste e la tendenza in base al nome della richiesta:

requests
| make-series Trend = count() default = 0 on timestamp from ago(1d) to now() step 1h by name
| project-away timestamp
| join kind = inner (requests
    | summarize Requests = count() by name
    ) on name
| project name, Requests, Trend
| order by Requests desc

Screenshot che mostra una griglia basata su log con una barra sottostante e una linea spark.

Mappa termica con scale condivise e formattazione personalizzata

In questo esempio vengono illustrate varie metriche per la durata della richiesta e i conteggi. Il renderer della mappa termica usa i valori minimi impostati nelle impostazioni o calcola un valore minimo e massimo per la colonna. Assegna un colore di sfondo dalla tavolozza selezionata per la cella. Il colore si basa sul valore della cella rispetto al valore minimo e massimo della colonna.

requests
| summarize Mean = avg(duration), (Median, p80, p95, p99) = percentiles(duration, 50, 80, 95, 99), Requests = count() by name
| order by Requests desc

Screenshot che mostra una griglia basata su log con una mappa termica e una scalabilità condivisa tra le colonne.

Nell'esempio precedente viene usata una tavolozza condivisa in verde o rosso e una scala per colorare le colonne Media, Mediana,p80 ,p95 ep99 . Per la colonna Richieste viene utilizzata una tavolozza separata in blu.

Scalabilità condivisa

Per ottenere una scalabilità condivisa:

  1. Usare espressioni regolari per selezionare più colonne a cui applicare un'impostazione. Ad esempio, impostare il nome della colonna su Mean|Median|p80|p95|p99 per selezionarli tutti.
  2. Eliminare le impostazioni predefinite per le singole colonne.

La nuova impostazione a più colonne applica le relative impostazioni per includere una scalabilità condivisa.

Screenshot che mostra un'impostazione della griglia basata su log che consente di ottenere una scalabilità condivisa tra le colonne.

Icone per rappresentare lo stato

L'esempio seguente mostra lo stato personalizzato delle richieste in base alla durata p95:

requests
| summarize p95 = percentile(duration, 95) by name
| order by p95 desc
| project Status = case(p95 > 5000, 'critical', p95 > 1000, 'error', 'success'), name, p95

Screenshot che mostra una griglia basata su log con una mappa termica e una scalabilità condivisa tra le colonne tramite la query precedente.

Nomi di icona supportati:

  • cancelled
  • critical
  • disabilitato
  • Errore
  • failed
  • info
  • Nessuno
  • in sospeso
  • arrestato
  • Domanda
  • esito positivo
  • Sconosciuto
  • warning
  • non inizializzato
  • resource
  • up
  • sistema
  • left
  • right
  • trendup
  • trenddown
  • 4
  • 3
  • 2
  • 1
  • Sev0
  • Gravità 1
  • Gravità 2
  • Gravità 3
  • Gravità 4
  • Generato
  • Risolto
  • Disponibile
  • Non disponibile
  • Degraded
  • Sconosciuto
  • Spazio vuoto

Percentuali di unità frazionarie

L'unità frazionaria, abbreviata come "fr", è un'unità dinamica di misura comunemente usata in vari tipi di griglie. Man mano che cambiano le dimensioni o la risoluzione della finestra, cambia anche la larghezza fr.

Lo screenshot seguente mostra una tabella con otto colonne con la stessa larghezza pari a 1fr. Man mano che le dimensioni della finestra cambiano, cambia proporzionalmente anche la larghezza di ogni colonna.

Screenshot che mostra le colonne in una griglia, ognuna con un valore di larghezza di colonna pari a 1fr.

L'immagine seguente mostra la stessa tabella, ad eccezione della prima colonna che è impostata sul 50% di larghezza. Questa impostazione imposta in modo dinamico la colonna sulla metà della larghezza totale della griglia. Il ridimensionamento della finestra continua a mantenere la larghezza del 50%, a meno che le dimensioni della finestra non diventino troppo piccole. Queste colonne dinamiche hanno una larghezza minima in base al relativo contenuto.

Il rimanente 50% della griglia è diviso dalle otto unità frazionarie totali. La colonna Kind è impostata su 2fr, quindi occupa un quarto dello spazio rimanente. Poiché le altre colonne sono 1fr ognuna, occupano ognuna un ottavo della metà destra della griglia.

Screenshot che mostra le colonne in una griglia con una colonna impostata sul 50% della larghezza e le rimanenti colonne impostate su 1fr.

La combinazione di larghezze fr, %, px e caratteri è possibile e funziona in modo analogo agli esempi precedenti. Le larghezze impostate dalle unità statiche (car e px) sono vincoli rigidi che rimangono invariati anche nel caso in cui la finestra o la risoluzione venga modificata.

Le colonne impostate con % occupano la relativa percentuale in base alla larghezza totale della griglia. Questa larghezza potrebbe non essere esatta a causa delle larghezze minime precedenti.

Le colonne impostate con fr suddividono lo spazio rimanente della griglia in base al numero di unità frazionarie assegnate.

Screenshot che mostra le colonne in una griglia in cui viene usata una combinazione di unità di larghezza diverse.

Passaggi successivi