Risolvere i problemi relativi ai grafici

Questa pagina spiega alcuni dei comportamenti che potresti notare quando utilizzi le metriche raccolte dai tuoi progetti Google Cloud.

Errori dei grafici

In questa sezione vengono descritti gli errori che potresti riscontrare durante la configurazione di un grafico. Puoi configurare i grafici utilizzando Metrics Explorer o aggiungendoli in una dashboard.

Vuoti nei dati del grafico

A volte i grafici presentano delle lacune nei dati. Ad esempio, screenshot mostra questo comportamento per la metrica loadbalancing.googleapis.com/https/total_latencies:

Esempio di grafico con lacune nei valori.

Lacune nei dati possono verificarsi quando i dati vengono scritti molto di rado. Cloud Monitoring raccoglie le metriche tramite il campionamento e, con dati molto sparsi, potrebbe non essere disponibile alcun dato al momento della raccolta di un campione. Ad esempio: Potrebbero verificarsi lacune nelle metriche del bilanciatore del carico quando il conteggio delle richieste è 0,05 query al secondo (QPS) o meno. Quando il tasso di query aumenta, le lacune scompaiono.

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

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

Questo comportamento è previsto.

I grafici sono limitati il numero di punti dati che possono visualizzare. Pertanto, quando il numero di punti dati disponibili per l'intervallo di tempo selezionato è superiore al limite di visualizzazione, il monitoraggio modifica automaticamente le impostazioni di allineamento per ridurre il numero di punti dati da visualizzare.

Il grafico non mostra tutte le serie temporali

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

Ai fini delle prestazioni, i grafici sono configurati per essere visualizzati al massimo 50 serie temporali.

Quando configuri un grafico e più di 50 serie temporali sono disponibili, il grafico limita il numero di serie temporali visualizzate e aggiunge alla barra degli strumenti un'icona con un punto rosso. La descrizione comando 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 la descrizione comando e Seleziona il pulsante Mostra tutte le serie temporali.

Il grafico non mostra dati

Configuri un grafico, ma il grafico visualizza 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 a procedere nel seguente modo:

    • Aumenta l'intervallo di tempo per il grafico. Alcuni tipi di metriche, come quelle che registrano l'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. In altre parole, non esistono dati per quel tipo di metrica.

  • Quando il tipo di metrica o il tipo di risorsa specificato dalla query non è 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 tutte le query esistenti. Puoi utilizzare l'interfaccia basata su menu per visualizzare i grafici cerca il tipo di metrica.

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

Un grafico con più metriche mostra un messaggio di errore

Stai configurando un grafico in modo che mostri più metriche, che a sua volta 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 a sull'asse Y sinistro o sull'asse Y destro. Le unità di tutti i tipi di metriche mappato sull'asse Y sinistro deve essere lo stesso; altrimenti, l'errore precedente viene visualizzato il messaggio di errore. Analogamente, le unità di tutte i tipi di metrica mappati sull'asse Y destro devono essere uguali o con l'errore precedente viene visualizzato il messaggio di errore.

Per risolvere questo errore:

  1. Se il grafico contiene metriche con più di due tipi di unità, rimuovi le metriche finché non avrai 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 mostrare più metriche e sono stati aggiunti filtri per mostrare solo serie temporali specifiche. Tuttavia, Il grafico mostra le serie temporali che non soddisfano i filtri.

Per risolvere il problema, assicurati di applicare i filtri a ogni metrica riportata sul grafico.

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

Esempio di Metrics Explorer con due tipi di metriche.

Nello screenshot è presente una voce per ogni tipo di metrica visualizzata dal grafico.

Ad esempio, se vuoi che il grafico mostri le serie temporali solo per le VM nella zona us-central1-a, aggiungi il filtro zone = us-central1-a a ogni query.

Impossibile selezionare i valori di filtro per i grafici definiti in MQL e PromQL

Puoi creare i grafici in una dashboard personalizzata e configurarli con Monitoring Query Language (MQL) o con PromQL. Poi crei 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:

I valori per un filtro a livello di dashboard non vengono caricati.

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

Errori della dashboard

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

La dashboard non mostra tutti gli eventi

Configuri un dashboard per visualizzare gli eventi; Tuttavia, vengono visualizzati solo gli eventi recenti. Gli eventi meno recenti non vengono mostrati.

Per risolvere il problema, esegui una delle seguenti operazioni:

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

  • Aggiungi filtri.

