Configurare e gestire 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 in un progetto Google Cloud si verifica per la prima volta un errore che non può essere raggruppato con gli errori precedenti.

• Se si verifica nuovamente un errore che era stato contrassegnato come Risolto.

Gestisci canali di notifica

Puoi creare, modificare ed eliminare i canali di notifica in Monitoraggio. Dopo aver creato i canali di notifica, puoi configurare Error Reporting in modo che li utilizzi.

Error Reporting ti consente di scegliere tra quattro tipi di canali di notifica: email, mobile, 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 Editor di monitoraggio (roles/monitoring.editor) nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

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

Creare un canale di notifica

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

Email

Per aggiungere un canale di notifica via email:

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 Monitoring.

2. Fai clic su Modifica canali di notifica.
3. Nella sezione Email, fai clic su Aggiungi nuova.
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 della console Google Cloud per monitorare le risorse della console Google Cloud e le informazioni di monitoraggio da qualsiasi luogo. Le notifiche dell'app mobile Google Cloud Console vengono inviate a un dispositivo 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 sul dispositivo, il campo Nome visualizzato include le informazioni del dispositivo.
• Utente indica che le notifiche vengono inviate a tutti i tuoi 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 per app mobile della console Google Cloud per un progetto Google Cloud specifico, procedi nel seguente modo:

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

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

   Dopo aver selezionato un progetto, avviene uno scambio di dati tra l'app e il progetto Google Cloud selezionato. Se non esiste un canale di notifica, viene creato uno nuovo e dopo alcuni minuti viene visualizzato 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 degli avvisi, seleziona Console Google Cloud (dispositivo mobile) e poi scegli il tuo dispositivo mobile dall'elenco.

Slack

Nota: per completare questi passaggi, devi essere un proprietario o un amministratore di uno spazio di lavoro Slack. Per saperne di più, consulta la sezione Gestire le richieste di invito.

Per configurare le notifiche di Slack:

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

2. 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 Monitoring.

3. Fai clic su Modifica canali di notifica.

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

   1. Seleziona il tuo spazio di lavoro di Slack.
   2. Fai clic su Consenti per consentire a Cloud Monitoring di accedere alla tua area di lavoro Slack. Questa azione ti riporta alla pagina di configurazione del monitoraggio per il 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 di Cloud Alerting, inserisci una breve dichiarazione descrittiva. Il monitoraggio mostra il valore di questo campo nella pagina Canale di notifiche.
   5. (Facoltativo) Per testare la connessione tra Cloud Monitoring e la tua area di lavoro Slack, fai clic su Invia notifica di test. Se la connessione è andata a buon fine, viene visualizzato un messaggio This is a test alert notification... nel canale di notifica di Slack che hai specificato. Controlla il canale di notifica per confermare la ricezione.

5. Se il canale Slack che vuoi utilizzare per le notifiche è un canale privato, devi invitare manualmente l'app di monitoraggio al canale:

   1. Apri Slack.

   2. Vai al canale specificato come canale di notifica per il monitoraggio.

   3. Invita l'app di monitoraggio al canale inserendo e inviando il seguente messaggio:

      /invite @Google Cloud Monitoring

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

Webhook

Prima di configurare un canale di notifica Webhook, tieni presente quanto segue:

• Gli webhook supportano solo gli endpoint pubblici.
• Se una funzione Cloud Run è configurata come endpoint webhook per un canale di notifica, assicurati che l'utente che richiama la funzione disponga dell'autorizzazione di autenticazione richiesta. Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'invocazione e Attivare l'accesso a una funzione.
• I canali di notifica Webhook non sono compatibili con Microsoft Teams. Per inviare i dati di notifica dal monitoraggio a Microsoft Teams, crea un livello di integrazione per ricevere l'webhook di monitoraggio e poi reindirizzarlo a Microsoft Teams.

Configurare i canali di notifica webhook

Per configurare le notifiche Webhook:

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

2. 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 Monitoring.

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 (Prova connessione) per inviare un payload di test all'endpoint Webhook. Puoi andare 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": una stringa che descrive il gruppo di errori nuovo o riaperto.
  "group_info": {
    "project_id": progetto proprietario del gruppo di errori.
    "detail_link": stringa, link alla pagina Dettagli segnalazione errori per il gruppo di errori.
  },
  "exception_info": {
    "type": tipo di stringa dell'eccezione registrata nell'evento.
    "message": una stringa, il 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 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 ulteriori informazioni sull'autenticazione di base, consulta quanto segue:

• Specifiche RFC
• Autenticazione di base

Autenticazione token

L'autenticazione dei token richiede un parametro di stringa di query nell'URL dell'endpoint e una chiave che il server si aspetta sia segreta tra sé e il monitoraggio. Di seguito è riportato un URL di esempio che include un token:

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

Se il monitoraggio pubblica un incidente nell'URL dell'endpoint, il tuo server può convalidare il token allegato. Questo metodo di autenticazione è più efficace se utilizzato con SSL/TLS per criptare la richiesta HTTP e impedire agli utenti malintenzionati 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, segui questi passaggi:

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 Monitoring.

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 il canale è 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 la pagina relativa alla creazione e gestione dei canali di notifica tramite API.

Selezionare i canali di notifica tramite la console Google Cloud

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

• Utente Error Reporting
• Amministratore Error Reporting
• Project Editor
• Proprietario progetto

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

1. Nella console Google Cloud, vai alla pagina Error Reporting:

   Vai a Error Reporting

   Puoi trovare questa pagina anche utilizzando la barra di ricerca.

2. Fai clic su Configura 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 vedi il canale che ti serve, fai clic su Gestisci canali di notifica per crearne uno nuovo. Per creare un canale di notifica, il tuo ruolo deve essere uno di quelli elencati in Creare canali.

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

Informazioni aggiuntive

Di seguito sono riportate ulteriori informazioni che si applicano alla creazione e alla gestione delle notifiche in Error Reporting.

Contenuti delle notifiche

Le notifiche per i gruppi di errori contengono informazioni relative alle voci del log nel gruppo. Le informazioni incluse dipendono dal tipo di risorsa monitorata in cui si è verificato l'errore. Ad esempio, alcune notifiche potrebbero contenere il nome e la versione della risorsa monitorata.

Il messaggio di errore viene incluso nella notifica solo quando il gruppo di errori viene identificato dalle voci di log in un bucket di log la cui regione è global.

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 del ritiro dei dati, genera una notifica se si verifica un altro errore.

Limite di frequenza delle notifiche

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

• In un periodo di 60 minuti è possibile inviare al massimo 5 notifiche a causa di un errore.

• Se si verificano più di 5 errori in una finestra di 60 minuti, si verifica quanto segue:

  • Riceverai una notifica che ti informa che le notifiche successive verranno disattivate 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 notifiche relative al gruppo vengono sospese per cinque minuti.

Stato di risoluzione

Se si verifica nuovamente un errore con stato di risoluzione Risolto, anche se è stato precedentemente eliminato, lo stato di risoluzione torna a Aperto e Error Reporting invia una notifica.

Error Reporting non invierà una notifica se si ripresenta un errore di Disattivazione audio.

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

Notifiche mobile

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

Scaricare l'app Google Cloud