Risolvere i problemi relativi ai grafici

Per risolvere i messaggi di errore o i risultati imprevisti nei grafici e nei widget della dashboard in Cloud Monitoring, puoi modificare le query, i periodi di allineamento e le autorizzazioni in modo che la telemetria venga visualizzata con precisione. Questo documento ti aiuta a diagnosticare i problemi comuni in Metrics Explorer e nelle dashboard personalizzate, tra cui lacune nei dati, limiti di visualizzazione delle serie temporali, unità dell'asse Y non corrispondenti ed errori di configurazione dei widget.

Errori dei grafici

Questa sezione descrive gli errori che potresti visualizzare durante la configurazione di un grafico. Puoi configurare i grafici utilizzando Metrics Explorer o aggiungendoli a una dashboard.

Lacune nei dati del grafico

A volte i grafici mostrano lacune nei dati. Ad esempio, lo screenshot seguente illustra questo comportamento per la metrica loadbalancing.googleapis.com/https/total_latencies:

Possono verificarsi lacune nei dati quando i dati vengono scritti molto raramente. Cloud Monitoring raccoglie le metriche tramite campionamento e, con dati molto sparsi, potrebbero non essere disponibili dati quando viene raccolto un campione. Ad esempio, potrebbero verificarsi lacune nelle metriche del bilanciatore del carico quando il numero di richieste è pari o inferiore a 0,05 query al secondo (QPS). Quando la frequenza delle query aumenta, gli intervalli scompaiono.

Puoi rimuovere gli intervalli visivi aumentando l'intervallo di allineamento. Quando il sistema genera una nuova serie temporale con punti dati distanziati regolarmente, utilizza l'intervallo di allineamento per determinare la finestra temporale in cui vengono combinati i punti dati non elaborati. Per saperne di più, consulta Allineamento: regolarizzazione all'interno delle serie.

Per impostare un intervallo di allineamento minimo, modifica la query del grafico. Ad esempio, quando utilizzi Metrics Explorer, vai al riquadro delle query e seleziona Aggiungi elemento di query. Nel menu, seleziona Intervallo minimo e poi un intervallo di tempo.

Il periodo di allineamento cambia quando viene modificato l'intervallo di tempo

Aggiungi un grafico a una dashboard. Quando modifichi l'intervallo di tempo della dashboard o del grafico, a volte il periodo di allineamento cambia. Ad esempio, se modifichi l'intervallo di tempo da un'ora a due ore, il periodo di allineamento viene elencato come 1 minute interval. Tuttavia, se modifichi l'intervallo di tempo da un'ora a un giorno, il periodo di allineamento viene elencato come 5 minute interval.

Si tratta di un comportamento normale.

I grafici hanno un limite per il numero di punti dati che possono visualizzare. Pertanto, quando il numero di punti dati disponibili per l'intervallo di tempo selezionato è maggiore del limite di visualizzazione, Monitoring modifica automaticamente le impostazioni di allineamento per ridurre il numero di punti dati da visualizzare.

Il grafico non mostra tutte le serie temporali

Configuri un grafico, ma non vengono visualizzate tutte le serie temporali.

Per motivi di prestazioni, i grafici sono configurati per visualizzare al massimo 50 serie temporali.

Quando configuri un grafico e sono disponibili più di 50 serie temporali, il grafico limita il numero di serie temporali visualizzate e aggiunge alla barra degli strumenti un'icona con un punto rosso. Il tooltip dell'icona visualizza il seguente messaggio:

To improve performance, we've limited the time series displayed in this chart.

Per visualizzare tutte le serie temporali, espandi il tooltip e seleziona il pulsante Mostra tutte le serie temporali.

Il grafico non mostra dati

Configuri un grafico, ma questo mostra un messaggio di errore anziché i dati:

• Quando non sono disponibili dati per l'intervallo di tempo specificato per il grafico, viene visualizzato il seguente messaggio:

  No data is available for the selected time frame.
  

  Per risolvere il problema, prova quanto segue:

  • Aumenta l'intervallo di tempo per il grafico. Alcuni tipi di metriche, come quelle che generano report sull'utilizzo della quota, forniscono un solo campione al giorno.

  • Modifica il tipo di metrica selezionato per il grafico. È possibile che il tipo di metrica specificato dal grafico non sia attivo. Un tipo di metrica è inattivo quando non esistono serie temporali per il tipo.