Per motivi di prestazioni, il numero di eventi che possono essere visualizzati nelle dashboard è limitato. Quando vengono raggiunti questi limiti, le dashboard visualizzano solo gli eventi più recenti.

Il widget dei criteri di avviso non mostra dati

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

Per risolvere la situazione, prova a procedere nel seguente modo:

  • Visualizza la configurazione del grafico e verifica che venga generato un avviso criterio è selezionato. Se non viene impostato alcun criterio di avviso visualizzato, quindi associa il grafico a un criterio di avviso per eliminare il grafico dalla dashboard.

    I grafici nelle dashboard che mostrano i dati per un criterio di avviso smettono di visualizzarli quando il criterio di avviso a cui si fa riferimento viene eliminato. L'eliminazione di un criterio di avviso non comporta l'eliminazione dei grafici che fanno riferimento a quel criterio.

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

    I grafici sulle dashboard che mostrano i dati per un criterio di avviso non vengono più visualizzati se il criterio di avviso viene modificato per contenere più condizioni. Per risolvere questa condizione, associa il grafico a un criterio di avviso con una sola condizione o elimina il grafico dalla dashboard.

  • Aumenta il periodo di tempo. Il selettore dell'intervallo di tempo deve essere impostato su più lungo del periodo di campionamento dei dati. Sebbene la maggior parte delle metriche venga campionata ogni 60 secondi, alcune vengono campionate di rado. Ad esempio, serviceruntime.googleapis.com/quota/limit la metrica 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 viene visualizzato tutte le voci di log.

Per risolvere questo problema, riduci il numero di progetti i cui log registrano le il riquadro dei log è configurato per essere visualizzato.

Per ulteriori informazioni su questa condizione di errore, consulta La query restituisce un errore.

Il riquadro dei log segnala che non sono state trovate voci

Viene visualizzato il messaggio di errore "Nessuna voce trovata corrispondente al filtro attuale" nel un riquadro dei log. Questo messaggio potrebbe essere visualizzato per diversi motivi. Verifica quanto segue:

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

    • Hai Visualizzatore log (roles/logging.viewer).

    • Per i ruoli personalizzati, hai le seguenti autorizzazioni:

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

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

    Ad esempio, se il campo Editor di query contiene severity=NOTICE, Il riquadro dei log recupera tutti i log con un livello di gravità pari a esattamente NOTICE. Se il menu Serietà del riquadro dei log è impostato su "Avviso", il riquadro dei log mostra "Nessuna voce trovata corrispondente al filtro attuale". Il messaggio viene visualizzato perché nessuna delle voci di log recuperate ha un livello di gravità minimo "Avviso".

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

Il riquadro dei log indica che vengono visualizzati dati parziali

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

Se non hai l'autorizzazione per visualizzare i log per un progetto Google Cloud i cui log che hai scelto di visualizzare, questo indicatore viene mostrato. Per rimuovere l'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:

    • Ti concede 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 che mostri solo i log relativi a Progetti Google Cloud per i quali hai l'autorizzazione a visualizzare le voci di log.

Il riquadro dei log mostra il messaggio di autorizzazione negata

Il widget del riquadro dei log su una dashboard mostra la seguente autorizzazione messaggio rifiutato:

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

Per risolvere il problema:

  1. Modifica il widget del riquadro dei log.

  2. Esegui una di queste operazioni:

    • Imposta il menu Ambito per su Progetto e poi utilizza il menu Progetti per selezionare Progetto corrente.

    • Rimuovi dal menu Visualizzazioni spazio di archiviazione le visualizzazioni log non disponibili l'autorizzazione alla visualizzazione. Per informazioni sui ruoli IAM necessari per accedere alle visualizzazioni log, consulta Concedere l'accesso a una visualizzazione log.

      Quando il widget del riquadro dei log esegue ricerche nelle visualizzazioni log, devi avere: autorizzazione alla lettura delle 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 mostra tutte le serie temporali.

Per migliorare le prestazioni, le tabelle sono configurate per essere visualizzate 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:

  • Se 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.

  • Quando il campo resourceNames non è presente, 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 alla dashboard JSON.

  • Quando la sintassi per resourceNames non è corretta, il seguente 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 un file JSON formattato correttamente, vedi Dashboard con un widget LogsPanel.

Importazione delle dashboard Grafana

Per informazioni sull'utilizzo e sulla risoluzione dei problemi di Importazione dashboard, vedi Importare dashboard Grafana in Cloud Monitoring.

Per informazioni sui problemi relativi alla conversione dei contenuti della dashboard, consulta il file README dell'importatore.