Questa pagina è stata tradotta dall'API Cloud Translation.

Creare e gestire canali di notifica

Questo documento descrive come configurare i canali di notifica utilizzando la console Google Cloud. Cloud Monitoring utilizza questi canali per inviarti notifiche o il tuo team disponibile quando si attiva un criterio di avviso. Quando crei un'immagine criterio di avviso, puoi scegliere chi deve ricevere una notifica effettuando selezioni elenco dei canali di notifica configurati. Ad esempio, potresti configurare criteri di avviso che monitorano le istanze Compute Engine per pubblicare Pub/Sub e inviare una notifica al canale Slack per il team disponibile.

Per ulteriori informazioni, consulta le sezioni Latenza delle notifiche e Notifiche per incidente.

Questo documento descrive come utilizzare la console Google Cloud. Se utilizzi sull'API Cloud Monitoring, quindi Creare e gestire canali di notifica tramite API.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare e configurare i canali di notifica utilizzando la console Google Cloud, chiedi all'amministratore di concederti Ruolo IAM Editor Monitoring (roles/monitoring.editor) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Per ulteriori informazioni sui ruoli di Cloud Monitoring, vedi Controlla l'accesso con Identity and Access Management.

Creazione di un canale di notifica

Quando crei un criterio di avviso, puoi selezionare qualsiasi del canale di notifica configurato e aggiungerlo al criterio. Puoi preconfigurare i canali di notifica oppure puoi configurarli come parte il processo di creazione di un criterio di avviso. Per ulteriori informazioni, consulta Creare un canale on demand.

Per creare un canale di notifica utilizzando la console Google Cloud: segui le istruzioni specifiche per il canale riportate nella seguente tabella:

Email

Per aggiungere un canale di notifica via email:

Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Modifica canali di notifica.
Nella sezione Email, fai clic su Aggiungi nuovo.
Inserisci un singolo indirizzo email e una descrizione.
Fai clic su Salva.

Se utilizzi un indirizzo email di gruppo come canale di notifica per un criterio di avviso, quindi configura il gruppo in modo che accetti la posta da alerting-noreply@google.com.

Puoi creare canali email durante la creazione di un avviso . Per ulteriori informazioni, vedi Creare un canale on demand.

App per dispositivi mobili

Utilizza l'app mobile Google Cloud Console per monitorare Risorse della console Google Cloud e Monitoring informazioni da qualsiasi luogo. Le notifiche dell'app mobile della console Google Cloud inviati a un dispositivo specifico o a un utente specifico:

Elenco dei canali di notifica dell'app mobile Google Cloud

Dispositivo indica che le notifiche vengono inviate solo al dispositivo specifico che ha creato il canale di notifica. Per canali di notifica basati sui dispositivi, Il campo Nome visualizzato include le informazioni sul dispositivo.
Utente indica che le notifiche vengono inviate a tutti: dai dispositivi su cui è installata l'app mobile Google Cloud.

Cloud Monitoring determina l'ambito delle notifiche quando il canale viene creato. Non puoi selezionare o modificare l'ambito.

Per configurare un canale di notifica dell'app mobile della console Google Cloud per uno specifico progetto Google Cloud, segui questi passaggi:

Installa l'app mobile per la console Google Cloud dallo store del tuo dispositivo mobile.
Seleziona un progetto da visualizzare nell'app mobile della console Google Cloud.

Dopo aver selezionato un progetto, viene avviato uno scambio di dati tra l'app e si verifica il progetto Google Cloud selezionato. Quando non viene creato, viene creato un canale di notifica. esistono e, dopo qualche minuto, questo canale viene elencato nella sezione Dispositivi mobili del Pagina Canali di notifica.

Per aggiungere il tuo dispositivo mobile come canale di notifica per un avviso nella sezione Notifiche degli avvisi, seleziona Console Google Cloud (dispositivo mobile), quindi scegli il dispositivo mobile da dall'elenco.

PagerDuty

L'integrazione con PagerDuty consente la sincronizzazione unidirezionale o bidirezionale con Monitoring. Indipendentemente dalla configurazione, si verifica quanto segue:

Se in Monitoring viene creato un incidente in Monitoring, viene aperto in PagerDuty.
Non puoi utilizzare PagerDuty per chiudere un incidente in monitoraggio.

