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
<a name="using-google-cloud-monitoring-in-grafana"></a>

**Nota**  
 Nelle versioni precedenti di Grafana, questa fonte di dati era denominata Google Stackdriver. 

 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
<a name="google-adding-the-data-source"></a>

1.  Apri il menu laterale selezionando l'icona Grafana nell'intestazione in alto. 

1.  Nel menu laterale, sotto il link **Dashboards**, dovresti trovare il link **Data** Sources. 

1.  Scegli il pulsante **\$1 Aggiungi fonte di dati** nell'intestazione in alto. 

1.  Seleziona **Google Cloud Monitoring** dall'elenco a discesa **Tipo**. 

1.  Carica o incolla il file della chiave dell'account di servizio. Vedi più avanti in questo documento per i passaggi per creare un file di chiave dell'account di servizio. 

**Nota**  
 Se non vedi il link **Data Sources** nel menu laterale, significa che l'utente attuale non ha il `Admin` ruolo. 


|  Nome  |  Description  | 
| --- | --- | 
|  Name  |  Il nome della fonte di dati. Ecco come si fa riferimento alla fonte di dati nei pannelli e nelle query.  | 
|  Default  |  L'origine dati predefinita significa che sarà preselezionata per i nuovi pannelli.  | 
|  Service Account Key  |  File chiave dell'account di servizio per un progetto GCP. Consulta le istruzioni più avanti in questo documento su come crearlo.  | 

## Autenticazione
<a name="google-authentication"></a>

 Esistono due modi per autenticare il plug-in Google Cloud Monitoring
+ Carica un file Google JWT
+ Recupera automaticamente le credenziali dal server di metadati di Google

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

### Utilizzo di un file chiave dell'account del servizio Google
<a name="using-a-google-service-account-key-file"></a>

 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 provenienti da più progetti GCP, è necessario creare una fonte di dati per progetto GCP. 

#### Abilitazione APIs
<a name="google-enable-apis"></a>

 Prima APIs deve essere abilitato quanto segue: 