• Quando il tipo di metrica o di risorsa specificato dalla query non viene riconosciuto, viene visualizzato il seguente messaggio:

  An error occurred requested data. One or more resources could not be found.
  

  Per risolvere il problema, prova quanto segue:

  • Verifica che il tipo di metrica e il tipo di risorsa specificati nella query siano definiti. Puoi utilizzare l'interfaccia basata su menu per i grafici per cercare il tipo di metrica.

  • Verifica l'ortografia del tipo di metrica e del tipo di risorsa nella query.

Il grafico mostra un avviso relativo ai metadati sensibili

Apri una dashboard personalizzata e ti aspetti che tutti i widget visualizzino i dati. Tuttavia, uno o più widget che contengono query SQL visualizzano messaggi simili ai seguenti:

This SQL query is configured to run on the BigQuery engine using [PROJECT_ID],
and references resources from [RESOURCE, ...]. Sensitive metadata,
including table contents, may be written to [PROJECT_ID].

Il messaggio di avviso indica che la query supera i confini di proprietà e ti offre l'opportunità di verificarla prima che venga eseguita. I confini della proprietà sono determinati da diversi fattori, uno dei quali è la gerarchia delle risorse utilizzate dalla query.

Il sistema esegue controlli dei limiti ogni volta che viene aperta una dashboard. Non puoi impedire o ignorare questi avvisi.

Nota: se stabilisci che una query non è sicura da eseguire, chiudi la dashboard. Dovresti anche valutare la possibilità di eliminare la dashboard. Non eseguire la query.

Se un widget visualizza il messaggio di avviso, puoi procedere in uno dei seguenti modi:

• Se sai che la query è sicura da eseguire e vuoi visualizzare i risultati della query, fai clic su Conferma ed esegui.

• Ignora il messaggio di errore. Questo widget non mostrerà i dati della sessione corrente.

• Analizza la query e, se necessario, disattivala. Ad esempio, potresti:

  1. Esamina la query e valuta i dati su cui viene eseguita.
  2. Esamina la cronologia della dashboard per determinare chi ha aggiunto il widget e quando.
  3. Se hai ricevuto un link alla dashboard, verifica che il mittente sia una fonte attendibile.
  4. Per riferimento futuro, salva l'analisi nella dashboard aggiungendo un widget Testo.

Google Cloud fornisce alcune funzionalità che possono aiutare a prevenire l'esfiltrazione di dati tramite phishing, attacchi interni o entità esterne. Per saperne di più, consulta Sicurezza dei dati con Observability Analytics.

Il grafico con più metriche mostra un messaggio di errore

Stai configurando un grafico per visualizzare più metriche e il grafico mostra il seguente messaggio di errore:

    The units for queries using the same Y-axis must be the same for the chart
    to render correctly.

I grafici possono visualizzare più tipi di metriche e puoi mappare un tipo di metrica all'asse Y sinistro o destro. Le unità di tutti i tipi di metriche mappate all'asse Y sinistro devono essere le stesse, altrimenti viene visualizzato il messaggio di errore precedente. Analogamente, le unità di tutti i tipi di metriche mappate sull'asse Y destro devono essere le stesse, altrimenti viene visualizzato il messaggio di errore precedente.

Per risolvere questo errore, segui questi passaggi:

1. Se il grafico contiene metriche con più di due tipi di unità, rimuovi le metriche fino a quando non rimangono solo due tipi di unità.

2. Assegna tutte le metriche con un tipo di unità all'asse Y sinistro e tutte le metriche con l'altro tipo di unità all'asse Y destro.

Il grafico con più metriche mostra dati imprevisti

Un grafico è configurato per visualizzare più metriche e sono stati aggiunti filtri per mostrare solo serie temporali specifiche. Tuttavia, il grafico mostra serie temporali che non soddisfano i filtri.

Per risolvere questo problema, assicurati di applicare i filtri a ogni metrica tracciata nel grafico.