Se utilizzi la sincronizzazione unidirezionale e risolvi l'incidente in PagerDuty, lo stato dell'incidente in PagerDuty viene disaccoppiato lo stato dell'incidente in Monitoring. In effetti, se risolvere un incidente in PagerDuty, l'incidente viene chiuso definitivamente in PagerDuty e non può essere riaperto.

Se utilizzi la sincronizzazione bidirezionale, i controlli di Monitoring quello mostrato da PagerDuty. Se risolvi l'incidente in PagerDuty e se in Monitoring l'incidente è aperto, viene riaperto in PagerDuty.

Per configurare le notifiche PagerDuty, procedi nel seguente modo:

Nel tuo account PagerDuty, configura l'integrazione in una nuova o aggiungere l'integrazione a un servizio esistente.
1. Crea un account o accedi a un account esistente.
2. Vai alla pagina Servizi.
3. Nel riquadro Integrazioni del servizio, trova l'elenco dei tuoi una nuova integrazione, espandi il menu e copia la chiave di integrazione.
In Cloud Monitoring, aggiungi il canale di notifica PagerDuty:
1. Nella console Google Cloud, vai alla Pagina Avvisi:
  Vai ad Avvisi
  
  Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
2. Fai clic su Modifica canali di notifica.
3. Nella sezione PagerDuty, fai clic su Aggiungi nuovo.
4. Inserisci il Nome visualizzato. Questo nome deve corrispondere alla del servizio PagerDuty in cui hai configurato il nuovo integrazione nel passaggio 1.
5. Inserisci nel campo della chiave di integrazione la chiave di integrazione che hai copiato nel passaggio 1 Chiave di servizio.
6. Fai clic su Salva.
(Facoltativo) Se vuoi configurare la sincronizzazione bidirezionale, procedi nel seguente modo:
1. Vai al tuo account PagerDuty.
2. Seleziona Servizi, poi il nome del servizio che hai inserito durante la configurazione dell'integrazione.
3. Seleziona il riquadro Integrations (Integrazioni) del servizio.
4. Vai alla sezione Impostazioni di avvisi e incidenti e poi fai clic su Modifica.
5. Seleziona Crea incidenti e avvisi, quindi salva modifiche.

Quando crei un criterio di avviso, seleziona PagerDuty nel Notifiche e scegli la configurazione PagerDuty.

Il pacchetto JSON per PagerDuty ha il seguente formato:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Per visualizzare un esempio e lo schema per il campo details: espandi le sezioni seguenti.

Esempi JSON

Per impostazione predefinita, il backend di avviso tenta di generare un pacchetto JSON con formattazione versione 1.2. Per ulteriori informazioni su questa formattazione, consulta nella prossima sezione.

Ecco un esempio di pacchetto di questo tipo:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "No severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Struttura dello schema, versione 1.2

Questa sezione descrive la versione 1.2 dello schema del payload. Alcune potrebbero non essere visualizzati in tutti i pacchetti restituiti o avere valori vuoti, a seconda della configurazione del criterio di avviso, lo stato dell'incidente o della risorsa monitorata. Alcuni campi prendere le strutture incorporate come valori; queste strutture sono descritti per riferimento perché anche i loro contenuti possono variare.

In un pacchetto restituito, i campi possono essere presenti in qualsiasi ordine. Nella descrizione che segue, sono organizzati in gruppi correlati.

