Raccogliere i dati di errore utilizzando Error Reporting

Questo documento elenca gli ambienti supportati da Error Reporting e presenta link a guide specifiche per i vari linguaggi per gli sviluppatori di applicazioni. Consigliamo di utilizzare le librerie client specifiche per le lingue o di utilizzare i log raccolti automaticamente; tuttavia, puoi scrivere dati sugli errori 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 che analizza automaticamente i log nel progetto Google Cloud per identificare errori. Tuttavia, Error Reporting può analizzare solo le voci di log archiviate nei bucket Cloud Logging che si trovano nella regione global, in cui i progetti Google Cloud di origine e di destinazione coincidono e le chiavi di crittografia gestite dal cliente (CMEK) disattivate. Se esegui il routing dei log a un progetto Google Cloud diverso, a un bucket a livello di regione o se abiliti CMEK, Error Reporting non acquisisce e analizza questi log. Per informazioni su come verificare la configurazione dei bucket di log, consulta la sezione Risoluzione dei problemi.

Supporto di 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 intorno ai servizi gestiti da Google. Per informazioni sui Controlli di servizio VPC e su come creare un parametro di servizio, consulta la documentazione di Controlli di servizio VPC.

Configurare gli ambienti per la segnalazione automatica dei dati di errore

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

Strumenta le app utilizzando le librerie client

Per informazioni su come configurare l'applicazione per l'invio dei report sugli errori, consulta le guide di configurazione specifiche della lingua:

Scrivere i dati di errore utilizzando un'API

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

  • Se hai bisogno dell'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 il cui logName è formattato come segue:

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

    Poiché le voci di log vengono generate dalle chiamate a report, potrebbero essere addebitati costi per l'importazione di Cloud Logging. Per controllare quali log vengono importati, consulta Filtri di esclusione.

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

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