Ad esempio, lo screenshot seguente mostra il riquadro di configurazione di Metrics Explorer per un grafico che mostra il numero di byte letti e scritti dalle istanze di macchine virtuali (VM):

Nello screenshot è presente un'intestazione per ogni tipo di metrica visualizzato nel grafico.

Ad esempio, se vuoi che il grafico visualizzi le serie temporali solo per le VM che si trovano nelle zone us-central1-a, aggiungi il filtro zone = us-central1-a a ogni query.

Impossibile selezionare i valori dei filtri per i grafici definiti da PromQL

Puoi creare grafici su una dashboard personalizzata e configurarli con PromQL. Poi, crea filtri permanenti della dashboard. Quando visualizzi la dashboard, provi a modificare il valore predefinito del filtro, ma il menu dei valori delle etichette non viene visualizzato o non è corretto:

Per risolvere il problema, inserisci il valore del filtro e poi seleziona Applica. Ad esempio, se la chiave di filtro è zone, puoi inserire us-central1-a.

Le etichette dei metadati utente non sono presenti nei menu di filtro o raggruppamento

Puoi configurare un grafico utilizzando i menu, ma i menu Filtro e Aggregazione non elencano le etichette dei metadati utente, come goog-dataproc-* o dataflow-*.

Per filtrare o raggruppare le serie temporali quando le etichette dei metadati utente non vengono visualizzate nei menu, esegui una query sulle serie temporali utilizzando PromQL o la modalità di filtro diretto:

• In PromQL, aggiungi il prefisso metadata_user_ alla chiave dell'etichetta dei metadati utente e racchiudi la chiave tra virgolette doppie se contiene caratteri speciali come i trattini. Ad esempio, la seguente query PromQL filtra l'utilizzo della CPU delle VM di Compute Engine per le serie temporali che hanno un'etichetta dei metadati utente goog-dataproc-cluster-name non vuota:

  {"compute.googleapis.com/instance/cpu/utilization", monitored_resource="gce_instance", "metadata_user_goog-dataproc-cluster-name"!=""}
  

• In modalità filtro diretto, filtra per metadata.user_labels. Ad esempio, per filtrare in base a un'etichetta dei metadati utente goog-dataproc-cluster-name non vuota, inserisci metadata.user_labels."goog-dataproc-cluster-name"!="".

Errori della dashboard

Questa sezione descrive gli errori che potresti visualizzare durante la creazione o la modifica delle dashboard.

La creazione della dashboard non riesce

Puoi creare una dashboard utilizzando una descrizione JSON o YAML della dashboard, che include un campo name. Modifichi il nome visualizzato e provi a creare una seconda dashboard, ma ricevi un errore. Ad esempio, se utilizzi Google Cloud CLI, viene visualizzato il seguente errore:

ERROR: (gcloud.alpha.monitoring.dashboards.create) Resource in projects [xxxxxxx] is the subject of a conflict: Requested entity already exists.

La causa dell'errore è che l'ID della dashboard, che identifica questa dashboard nel valore del campo name, esiste già. Pertanto, la dashboard non può essere creata.

Se specifichi il campo name quando crei una dashboard, il valore che specifichi deve essere univoco a livello globale. Il campo name ha la seguente sintassi:

"name": "projects/PROJECT_ID_OR_NUMBER/dashboards/DASHBOARD_ID"

Il nome visualizzato non deve essere univoco.

La dashboard non mostra tutti gli eventi

Configuri una dashboard per visualizzare gli eventi, ma vengono visualizzati solo gli eventi recenti. Gli eventi meno recenti non vengono mostrati.

Per risolvere il problema, procedi in uno dei seguenti modi:

• Utilizza un intervallo di tempo più breve. Ad esempio, puoi visualizzare i dati dell'ora più recente anziché del giorno più recente o selezionare un intervallo di tempo personalizzato.

• Aggiungi filtri.

Per motivi di prestazioni, le dashboard hanno un limite al numero di eventi che possono visualizzare. Quando vengono raggiunti questi limiti, le dashboard visualizzano solo gli eventi più recenti.

La dashboard creata da Terraform viene ridimensionata