{
  "version": "1.2",
  "incident": {

    Informazioni sull'incidente.

    "incident_id": stringa, ID generato per questo incidente.
    "scoping_project_id": , l'ID progetto che ospita l'ambito delle metriche.
    "scoping_project_number": numero, il numero del progetto di definizione dell'ambito.
    "url": stringa, l'URL della console Google Cloud per questo incidente.
    "started_at": numero e tempo (in secondi dell'epoca Unix) in cui è stato aperto l'incidente.
    "ended_at": numero e tempo (in secondi dell'epoca Unix) in cui l'incidente è stato chiuso. Compilato solo quando state è closed.
    "state": stringa, stato dell'incidente: open o closed. Se open, il valore ended_at è null.
    "summary": stringa, un riepilogo testuale generato dell'incidente.
    "apigee_url": stringa, URL Apigee per questo incidente, solo per Apigee tipi di risorse Environment e Proxy*.
    "observed_value": la stringa, il valore osservato che ha attivato/risolto l'avviso, può sarà vuota se la condizione è scaduta.

    Informazioni sulla risorsa monitorata per cui è stato aperto l'incidente.

    "resource": {
      "type": stringa, identificatore del tipo di risorsa monitorata per il quale ricevere avvisi, ad esempio: gce_instance; vedi Elenco delle risorse monitorate.
      "labels": le coppie chiave/valore per le etichette associate alla risorsa monitorata.
    },
    "resource_type_display_name": stringa, il nome visualizzato del tipo di risorsa monitorata.
    "resource_id": stringa, ID istanza della risorsa monitorata, stesso valore di resource.labels.instance_id.
    "resource_display_name": stringa, il nome visualizzato della risorsa monitorata.
    "resource_name": stringa, nome generato della risorsa monitorata; è composto da valori di altri campi.

    Informazioni sul tipo di metrica dei dati delle serie temporali.

    "metric": {
      "type": stringa, identificatore del tipo di metrica per cui ricevere avvisi, ad esempio compute.googleapis.com/instance/cpu/utilization; consulta l'Elenco delle metriche.
      "displayName": stringa, il nome visualizzato del tipo di metrica.
      "labels": le coppie chiave/valore per le etichette associate alla metrica.
    },
    "metadata": {
      "system_labels": e coppie chiave/valore per le etichette dei metadati di sistema.
      "user_labels": e coppie chiave/valore per le etichette dei metadati utente.
    },

    Informazioni sul criterio e sulla condizione di avviso che ha aperto/risolto l'incidente.
    I valori sono tratti dalle metriche pertinenti . AlertPolicy.

    "policy_name": stringa, il nome visualizzato per il criterio di avviso.
    "policy_user_labels": un oggetto, le coppie chiave/valore per qualsiasi etichetta utente associata al criterio.
    "documentation": , una struttura incorporata del formato . Documentation
    "condition": , una struttura incorporata del formato . Condition
    "condition_name": stringa, il nome visualizzato della condizione, lo stesso valore di condition.displayName.
    "severity": la stringa, il livello di gravità degli incidenti. Se questo campo non viene definito durante la creazione del criterio di avviso, Cloud Monitoring imposta la gravità del criterio di avviso su No Severity.
    "threshold_value": il valore di soglia di questa condizione, potrebbe essere vuoto se la condizione non è una condizione soglia.
  },
}

Norme sul ritiro

Lo schema del payload è soggetto alle norme sul ritiro di Google Cloud descritte nella Sezione 1.4(d) dei Termini di servizio della piattaforma Google Cloud. Tieni presente che lo schema non controlla i formati dei valori dei campi generati, e questi formati possono cambiare senza preavviso. Ad esempio, incident.summary, incident.documentation.content e incident.url includere i dati relativi ai rispettivi campi, ma lo schema prevedono vincoli per garantire l'analisi accurata di questi campi. Puoi consuma il valore nel suo complesso e si aspetta che aderisca al ritiro ma non fare affidamento sull'analisi dei campi generati.

SMS

Per configurare le notifiche SMS, procedi nel seguente modo:

Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Modifica canali di notifica.
Nella sezione SMS, fai clic su Aggiungi nuovo.
Completa la finestra di dialogo e fai clic su Salva.

Quando configuri il criterio di avviso, seleziona la notifica SMS digita e scegli un numero di telefono verificato dall'elenco.

Slack

L'integrazione di Monitoring Slack consente i criteri da pubblicare su un canale Slack quando viene creato un nuovo incidente. Per configurare le notifiche Slack, segui questi passaggi:

In Slack: crea un'area di lavoro e un canale Slack nella Sito di Slack. Registra l'URL del canale.
Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Modifica canali di notifica.
Nella sezione Slack, fai clic su Aggiungi nuovo per aprire lo Pagina di accesso di Slack:
1. Seleziona la tua area di lavoro Slack.
2. Fai clic su Consenti per abilitare Cloud Monitoring alla tua area di lavoro Slack. Questa azione ti riporta Pagina di configurazione del monitoraggio per la tua notifica canale.
3. Nel campo Nome canale Slack, inserisci il nome del Canale Slack da utilizzare per le notifiche.
4. Nel campo Nome visualizzato per gli avvisi Cloud, inserisci una breve un'affermazione descrittiva. Il monitoraggio mostra il valore di questo campo nella pagina Canale notifiche.
5. (Facoltativo) Per testare la connessione tra Cloud Monitoring e l'area di lavoro Slack, fai clic Invia notifica di prova. Se la connessione viene stabilita, vedi un messaggio This is a test alert notification... in Canale di notifica Slack specificato. Controlla il canale di notifica per confermare la ricezione.
Se il canale Slack che vuoi utilizzare per le notifiche è un canale privato, dovrai invitare manualmente Monitoraggio dell'app sul canale:
1. Apri Slack.
2. Vai al canale che hai indicato come tuo Canale di notifica di monitoraggio.
3. Invita l'app Monitoring sul canale tramite il inserendo e inviando il seguente messaggio nel canale:
```
/invite @Google Cloud Monitoring
```
  Assicurati di invitare l'app Monitoring all'account privato canale che hai specificato durante la creazione del canale di notifica monitoraggio. Invitare l'app Monitoring ai canali pubblici è facoltativo.
Quando crei un criterio di avviso, seleziona Slack nel Notifiche e scegli la configurazione Slack.

Webhook

Per configurare le notifiche webhook, segui questi passaggi:

Il gestore webhook: identifica l'URL dell'endpoint pubblico da ricevere. i dati webhook da Monitoring.
Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Modifica canali di notifica.
Nella sezione Webhook, fai clic su Aggiungi nuovo.
Completa la finestra di dialogo.
Fai clic su Test Connection (Verifica connessione) per inviare un payload di test al webhook. endpoint. Puoi andare all'endpoint di destinazione per verificare il recapito.
Fai clic su Salva.

Quando crei un criterio di avviso, seleziona Webhook nel Notifiche e scegli la configurazione del webhook. Le notifiche inviate da Error Reporting seguono le Schema 1.0 mentre le notifiche inviate da Monitoring seguono Schema 1.2:

Esempi JSON

Ecco un esempio di pacchetto di questo tipo:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "No severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Struttura dello schema, versione 1.2

In un pacchetto restituito, i campi possono essere presenti in qualsiasi ordine. Nella descrizione che segue, sono organizzati in gruppi correlati.

Autenticazione di base

Oltre alla richiesta webhook inviata da Cloud Monitoring, L'autenticazione utilizza la specifica HTTP per il nome utente password. Cloud Monitoring richiede che il server restituisca un errore 401 con l'intestazione WWW-Authenticate corretta. Per ulteriori informazioni informazioni sull'autenticazione di base, consulta quanto segue:

Autenticazione token

L'autenticazione con token richiede un parametro della stringa di query nell'URL dell'endpoint e una chiave che il server si aspetta di essere segreto tra sé e Monitoring. Di seguito è riportato un URL di esempio che include un token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Se Monitoring pubblica un incidente nell'URL dell'endpoint, il server possa convalidare il token collegato. Questo metodo l'autenticazione è più efficace se utilizzata con SSL/TLS per crittografare la richiesta HTTP impedendo ai curiosi di apprendere il token.

Per un server di esempio in Python, vedi questo server di esempio.

Norme sul ritiro

Pub/Sub

Questa sezione descrive come configurare una notifica Pub/Sub canali. Per la ridondanza, ti consigliamo di creare più canali di notifica. Accoppiamento di Pub/Sub all'app mobile per la console Google Cloud È consigliato PagerDuty, webhook o Slack perché Pub/Sub utilizza un meccanismo di invio diverso.

Per configurare un canale di notifica Pub/Sub:

Abilita le API richieste e crea un argomento
Configurare il canale di notifica per un argomento
Autorizza un account di servizio
Impostare il canale di notifica in un criterio di avviso

Per comprendere lo schema dei dati, consulta Esempio di schema.

Per ricevere le notifiche di avviso, devi inoltre creare una delle seguenti sottoscrizioni: pull, push o BigQuery.

Se la sottoscrizione si trova in un progetto diverso dall'argomento, creare un account di servizio nel progetto del sottoscrittore e concedere a quest'ultimo ruolo di roles/pubsub.subscriber.

Prima di iniziare

Quando aggiungi il primo canale di notifica Pub/Sub a un progetto Google Cloud, Cloud Monitoring crea un account di servizio per quel progetto. it concede anche il ruolo Identity and Access Management Agente di servizio Notifiche di Monitoring all'account di servizio. Questo account di servizio consente a Monitoring di inviare notifiche ai canali di notifica basati su Pub/Sub in questo progetto.

L'account di servizio ha il seguente formato:

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

Il nome dell'account di servizio delle notifiche include un numero univoco di progetto Google Cloud. Puoi trovare il nome, l'ID e il numero del progetto della dashboard del progetto nella console Google Cloud oppure può recuperarlo con il comando seguente:

gcloud projects describe PROJECT_ID --format="value(project_number)"

Puoi visualizzare e modificare l'account di servizio utilizzando il console Google Cloud o Google Cloud CLI.

Abilita le API richieste e crea un argomento

Nel progetto Google Cloud in cui prevedi di creare il canale di notifica e Pub/Sub, segui questi passaggi:

Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Abilita le API Pub/Sub and Cloud Monitoring.

Abilita le API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

Abilita le API Pub/Sub and Cloud Monitoring.

Abilita le API

Creare un argomento Pub/Sub. Per informazioni su come creare un argomento, consulta Crea un argomento. Ad esempio, per creare un argomento chiamato notificationTopic con Google Cloud CLI, esegui questo comando:
```
gcloud pubsub topics create notificationTopic
```

Configura quindi i canali di notifica Pub/Sub.

Configurare le notifiche per un argomento

Per creare un canale di notifica Pub/Sub, puoi utilizzare API Monitoring, Google Cloud CLI o nella console Google Cloud. Dopo aver creato la notifica canale, autorizza l'account di servizio delle notifiche a pubblica ogni argomento che utilizzi come canale di notifica.

Per informazioni sull'utilizzo dell'API Monitoring o Google Cloud CLI per creare il canale di notifica; consulta Creazione di canali.

Per utilizzare la console Google Cloud per creare il canale di notifica: procedi nel seguente modo:

Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Seleziona il progetto Google Cloud che contiene l'argomento Pub/Sub che hai creato.
Fai clic su Modifica canali di notifica.
Nella sezione Pub/Sub, fai clic su Aggiungi nuovo.

Nella finestra di dialogo Canale Pub/Sub creato viene visualizzato il nome l'account di servizio che Monitoring è stato creato.
Autorizza l'account di servizio. Il tuo account di servizio può pubblicare tutti gli argomenti o argomenti specifici:
- Per pubblicare tutti gli argomenti, seleziona Gestisci ruoli, e aggiungi il ruolo Publisher Pub/Sub.
  
  Dopo aver completato questi passaggi per la configurazione della notifica, canale, salta la sezione successiva, intitolata Autorizza l'account di servizio e procedi con Imposta il canale di notifica in un criterio di avviso.
- Per pubblicare argomenti specifici, vai al passaggio successivo e autorizzare l'account di servizio a pubblicare argomenti specifici dopo hai completato la configurazione del canale di notifica. Per istruzioni per autorizzare l'account di servizio, Autorizza account di servizio.
Inserisci un nome visualizzato per il tuo canale e la Nome dell'argomento Pub/Sub.
(Facoltativo) Per verificare che il canale sia configurato correttamente: Fai clic su Invia notifica di prova.
Seleziona Aggiungi canale.

Successivamente, autorizza l'account di servizio.

Autorizza account di servizio

L'autorizzazione consente all'account di servizio delle notifiche pubblicare ogni argomento Pub/Sub che utilizzi come canale di notifica. In questa sezione viene descritto come effettuare le seguenti operazioni:

Autorizza un account di servizio per un argomento specifico.
Autorizza un account di servizio per tutti gli argomenti.

Autorizza un account di servizio per un argomento specifico

Puoi autorizzare un account di servizio a pubblicare un argomento specifico utilizzando la console Google Cloud e Google Cloud CLI. Questa sezione descrive entrambi gli approcci.

Per autorizzare il tuo account di servizio per un argomento specifico utilizzando nella console Google Cloud, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Argomenti:
Vai ad Argomenti.

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Pub/Sub
Seleziona l'argomento.
Nella scheda Autorizzazioni, seleziona Aggiungi entità.
Nel campo Nuova entità, inserisci il nome delle notifiche l'account di servizio. L'account di servizio ha i seguenti nomi convenzione:
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Seleziona il ruolo Publisher Pub/Sub, quindi Salva.

Per autorizzare il tuo account di servizio per un argomento specifico utilizzando Google Cloud CLI, concedi l'pubsub.publisher ruolo IAM per l'argomento all'account di servizio. Ad esempio, il seguente comando configura Ruolo IAM per l'argomento notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

Una risposta alla riuscita esecuzione del Il comando add-iam-policy-binding è simile al seguente:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1

Per ulteriori informazioni, consulta il pubsub topics add-iam-policy-binding pagina di riferimento.

Autorizza un account di servizio per tutti gli argomenti

Per autorizzare l'account di servizio per tutti gli argomenti:

Nella console Google Cloud, vai alla pagina IAM:
Vai a IAM

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo IAM e Console di amministrazione.
Seleziona Includi concessioni dei ruoli fornite da Google come mostrato in la seguente immagine:
Cerca l'account di servizio con il seguente formato:
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Ricarica la pagina quando l'account di servizio non è presente nell'elenco.
Seleziona Modifica per il servizio di notifica account, seleziona Aggiungi un altro ruolo e aggiungi il ruolo Publisher Pub/Sub.

Imposta quindi il canale di notifica in un criterio di avviso.

Impostare il canale di notifica in un criterio di avviso

Per utilizzare un canale di notifica Pub/Sub in un criterio di avviso, seleziona Pub/Sub come tipo di canale, e seleziona l'argomento.

Esempio di schema

Per visualizzare un pacchetto JSON di esempio e lo schema, espandi quanto segue sezioni.

Esempi JSON

Ecco un esempio di pacchetto di questo tipo:


{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "No severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity"
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Struttura dello schema, versione 1.2

In un pacchetto restituito, i campi possono essere presenti in qualsiasi ordine. Nella descrizione che segue, sono organizzati in gruppi correlati.

Norme sul ritiro

Google Chat

L'app Google Cloud Monitoring consente ai tuoi spazi di Google Chat di ricevere notifiche.

Prima di iniziare

Se fai parte di un'organizzazione, per installare Google Cloud Monitoring, devi avere accesso l'app Google Cloud Monitoring. Se non hai accesso, richiedi a un amministratore di Google Workspace di:

Installa l'app Google Cloud Monitoring

Devi seguire la procedura seguente per installare l'app Google Cloud Monitoring. L'installazione dal Scheda di Google Workspace Marketplace non è supportato.

Per installare l'app e configurare uno spazio come canale di notifica, procedi nel seguente modo:

In Google Chat, apri o crea lo spazio in cui vuoi ricevere notifiche.
Installa l'app Google Cloud Monitoring:
1. Seleziona il nome dello spazio, quindi App e integrazioni.
2. Se l'app Google Cloud Monitoring non compare nell'elenco delle app, quindi torna nel tuo spazio, inserisci @Google Cloud Monitoring e infine premi Invio.
3. Fai clic su Aggiungi allo spazio.
Copia l'ID dello spazio di Chat negli appunti.

Se hai installato l'app Google Cloud Monitoring, lo spazio di chat L'ID è incluso nella conferma dell'installazione. In caso contrario, possono trovare l'ID dello spazio di Chat sotto forma di serie di numeri e lettere gli utenti che seguono space/ alla fine dell'URL del tuo spazio di Chat.
Apri una nuova scheda del browser e configura il canale di notifica:
1. Nella console Google Cloud, vai alla Pagina Avvisi:
  Vai ad Avvisi
  
  Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
2. Fai clic su Modifica canali di notifica.
3. Vai alla sezione Google Chat e fai clic su Aggiungi nuovo.
4. Inserisci l'ID dello spazio di Chat nel campo ID spazio di Chat e fai clic su Salva.

Creare un canale on demand

Quando aggiungi un canale di notifica a un criterio di avviso, devi selezionare un canale da un elenco. Per aggiornare l'elenco delle opzioni quando sei creando un criterio di avviso, usa la seguente procedura:

Nella finestra di dialogo di notifica, fai clic su Gestisci canali di notifica. Si apre la finestra Canali di notifica in una nuova scheda del browser.
Per aggiungere un nuovo canale di notifica, individua il tipo di canale e fai clic su Aggiungi nuovo e segui le istruzioni specifiche per il canale riportate. nella tabella precedente.
Torna alla scheda originale e, nella finestra di dialogo di notifica, fai clic su Aggiorna.
Seleziona il canale di notifica dall'elenco aggiornato.

Ricevere notifiche su un canale non supportato

Se il tuo canale di notifica preferito non è supportato, valuta la possibilità di creare una pipeline basata sull'invio di notifiche a Pub/Sub. Per un esempio Python che utilizza Flask, consulta Creazione di notifiche personalizzate con Cloud Monitoring e Cloud Run. Per altri esempi, consulta Repository Git cloud-alerting-notification-forwarding

Testare un canale di notifica

Cloud Monitoring non supporta un'opzione di test per i canali di notifica. Tuttavia, puoi verificare che un canale di notifica sia configurato correttamente creando un criterio di avviso e configurando la condizione da soddisfare.

Per testare manualmente i canali di notifica, puoi: creare un criterio di avviso che monitori l'utilizzo della CPU di una delle tue istanze di macchine virtuali (VM):

(Facoltativo) Se non hai ancora una VM nel tuo progetto Google Cloud o vuoi utilizzare una VM diversa per i test, quindi crea una VM:
1. Nella console Google Cloud, vai alla pagina Istanze VM:
  Vai a Istanze VM
  
  Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Compute Engine.
2. Seleziona Crea istanza, quindi configura la tua VM. Per ulteriori informazioni informazioni sulla creazione delle VM, consulta Crea un'istanza VM da un'immagine pubblica.
Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Seleziona Crea criterio.
Utilizza il menu Seleziona una metrica per selezionare la metrica Utilizzo CPU. per un'istanza VM.
Fai clic su Aggiungi filtro e aggiungi un filtro per la tua VM.
Aggiorna i campi Configura trigger come segue:
1. Seleziona Al di sotto della soglia per il campo Posizione soglia.
2. Seleziona un valore superiore all'utilizzo della CPU per in esecuzione in un'istanza Compute Engine. Ad esempio, se il grafico mostra l'utilizzo della CPU a essere di circa il 5%, quindi impostare la soglia su 10%.
  
  Queste impostazioni configurano la condizione da soddisfare quando l'utilizzo della CPU di un'istanza VM è inferiore alla soglia specificata. Perché la soglia sia superiore all'utilizzo della CPU Istanza VM, la condizione del criterio di avviso è soddisfatta.
Aggiungi i canali di notifica alle tue norme.
Espandi Durata chiusura automatica incidente e seleziona 30 min.
Inserisci il nome del criterio e fai clic su Crea criterio.
Una volta soddisfatta la condizione, verifica di aver ricevuto una notifica il ogni canale di notifica.
Elimina il criterio di avviso. L'incidente viene chiuso automaticamente dopo la durata della chiusura automatica scade.
Se hai creato un'istanza VM per questo test, eliminala.

Se non ricevi le notifiche previste, puoi: cerca in Esplora log le voci di log con informazioni sull'elemento notifiche. Per ulteriori informazioni, vedi Le notifiche non vengono ricevute.

Modificare ed eliminare i canali di notifica

Per modificare o eliminare un canale di notifica utilizzando la console Google Cloud: procedi nel seguente modo:

Nella console Google Cloud, vai alla Pagina Avvisi:
Vai ad Avvisi

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoraggio.
Fai clic su Modifica canali di notifica.

La dashboard Canali di notifica contiene una sezione per ogni tipo di canale di notifica. Ogni sezione elenca tutte le configurazioni del tipo:
- Per modificare una voce, fai clic su Modifica. Fai clic su Salva dopo le modifiche sono state completate.
- Per eliminare una voce, fai clic su Elimina. Clic Elimina nella finestra di dialogo di conferma.

Visualizza i log del canale di notifica

Puoi utilizzare Esplora log per visualizzare gli errori del canale di notifica:

Nella console Google Cloud, vai alla pagina Esplora log:
Vai a Esplora log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Inserisci ed esegui la query. Per query specifiche sugli errori del canale di notifica, consulta Query di Cloud Monitoring.

Passaggi successivi

Per informazioni sugli incidenti, consulta i seguenti documenti: