Configura e gestisci le notifiche

Puoi configurare Error Reporting in modo che invii notifiche di errore ai canali di notifica di Cloud Monitoring selezionati.

Error Reporting invia notifiche nei seguenti casi:

• Quando un errore si verifica per la prima volta in un progetto Google Cloud e non può essere raggruppato con errori precedenti.

• Se si verifica nuovamente un errore contrassegnato come Risolto.

Gestisci canali di notifica

Puoi creare, modificare ed eliminare i canali di notifica in Monitoring. Dopo aver creato i canali di notifica, puoi configurare Error Reporting in modo da utilizzarli.

Error Reporting ti consente di scegliere tra quattro tipi di canali di notifica: email, dispositivi mobili, Slack e webhook.

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 il ruolo IAM Monitoring Editor (roles/monitoring.editor) sul tuo progetto. Per saperne di più sulla concessione dei ruoli, vedi Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

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

Crea canale di notifica

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:

1. Nella console Google Cloud, seleziona Monitoring, quindi seleziona  Avvisi oppure fai clic sul pulsante seguente:

   Vai ad Avvisi

2. Fai clic su Modifica canali di notifica.
3. Nella sezione Email, fai clic su Aggiungi nuovo.
4. Inserisci un singolo indirizzo email e una descrizione.
5. Fai clic su Salva.

Se utilizzi un indirizzo email di gruppo come canale di notifica per un criterio di avviso, configura il gruppo in modo che accetti la posta da [e-mail].

App per dispositivi mobili

Utilizza l'app mobile Google Cloud Console per monitorare le risorse della console Google Cloud e le informazioni di Monitoring ovunque ti trovi. Le notifiche dell'app per dispositivi mobili per la console Google Cloud vengono inviate a un dispositivo specifico o a un utente specifico:

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

Cloud Monitoring determina l'ambito delle notifiche al momento della creazione del canale. Non puoi selezionare o modificare l'ambito.

Per configurare un canale di notifica dell'app mobile Google Cloud per un progetto Google Cloud specifico:

1. Installa l'app mobile Google Cloud Console dallo store del tuo dispositivo mobile.

2. Seleziona un progetto da visualizzare nell'app mobile Google Cloud Console.

   Dopo aver selezionato un progetto, si verifica uno scambio di dati tra l'app e il progetto Google Cloud selezionato. Se non ne esiste uno, viene creato un canale di notifica che, dopo alcuni minuti, viene elencato nella sezione Dispositivi mobili della pagina Canali di notifica.

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

Slack

Nota: per completare questi passaggi, devi essere un proprietario o un amministratore di Slack Workspace. Per saperne di più, vedi Gestire le richieste di invito.

Per configurare le notifiche Slack:

1. In Slack: crea un'area di lavoro e un canale Slack sul sito di Slack. Registra l'URL del canale.

2. Nella console Google Cloud, seleziona Monitoring, quindi seleziona  Avvisi oppure fai clic sul pulsante seguente:

   Vai ad Avvisi

3. Fai clic su Modifica canali di notifica.

4. Nella sezione Slack, fai clic su Aggiungi nuovo per aprire la pagina di accesso di Slack:

   1. Seleziona la tua area di lavoro Slack.
   2. Fai clic su Consenti per abilitare l'accesso di Cloud Monitoring all'area di lavoro di Slack. Questa azione ti riporta alla pagina di configurazione di Monitoring per il tuo canale di notifica.
   3. Nel campo Nome canale Slack, inserisci il nome del canale Slack che vuoi utilizzare per le notifiche.
   4. Nel campo Nome visualizzato avviso Cloud, inserisci una breve istruzione descrittiva. Monitoring mostra il valore di questo campo sulla pagina Canale notifiche.
   5. (Facoltativo) Per testare la connessione tra Cloud Monitoring e l'area di lavoro di Slack, fai clic su Invia notifica di test. Se la connessione ha esito positivo, viene visualizzato il messaggio This is a test alert notification... nel canale di notifica Slack specificato. Controlla il canale di notifica per confermare la ricezione.

5. Se il canale Slack che vuoi utilizzare per le notifiche è privato, devi invitare manualmente l'app Monitoring nel canale:

   1. Apri Slack.

   2. Vai al canale specificato come canale di notifica di Monitoring.

   3. Invita l'app Monitoring nel canale inserendo e inviando il seguente messaggio nel canale:

      /invite @Google Cloud Monitoring

      Assicurati di invitare l'app Monitoring al canale privato specificato durante la creazione del canale di notifica in Monitoring. L'invito dell'app Monitoring a canali pubblici è facoltativo.

Webhook

Nota: i webhook supportano solo gli endpoint pubblici.

Nota: se una Cloud Function è configurata come endpoint webhook per un canale di notifica, assicurati che l'utente che richiama la funzione disponga dell'autorizzazione di autenticazione richiesta. Per maggiori informazioni, consulta Autenticazione della funzione per le chiamate delle funzioni e Abilitazione dell'accesso a una funzione.

Per configurare le notifiche webhook, segui questi passaggi:

1. Il gestore webhook: identifica l'URL dell'endpoint pubblico per ricevere i dati dei webhook da Monitoring.

2. Nella console Google Cloud, seleziona Monitoring, quindi seleziona  Avvisi oppure fai clic sul pulsante seguente:

   Vai ad Avvisi

3. Fai clic su Modifica canali di notifica.
4. Nella sezione Webhook, fai clic su Aggiungi nuovo.
5. Completa la finestra di dialogo.
6. Fai clic su Test Connection per inviare un payload di test all'endpoint webhook. Puoi accedere all'endpoint di ricezione per verificare la consegna.
7. Fai clic su Salva.