Hai creato una dashboard utilizzando Terraform e poi l'hai modificata utilizzando la console Google Cloud . Ti aspettavi che la dashboard rimanesse invariata, ad eccezione delle tue modifiche. La dashboard viene invece ridimensionata. Ad esempio, la tua dashboard aveva 12 colonne e ora ne ha 48.

Non utilizzare la console Google Cloud per modificare le dashboard create utilizzando Terraform. Quando la dashboard viene modificata, le dimensioni vengono ridimensionate di un fattore quattro.

Il widget della policy di avviso non visualizza dati

Una dashboard contiene un grafico per una criterio di avviso, ma il grafico non visualizza dati.

Per risolvere il problema, prova quanto segue:

• Visualizza la configurazione del grafico e assicurati che sia selezionata una policy di avviso. Se non viene visualizzata alcuna criterio di avviso, associa il grafico a una criterio di avviso o eliminalo dalla dashboard.

  I grafici sulle dashboard che mostrano i dati per una criterio di avviso smettono di mostrare i dati quando la criterio di avviso a cui fanno riferimento viene eliminata. L'eliminazione di una criterio di avviso non comporta l'eliminazione dei grafici che fanno riferimento a quella policy.

• Visualizza i dettagli della criterio di avviso e verifica che contenga una singola condizione.

  I grafici sulle dashboard che mostrano i dati per una criterio di avviso smettono di visualizzare i dati se la criterio di avviso viene modificata in modo da contenere più condizioni. Per risolvere il problema, associa il grafico a una criterio di avviso con una singola condizione o elimina il grafico dalla dashboard.

• Aumenta l'intervallo di tempo. Il selettore dell'intervallo di tempo deve essere impostato su un valore superiore al periodo di campionamento dei dati. Sebbene la maggior parte delle metriche venga campionata ogni 60 secondi, alcune metriche vengono campionate raramente. Ad esempio, la metrica serviceruntime.googleapis.com/quota/limit viene campionata ogni 86.400 secondi (1 giorno).

Il riquadro dei log segnala una query non valida

Viene visualizzato il messaggio di errore "Errore: query non valida" e il riquadro dei log non mostra alcuna voce di log.

Per risolvere il problema, riduci il numero di progetti di cui il riquadro dei log è configurato per visualizzare i log.

Per saperne di più su questa condizione di errore, consulta La query restituisce un errore.

Il riquadro Log indica che non sono state trovate voci

Viene visualizzato il messaggio di errore "Non sono state trovate voci corrispondenti al filtro attuale" in un riquadro dei log. Ci sono diversi motivi per cui potresti visualizzare questo messaggio. Verifica quanto segue:

• Per ogni progetto di cui vuoi visualizzare le voci di log, assicurati che sia soddisfatta una delle seguenti condizioni:

  • Disponi del ruolo Visualizzatore log (roles/logging.viewer).

  • Per i ruoli personalizzati, disponi delle seguenti autorizzazioni:

    • logging.logs.list
    • logging.logServiceIndexes.list
    • logging.logServices.list

• Assicurati che le clausole nell'editor di query non siano in conflitto con le impostazioni mostrate nel riquadro dei log.

  Ad esempio, quando il campo Editor di query contiene severity=NOTICE, il riquadro dei log recupera tutti i log con un livello di gravità esattamente pari a NOTICE. Se il menu Gravità del riquadro dei log è impostato su "Avviso", il riquadro dei log visualizza "Non sono state trovate voci corrispondenti al filtro attuale". Il messaggio viene visualizzato perché nessuna delle voci di log recuperate ha un livello di gravità almeno pari ad "Avviso".

  Al contrario, quando il campo Editor di query contiene severity=WARNING e il menu Gravità del riquadro dei log è impostato su "Avviso", potresti visualizzare voci di log. Con questa configurazione, il riquadro dei log recupera i log con livello di gravità WARNING. Successivamente, l'elenco dei log viene filtrato per visualizzare solo quelli con gravità almeno pari a "Notice" e tutti i log recuperati hanno almeno questo livello di gravità.

Il riquadro Log indica che mostra dati parziali

Vedi un indicatore di avviso e il messaggio "Visualizzazione dei risultati parziali" in un riquadro dei log.

