Raccogliere i dati sugli errori utilizzando Error Reporting

Questo documento elenca gli ambienti supportati da Error Reporting e contiene link a guide specifiche per lingua per gli sviluppatori di applicazioni. Ti consigliamo di utilizzare le librerie client specifiche per il linguaggio o di fare affidamento sulle voci di log raccolte automaticamente. Tuttavia, puoi scrivere i dati di errore con l'API Cloud Logging o l'API Error Reporting. Ad esempio, se utilizzi Cloud Run, le eccezioni scritte in stderr vengono inviate automaticamente a Cloud Logging.

Error Reporting è un servizio globale basato su Cloud Logging e può analizzare le voci di log quando si verificano tutte le seguenti condizioni:

  • I workload Assured sono disattivati. Per ulteriori informazioni, consulta la Panoramica di Assured Workloads.
  • Le chiavi di crittografia gestite dal cliente (CMEK) sono disattivate in tutti i bucket dei log che memorizzano la voce di log. Per informazioni su come determinare la configurazione CMEK per un bucket di log, consulta Verificare l'attivazione della chiave.
  • Il bucket dei log soddisfa una delle seguenti condizioni:
    • Il bucket dei log viene archiviato nello stesso progetto in cui hanno avuto origine le voci di log.
    • Le voci di log sono state instradate a un progetto, che le ha archiviate in un bucket di log di sua proprietà.
Se archivi le voci di log in bucket di log con la CMEK abilitata, puoi comunque utilizzare Error Reporting. Tuttavia, devi utilizzare le librerie client o l'API Error Reporting. Per saperne di più, consulta la panoramica dell'API Error Reporting e le librerie client Error Reporting.

Assistenza Virtual Private Cloud

Error Reporting è un servizio supportato da Virtual Private Cloud (VPC).

Per ridurre il rischio di esfiltrazione di dati, utilizza i Controlli di servizio VPC per creare un perimetro di servizio attorno ai servizi gestiti da Google. Per informazioni sui Controlli di servizio VPC e su come creare un parametro di servizio, consulta la documentazione dei Controlli di servizio VPC.

Configura gli ambienti in modo che registrino automaticamente i dati sugli errori

Per informazioni sui requisiti di configurazione specifici per l'ambiente, consulta le seguenti guide:

Esegui l'instrumentazione delle app utilizzando le librerie client

Per informazioni su come configurare l'applicazione per inviare report sugli errori, consulta le guide alla configurazione specifiche per il linguaggio:

Scrivere i dati di errore utilizzando un'API

Puoi segnalare gli eventi di errore al tuo progetto Google Cloud eseguendo il metodo dell'API Error Reporting report o il metodo dell'API Cloud Logging write.

  • Se hai bisogno di autenticazione basata su chiave API, devi utilizzare l'API Error Reporting. Per segnalare un evento di errore utilizzando l'API Error Reporting, esegui il metodo report e formatta il corpo della richiesta del metodo come oggetto ReportedErrorEvent.

    Quando utilizzi l'API Error Reporting, le voci di log con messaggi di errore formattati correttamente vengono generate e scritte automaticamente in Cloud Logging. Queste voci di log vengono scritte in un log logName il cui formato è il seguente:

    projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors

    Poiché le voci di log vengono generate dalle chiamate a report, potresti incorrere in costi di importazione di Cloud Logging. Per controllare quali voci di log vengono importate, consulta Filtri di esclusione.

    Se segnali gli eventi di errore utilizzando l'API Error Reporting, il resto di questo documento non si applica.

  • Se vuoi utilizzare l'API Cloud Logging, devi formattare l'oggetto LogEntry in modo che includa una analisi dello stack o un oggetto ReportedErrorEvent. Per ulteriori informazioni sui requisiti di formattazione, consulta Errori di formato nei log.