Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect a una fonte di dati di Google Cloud Monitoring

Aggiungi la fonte di dati di Google Cloud Monitoring per poter creare dashboard per le tue metriche di Google Cloud Monitoring.

Aggiungere la fonte di dati

Autenticazione

Esistono due modi per autenticare il plug-in Google Cloud Monitoring

Quest'ultima opzione è disponibile solo quando si esegue Grafana sulla macchina virtuale GCE.

Utilizzo di un file chiave dell'account del servizio Google

Per autenticarti con l'API di monitoraggio del cloud di Google, devi creare un account di servizio Google Cloud Platform (GCP) per il progetto per cui desideri mostrare i dati. Una fonte di dati Grafana si integra con un progetto GCP. Per visualizzare i dati di più progetti GCP, è necessario creare una fonte di dati per progetto GCP.

Abilitazione delle API

Le seguenti API devono essere abilitate prima:

Scegli i link elencati, quindi scegli il pulsante Abilita.

Creazione di un account di servizio GCP per un progetto

Utilizzo dell'editor della query

L'editor di query di Google Cloud Monitoring ti consente di creare due tipi di query: Metric e Service Level Objective (SLO). Entrambi i tipi restituiscono dati di serie temporali.

Interrogazioni metriche

L'editor di query metriche consente di selezionare metriche, raggruppare/aggregare per etichette e per ora e di utilizzare filtri per specificare quali serie temporali si desidera inserire nei risultati.

Per creare una query metrica, segui questi passaggi:

Le metriche di Google Cloud Monitoring possono essere di diversi tipi (GAUGE, DELTA, CUMULATIVE) e supportano diverse opzioni di aggregazione (riduttori e allineatori). L'editor di query Grafana mostra l'elenco dei metodi di aggregazione disponibili per una metrica selezionata e imposta un riduttore e un allineatore predefiniti quando si seleziona la metrica. Le unità per l'asse Y vengono inoltre selezionate automaticamente dall'editor di query.

Filtri

Per aggiungere un filtro, scegli l'icona più, scegli un campo in base al quale filtrare e inserisci un valore per il filtro. Ad esempio, specifica instance_name = grafana-1. Puoi rimuovere il filtro scegliendo il nome del filtro e selezionando--remove filter--.

Caratteri jolly semplici

Quando l'operatore è impostato su o, = != è possibile aggiungere caratteri jolly al campo del valore del filtro. Ad esempio, us-* acquisisce tutti i valori che iniziano con «us-» e *central-a acquisisce tutti i valori che terminano con «central-a». *-central-*acquisisce tutti i valori che hanno la sottostringa di. central- I caratteri jolly semplici sono meno costosi delle espressioni regolari.

Espressioni regolari

Quando l'operatore è impostato su o, =~ !=~ è possibile aggiungere espressioni regolari al campo del valore del filtro. Ad esempio, us-central[1-3]-[af] corrisponde a tutti i valori che iniziano con «us-central», seguito da un numero compreso tra 1 e 3, un trattino e quindi una «a» o una «f». Le barre iniziali e finali non sono necessarie per creare espressioni regolari.

Aggregazione

Il campo di aggregazione consente di combinare serie temporali in base a statistiche comuni. Per ulteriori informazioni sull'aggregazione, consulta le opzioni di aggregazione.

Il Aligner campo consente di allineare più serie temporali dopo lo stesso gruppo per intervallo di tempo. Per ulteriori informazioni sull'allineatore, fare riferimento al selettore metrico di allineamento.

Periodo di allineamento e raggruppamento per ora

Alignment PeriodRaggruppa una metrica per ora se viene scelta un'aggregazione. L'impostazione predefinita prevede l'utilizzo dei raggruppamenti predefiniti di GCP Google Cloud Monitoring (che consentono di confrontare i grafici in Grafana con i grafici nell'interfaccia utente di Google Cloud Monitoring). L'opzione viene chiamata e le impostazioni predefinite cloud monitoring auto sono:

L'altra opzione automatica è. grafana auto Questo imposterà automaticamente il gruppo per ora in base all'intervallo di tempo scelto e alla larghezza del pannello grafico. Per ulteriori informazioni, consulta Aggiungere una variabile di intervallo.

È anche possibile scegliere intervalli di tempo fissi in base ai quali raggruppare, ad esempio 1h o1d.

Raggruppa per

Raggruppa per risorse o etichette metriche per ridurre il numero di serie temporali e aggregare i risultati in base a un gruppo per. Ad esempio, raggruppa per nome_istanza per visualizzare una metrica aggregata per un'istanza di calcolo.

Etichette di metadati

Le etichette dei metadati delle risorse contengono informazioni per identificare in modo univoco una risorsa in Google Cloud. Le etichette di metadati vengono restituite nella risposta delle serie temporali solo se fanno parte del segmento Raggruppa per nella richiesta delle serie temporali. Non esiste un'API per il recupero delle etichette di metadati, quindi non è possibile compilare l'elenco a discesa per gruppo con le etichette di metadati disponibili per il servizio e la metrica selezionati. Tuttavia, l'elenco a discesa Raggruppa per campo include un elenco predefinito di etichette di sistema comuni.