Schema webhook

Per visualizzare la struttura dello schema webhook per Error Reporting, fai clic su quanto segue:

Struttura dello schema, versione 1.0

{
  "version": "1.0",
  "subject": stringa, descrizione del gruppo di errori nuovo o riaperto.
  "group_info": {
    "project_id": stringa, progetto a cui appartiene il gruppo di errori.
    "detail_link": stringa, link alla pagina Dettagli di Error Reporting per il gruppo di errori.
  },
  "exception_info": {
    "type": stringa, tipo di eccezione registrata nell'evento.
    "message": stringa, messaggio di eccezione per l'evento.
  },
  "event_info": {
    "log_message": stringa
    "request_method": stringa
    "request_url": stringa
    "referrer": stringa
    "user_agent": stringa
    "service": stringa
    "version": stringa
    "response_status": stringa
  },
}

Autenticazione di base

Oltre alla richiesta di webhook inviata da Cloud Monitoring, l'autenticazione di base utilizza la specifica HTTP per il nome utente e la password. Cloud Monitoring richiede che il server restituisca una risposta 401 con l'intestazione WWW-Authenticate corretta. Per saperne di più sull'autenticazione di base, vedi quanto segue:

• Specifiche RFC
• Autenticazione di base

Autenticazione token

L'autenticazione dei token richiede un parametro della stringa di query nell'URL dell'endpoint e una chiave che il server prevede di essere segreta tra se stesso 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 relativo all'URL dell'endpoint, il server può convalidare il token associato. Questo metodo di autenticazione è più efficace se viene utilizzato con SSL/TLS per criptare la richiesta HTTP e che impedisce agli snooper di apprendere il token.

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

Modificare ed eliminare i canali di notifica

Per modificare o eliminare un canale di notifica utilizzando la console Google Cloud:

1. Nella console Google Cloud, seleziona Monitoring, quindi seleziona  Avvisi oppure fai clic sul pulsante seguente:

   Vai ad Avvisi

2. 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 per quel tipo:

   • Per modificare una voce, fai clic su Modifica. Fai clic su Salva al termine delle modifiche.
   • Per eliminare una voce, fai clic su Elimina. Fai clic su Elimina nella finestra di dialogo di conferma.

Nota: non puoi eliminare un canale di notifica utilizzando la console Google Cloud se associato a un criterio di avviso. Tuttavia, puoi eliminare il canale utilizzando Google Cloud CLI o l'API Cloud Monitoring. Per saperne di più, consulta Creare e gestire canali di notifica in base all'API.

Selezionare i canali di notifica tramite la console Google Cloud

Per selezionare un canale di notifica esistente, devi avere uno dei seguenti ruoli:

• Errore durante la segnalazione dell'utente
• Amministratore di Error Reporting
• Editor progetto
• Proprietario progetto

Per selezionare dove inviare notifiche quando si verificano nuovi gruppi di errori, completa i seguenti passaggi.

1. Nella console Google Cloud, seleziona Error Reporting oppure fai clic sul pulsante seguente e seleziona un progetto:

   Vai a Error Reporting

2. Fai clic su Configura le notifiche per aprire la pagina Notifiche di errore.

3. Nel menu a discesa Canali di notifica, seleziona i canali a cui vuoi inviare le notifiche.

   Se non trovi il canale di cui hai bisogno, fai clic su Gestisci canali di notifica per creare un nuovo canale. Per creare un canale di notifica, il tuo ruolo deve essere uno di quelli elencati nella sezione Creazione di canali.

4. Dopo aver selezionato i canali, fai clic su Salva.

Informazioni aggiuntive

Di seguito sono riportate informazioni aggiuntive che si applicano durante la creazione e la gestione delle notifiche in Error Reporting.

Quando vengono inviate le notifiche

Error Reporting invia una notifica in due casi:

• Quando il gruppo di errori non è mai stato rilevato da Error Reporting.
• Quando si verifica un errore per un gruppo di errori esistente e lo stato del gruppo di errori è impostato su Resolved.

Per ricevere notifiche future per il gruppo di errori, devi impostare lo stato del gruppo di errori su Resolved. Nessun'altra azione, come l'utilizzo dell'API per eliminare il gruppo di errori o l'attesa della scadenza dei dati, genera una notifica se si verifica un altro errore.

Limite frequenza di notifica

Error Reporting utilizza le seguenti regole per limitare il numero di notifiche che potresti ricevere a causa di errori:

• A causa di un errore, possono essere inviate al massimo 5 notifiche in un periodo di 60 minuti.

• Se si verificano più di cinque errori in un periodo di 60 minuti, si verifica quanto segue:

  • Riceverai una notifica che ti informa che ulteriori notifiche saranno silenziate per le prossime sei ore.

  • Viene scritta una voce di log con il livello di gravità dell'avviso.

• Quando risolvi un gruppo di errori, le relative notifiche vengono sospese per cinque minuti.

Stato di risoluzione

Se si verifica di nuovo un errore con stato di risoluzione Risolto anche se è stato eliminato in precedenza, lo stato della risoluzione torna a Aperto ed Error Reporting invia una notifica.

Error Reporting non invia una notifica se si verifica nuovamente un errore con audio disattivato.

Per gestire lo stato di risoluzione degli errori, vai a Gestire gli errori.

Notifiche mobile

Error Reporting invia notifiche mobile all'app Google Cloud su Android e iOS. Per attivare le notifiche mobile, devi prima installare l'app sul tuo dispositivo mobile:

Scaricare l'app Google Cloud