+  [API di monitoraggio](https://console.cloud.google.com/apis/library/monitoring.googleapis.com) 
+  [API Cloud Resource Manager](https://console.cloud.google.com/apis/library/cloudresourcemanager.googleapis.com) 

 Scegli i link elencati, quindi scegli il pulsante **Abilita**.

#### Creazione di un account di servizio GCP per un progetto
<a name="create-a-gcp-service-account-for-a-project"></a>

1.  Vai alla pagina [APIse alle credenziali dei servizi](https://console.cloud.google.com/apis/credentials). 

1.  Scegli l'opzione **Crea credenziali** dropdown/button e scegli l'opzione **Chiave dell'account di servizio**. 

    \$1\$1< docs-imagebox img=»/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1button.png "class="docs-image—no-shadow» caption="Crea il pulsante per l'account di servizio» >\$1\$1 

1.  **Nella pagina `JSON` Crea la chiave** dell'account di servizio, scegli il tipo di chiave. Quindi, nell'elenco a discesa **Account di servizio**, scegli l'opzione **Nuovo account di servizio**. 

    \$1\$1< docs-imagebox img=»/img/docs/v71/cloudmonitoring\$1create\$1service\$1account\$1key.png "class="docs-image—no-shadow» caption="Crea la chiave dell'account di servizio» >\$1\$1 

1.  Appariranno alcuni nuovi campi. Inserisci un nome per l'account di servizio nel campo **Nome account di servizio**, quindi scegli il ruolo **Monitoring Viewer** dall'elenco a discesa **Ruolo**. 

    \$1\$1< docs-imagebox img=»/img/docs/v71/cloudmonitoring\$1service\$1account\$1choose\$1role.png "class="docs-image—no-shadow» caption="Scegli il ruolo» >\$1\$1 

1.  Scegli il pulsante **Crea**. Verrà creato e scaricato sul computer un file di chiave JSON. Archivia questo file in un luogo sicuro in quanto consente l'accesso ai tuoi dati di Google Cloud Monitoring. 

1.  Caricalo su Grafana nella pagina di **configurazione** dell'origine dati. Puoi caricare il file o incollare il contenuto del file. 

    \$1\$1< docs-imagebox img=»/img/docs/v71/cloudmonitoring\$1grafana\$1upload\$1key.png "class="docs-image—no-shadow» caption="Carica il file della chiave di servizio su Grafana» >\$1\$1 

1.  Il contenuto del file verrà crittografato e salvato nel database Grafana. Non dimenticare di salvare dopo aver caricato il file\$1 

    \$1\$1< docs-imagebox img=»/img/docs/v71/cloudmonitoring\$1grafana\$1key\$1uploaded.png "class="docs-image—no-shadow» caption="Il file della chiave di servizio è stato caricato su Grafana» >\$1\$1 

## Utilizzo dell’editor della query
<a name="google-using-the-query-editor"></a>

 ****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
<a name="google-metric-queries"></a>

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

 Per creare una query metrica, procedi nel seguente modo: 

1.  Scegli l'opzione **Metriche** nell'elenco a discesa **Tipo di query**. 

1.  Scegli un progetto dall'elenco a discesa **Progetto**. 

1.  Scegli un servizio Google Cloud Platform dall'elenco a discesa **Servizi**. 

1.  Scegli una metrica dall'elenco a discesa **Metric**. 

1.  Per aggiungere o rimuovere filtri o raggruppare per clausole, utilizza le icone più e meno nel filtro e raggruppa per sezioni. Questa fase è facoltativa. 

 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
<a name="google-filter"></a>

 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
<a name="google-simple-wildcards"></a>

 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
<a name="google-regular-expressions"></a>

 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
<a name="google-aggregation"></a>

 Il campo di aggregazione consente di combinare serie temporali in base a statistiche comuni. Per ulteriori informazioni sull'aggregazione, consulta le opzioni di [aggregazione](https://cloud.google.com/monitoring/charts/metrics-selector#aggregation-options). 

 Il `Aligner` campo consente di allineare più serie temporali dopo lo stesso gruppo per intervallo di tempo. [Per ulteriori informazioni sull'aligner, consulta il selettore metrico di allineamento.](https://cloud.google.com/monitoring/charts/metrics-selector#alignment) 

##### Periodo di allineamento e raggruppamento per ora
<a name="alignment-periodgroup-by-time"></a>

 `Alignment Period`Raggruppa 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: 
+  1 m per intervalli di tempo < 23 ore 
+  1 m per intervalli di tempo = 23 ore e < 6 giorni 
+  5 m per intervalli di tempo >= 23 ore e= 6 giorni 

 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](variables-types.md#add-an-interval-variable). 

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

#### Raggruppa per
<a name="google-group-by"></a>

 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\$1istanza per visualizzare una metrica aggregata per un'istanza di calcolo. 

##### Etichette di metadati
<a name="google-metadata-labels"></a>

 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
<a name="google-alias-patterns"></a>

 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
<a name="metric-type-patterns"></a>


|  Modello di alias  |  Description  |  Risultato dell’esempio  | 
| --- | --- | --- | 
|  \$1\$1metric.type\$1\$1  |  Restituisce il tipo metrico completo.  |  compute.googleapis.com/instance/cpu/utilization  | 
|  \$1\$1metric.name\$1\$1  |  Restituisce la parte del nome della metrica.  |  instance/cpu/utilization  | 
|  \$1\$1metric.service\$1\$1  |  Restituisce la parte di ricambio.  |  compute  | 

#### Modelli di etichette
<a name="google-label-patterns"></a>

 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. 


|  Formato del modello di alias  |  Description  |  Esempio di pattern di alias  |  Risultato dell’esempio  | 
| --- | --- | --- | --- | 
|  \$1\$1metric.label.xxx\$1\$1  |  Restituisce il valore dell'etichetta metrica. |  \$1\$1metric.label.instance\$1name\$1\$1  |  grafana-1-prod  | 
|  \$1\$1resource.label.xxx\$1\$1  |  Restituisce il valore dell'etichetta della risorsa.  |  \$1\$1resource.label.zone\$1\$1  |  us-east1-b  | 
|  \$1\$1metadata.system\$1labels.xxx\$1\$1  |  Restituisce il valore dell'etichetta del sistema di metadati.  |  \$1\$1metadata.system\$1labels.name\$1\$1  |  grafana  | 
|  \$1\$1metadata.user\$1labels.xxx\$1\$1  |  Restituisce il valore dell'etichetta utente dei metadati.  |  \$1\$1metadata.user\$1labels.tag\$1\$1  |  production  | 

 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. 


|  Formato del modello di alias  |  Description  |  Risultato dell’esempio  | 
| --- | --- | --- | 
|  \$1\$1resource.type\$1\$1  |  Restituisce il nome del tipo di risorsa monitorata.  |  gce\$1instance  | 

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

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

### Interrogazioni SLO
<a name="slo-service-level-objective-queries"></a>

**Nota**  
 Le interrogazioni SLO sono disponibili solo in Grafana v7.0\$1 

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.](https://cloud.google.com/monitoring/service-monitoring)

#### Creazione di una query SLO
<a name="how-to-create-an-slo-query"></a>

 Per creare una query SLO, procedi nel seguente modo: 

1.  Scegli l'opzione **Service Level Objectives (SLO)** nell'elenco a discesa **Query Type**. 

1.  Scegli un progetto dall'elenco a discesa **Progetto**. 

1.  Scegli un [servizio SLO](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services) dall'elenco a discesa **Servizio**. 

1.  Scegli un [SLO dall'elenco](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services.serviceLevelObjectives) a discesa **SLO**. 

1.  **Scegli un selettore di [serie temporali dall'elenco a discesa Selector](https://cloud.google.com/monitoring/service-monitoring/timeseries-selectors#ts-selector-list).** 

 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.


|  Valore dell'elenco a discesa del selettore  |  Selettore di serie temporali corrispondente utilizzato  | 
| --- | --- | 
|  Valore SLI  |  select\$1slo\$1health  | 
|  Conformità SLO  |  select\$1slo\$1compliance  | 
|  Errore SLO (budget residuo)  |  select\$1slo\$1budget\$1fraction  | 

#### Modelli di alias per le query SLO
<a name="alias-patterns-for-slo-queries"></a>

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


|  Modello di alias  |  Description  |  Risultato dell’esempio  | 
| --- | --- | --- | 
|  \$1\$1project\$1\$1  |  Restituisce il nome del progetto GCP.  |  myProject  | 
|  \$1\$1service\$1\$1  |  Restituisce il nome del servizio.  |  myService  | 
|  \$1\$1slo\$1\$1  |  Restituisce lo SLO.  |  latency-slo  | 
|  \$1\$1selector\$1\$1  |  Restituisce il selettore.  |  select\$1slo\$1health  | 

#### Periodo di allineamento e raggruppamento per ora per le interrogazioni SLO
<a name="alignment-periodgroup-by-time-for-slo-queries"></a>

 Le interrogazioni SLO utilizzano la stessa funzionalità del periodo di allineamento delle interrogazioni metriche. Per ulteriori informazioni, consulta [Interrogazioni metriche](#google-metric-queries). 

## Templating
<a name="google-templating"></a>

 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](templates-and-variables.md) 

### Variabile di interrogazione
<a name="google-query-variable"></a>

 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 segue`Query Types`. 


|  Nome  |  Description  | 
| --- | --- | 
|  Metric Types  |  Restituisce un elenco di nomi di tipi di metriche disponibili per il servizio specificato.  | 
|  Labels Keys  |  Restituisce un elenco di chiavi per metric label e resource label nella metrica specificata.  | 
|  Labels Values  |  Restituisce un elenco di valori per l'etichetta nella metrica specificata.  | 
|  Resource Types  |  Restituisce un elenco di tipi di risorse per la metrica specificata.  | 
|  Aggregations  |  Restituisce un elenco di aggregazioni (riduttori di serie incrociate) per la metrica specificata.  | 
|  Aligners  |  Restituisce un elenco di allineatori (allineatori per serie) per la metrica specificata.  | 
|  Alignment periods  |  Restituisce un elenco di tutti i periodi di allineamento disponibili nell'editor di query di Google Cloud Monitoring in Grafana.  | 
|  Selectors  |  Restituisce un elenco di selettori che possono essere utilizzati nelle query SLO (Service Level Objectives).  | 
|  SLO Services  |  Restituisce un elenco di servizi di monitoraggio dei servizi che possono essere utilizzati nelle query SLO.  | 
|  Service Level Objectives (SLO)  |  Restituisce un elenco di SLO per il servizio SLO specificato.  | 

### Utilizzo di variabili nelle interrogazioni
<a name="google-using-variables-in-queries"></a>

 Esistono due sintassi: 
+  `$<varname>` Esempio: `metric.label.$metric_label` 
+  `[[varname]]` Esempio: `metric.label.[[metric_label]]` 

 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
<a name="google-annotations"></a>

 È 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](https://cloud.google.com/monitoring/custom-metrics/) di Google Cloud Monitoring.

Per ulteriori informazioni sulle annotazioni, consulta. [Annotazioni](dashboard-annotations.md) 

 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
<a name="patterns-for-the-annotation-query-editor"></a>


|  Formato del modello di alias  |  Description  |  Esempio di pattern di alias  |  Risultato dell’esempio  | 
| --- | --- | --- | --- | 
|  \$1\$1metric.value\$1\$1  |  Valore della metrica/punto.  |  \$1\$1metric.value\$1\$1  |  555  | 
|  \$1\$1metric.type\$1\$1  |  Restituisce il tipo metrico completo.  |  \$1\$1metric.type\$1\$1  |  compute.googleapis.com/instance/cpu/utilization  | 
|  \$1\$1metric.name\$1\$1  |  Restituisce la parte del nome della metrica. |  \$1\$1metric.name\$1\$1  |  instance/cpu/utilization  | 
|  \$1\$1metric.service\$1\$1  |  Restituisce la parte di ricambio.  |  \$1\$1metric.service\$1\$1  |  compute  | 
|  \$1\$1metric.label.xxx\$1\$1  |  Restituisce il valore dell'etichetta metrica.  |  \$1\$1metric.label.instance\$1name\$1\$1  |  grafana-1-prod  | 
|  \$1\$1resource.label.xxx\$1\$1  |  Restituisce il valore dell'etichetta della risorsa.  |  \$1\$1resource.label.zone\$1\$1  |  us-east1-b  | 

## Collegamento diretto dai pannelli Grafana a Metrics Explorer in Google Cloud Console
<a name="deep-linking-from-grafana-panels-to-the-metrics-explorer-in-google-cloud-console"></a>

**Nota**  
 Questa funzione è disponibile solo per le query Metric. 

 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 e viene eseguita 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.