Le etichette utente non possono essere predefinite, ma è possibile inserirle manualmente nel campo Raggruppa per. Se un'etichetta di metadati, un'etichetta utente o un'etichetta di sistema è inclusa nel segmento Raggruppa per, puoi creare filtri basati su di essa ed espanderne il valore nel campo Alias.

Modelli di alias

Il campo Alias By consente di controllare il formato delle chiavi della legenda. L'impostazione predefinita è mostrare il nome e le etichette della metrica. Può essere lungo e difficile da leggere. Utilizzando i seguenti schemi nel campo degli alias, è possibile formattare la chiave della legenda nel modo desiderato.

Modelli di tipo metrico

Schemi di etichette

Nell'elenco a discesa Raggruppa per, puoi visualizzare un elenco di etichette di metriche e risorse relative a una metrica. Queste possono essere incluse nella chiave della legenda utilizzando modelli di alias.

Esempio di Alias By: {{metric.type}} - {{metric.label.instance_name}}

Risultato di esempio: compute.googleapis.com/instance/cpu/usage_time - server1-prod

È anche possibile risolvere il nome del tipo di risorsa monitorata.

Esempio di Alias By: {{resource.type}} - {{metric.type}}

Risultato di esempio: gce_instance - compute.googleapis.com/instance/cpu/usage_time

Interrogazioni SLO

Il generatore di query SLO nella fonte di dati di Google Cloud Monitoring ti consente di visualizzare i dati SLO in formato serie temporale. Per comprendere i concetti di base del monitoraggio dei servizi, consulta la documentazione ufficiale di Google Cloud Monitoring.

Creazione di una query SLO

Per creare una query SLO, procedi nel seguente modo:

I nomi descrittivi per i selettori delle serie temporali sono mostrati in Grafana. La tabella seguente mostra la mappatura dal nome descrittivo al nome di sistema utilizzato nella documentazione di Service Monitoring.

Modelli di alias per le interrogazioni SLO

È possibile utilizzare il campo Alias By per controllare il formato delle chiavi della legenda per le query SLO.

Periodo di allineamento e raggruppamento per ora per le interrogazioni SLO

Le interrogazioni SLO utilizzano la stessa funzionalità del periodo di allineamento delle interrogazioni metriche. Per ulteriori informazioni, consulta Interrogazioni metriche.

Templating

Invece di inserire elementi come il nome del server, dell'applicazione e del sensore nelle query metriche, puoi utilizzare variabili al loro posto. Le variabili vengono visualizzate come caselle di selezione a discesa nella parte superiore della dashboard. Puoi utilizzare queste caselle a discesa per modificare i dati visualizzati nella dashboard.

Per ulteriori informazioni sui modelli e sulle variabili dei modelli, consulta. Modelli e variabili

Variabile di interrogazione

La variabile di tipo Query consente di interrogare Google Cloud Monitoring per vari tipi di dati. Il plug-in di origine dati di Google Cloud Monitoring fornisce quanto segueQuery Types.

Utilizzo di variabili nelle interrogazioni

Esistono due sintassi:

Perché due modi? La prima sintassi è più facile da leggere e scrivere ma non consente di utilizzare una variabile al centro di una parola. Quando le opzioni Multivalore o Includi tutti i valori sono abilitate, Grafana converte le etichette da testo semplice a una stringa compatibile con espressioni regolari, il che significa che devi usare invece di. =~ =

Annotazioni

È possibile utilizzare le annotazioni per sovrapporre informazioni dettagliate sugli eventi ai grafici. È possibile aggiungere interrogazioni di annotazione tramite il menu Dashboard /la vista Annotazioni. Il rendering delle annotazioni è costoso, quindi è importante limitare il numero di righe restituite. Non è ancora disponibile il supporto per la visualizzazione di annotazioni ed eventi di Google Cloud Monitoring, ma funziona bene con le metriche personalizzate di Google Cloud Monitoring.

Per ulteriori informazioni sulle annotazioni, consulta. Annotazioni

Con l'editor di query per le annotazioni, puoi selezionare una metrica e dei filtri. I campi Titolo e Testo supportano la creazione di modelli e possono utilizzare i dati restituiti dalla query. Ad esempio, il campo Titolo potrebbe contenere il seguente testo:

{{metric.type}} has value: {{metric.value}}

Risultato di esempio: monitoring.googleapis.com/uptime_check/http_status has this value: 502

Modelli per l'editor delle query di annotazione

Collegamento diretto dai pannelli Grafana a Metrics Explorer in Google Cloud Console

Scegli una serie temporale nel pannello per visualizzare un menu contestuale con un collegamento a Visualizza in Metrics Explorer in Google Cloud Console. Scegliendo quel link si apre Metrics Explorer nella Google Cloud Console ed esegue la query dal pannello Grafana. Il link indirizza l'utente prima al Google Account Chooser. Dopo aver selezionato con successo un account, l'utente viene reindirizzato a Metrics Explorer. Il link fornito è valido per qualsiasi account, ma visualizza la query solo se l'account ha accesso al progetto GCP specificato nella query.