Questo indicatore viene visualizzato quando non disponi dell'autorizzazione per visualizzare i log di un progetto Google Cloud di cui hai selezionato i log da visualizzare. Per rimuovere l'indicatore di avviso, esegui una delle seguenti operazioni:

• Contatta l'amministratore di sistema e chiedigli di eseguire una delle seguenti operazioni per ogni progetto Google Cloud di cui vuoi visualizzare i log:

  • Concederti il ruolo di Visualizzatore log (roles/logging.viewer).

  • Per i ruoli personalizzati, concedi le seguenti autorizzazioni:

    • logging.logs.list
    • logging.logServiceIndexes.list
    • logging.logServices.list

• Modifica la configurazione del riquadro dei log in modo da mostrare i log solo per i progettiGoogle Cloud per i quali disponi dell'autorizzazione per visualizzare le voci di log.

Il riquadro Log mostra il messaggio di autorizzazione negata

Il widget del riquadro dei log in una dashboard visualizza il seguente messaggio di autorizzazione negata:

Error: Permission 'logging.views.access' denied on resource (or it may not exist).

Per risolvere il problema, segui questi passaggi:

1. Modifica il widget del riquadro dei log.

2. Esegui una delle seguenti operazioni:

   • Imposta il menu Ambito per su Progetto, quindi utilizza il menu Progetti per selezionare Progetto attuale.

   • Rimuovi dal menu Visualizzazioni spazio di archiviazione le visualizzazioni dei log che non hai l'autorizzazione di visualizzare. Per informazioni sui ruoli IAM necessari per accedere alle visualizzazioni log, consulta Concedi l'accesso a una visualizzazione log.

     Quando il widget del riquadro dei log esegue ricerche nelle visualizzazioni di log, devi disporre dell'autorizzazione per leggere le voci di log in tutte le visualizzazioni di log elencate. In caso contrario, viene visualizzato un messaggio di errore.

3. Fai clic su Applica.

La tabella non mostra tutte le serie temporali

Configuri una tabella, ma non vengono visualizzate tutte le serie temporali.

Per motivi di prestazioni, le tabelle sono configurate per visualizzare al massimo 300 righe.

La chiamata API per creare una dashboard con un riquadro dei log non va a buon fine

Esistono diversi motivi per cui potresti visualizzare un messaggio di errore quando crei una dashboard con un riquadro dei log:

• Quando il riquadro dei log non soddisfa i requisiti minimi di altezza o larghezza, viene visualizzato il seguente errore:

  Unable to save dashboard: Field mosaicLayout.tiles[0] has an invalid value: LogsPanel must have a minimum width of 3 and height of 3.
  

  Per risolvere questa condizione, nella rappresentazione JSON della dashboard, assicurati che i campi height e width del widget del riquadro dei log soddisfino i requisiti minimi.

• Quando il campo logsPanel.filter supera i 2000 caratteri, viene visualizzato il seguente errore:

  Unable to save dashboard: filter cannot be greater than 2000 characters.
  

  Per risolvere questa condizione, accorcia il filtro.

• Se manca il campo resourceNames, viene visualizzato il seguente messaggio di errore:

  Unable to save dashboard: Dashboard is missing required field mosaicLayout.tiles[0].widget.logsPanel.resourceNames.
  

  Per risolvere questa condizione, aggiungi un campo resourceNames al file JSON della dashboard.

• Se la sintassi del campo resourceNames non è corretta, viene visualizzato un errore simile al seguente:

  Unable to save dashboard: Field mosaicLayout.tiles[0].widget.logsPanelWidget.resourceNames has an invalid value of "a-project": resource name must have the format `projects/{project}`.
  

  Per risolvere questa condizione, sostituisci a-project con projects/a-project nel file JSON della dashboard.

• Per informazioni su come risolvere gli errori di sintassi nel campo filter, consulta Risoluzione dei problemi: problemi di sintassi.

Per un esempio di file JSON formattato correttamente, consulta Dashboard con un widget LogsPanel.

Importazione delle dashboard Grafana

Per informazioni sull'utilizzo e sulla risoluzione dei problemi dell'importatore di dashboard, consulta Importa le dashboard di Grafana in Cloud Monitoring.

Per informazioni sui problemi relativi alla conversione dei contenuti della dashboard, consulta il file README dello strumento di importazione.