Configurazione di Error Reporting per .NET

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Puoi inviare report sugli errori alle applicazioni di Error Reporting dalle applicazioni .NET utilizzando il set di librerie Google.Cloud.Diagnostica.

Error Reporting è integrato con alcuni servizi Google Cloud, come App Engine, Compute Engine e Google Kubernetes Engine. Error Reporting visualizza gli errori registrati in Cloud Logging dalle applicazioni in esecuzione su tali servizi. Per ulteriori informazioni, consulta la pagina In esecuzione su Google Cloud Platform in questa pagina.

Puoi anche inviare i dati di errore a Error Reporting utilizzando Logging. Per informazioni sui requisiti di formattazione dei dati, consulta Formattazione dei messaggi di errore in Logging.

Prima di iniziare

  1. 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.
  2. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

  4. Attiva Error Reporting API .

    Abilita l'API

  5. Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  6. Assicurati che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata su un progetto.

  7. Attiva Error Reporting API .

    Abilita l'API

Installare la libreria client

Il set di librerie di Google Cloud.Cloud ti consente di monitorare e visualizzare gli errori segnalati dalle applicazioni .NET in esecuzione praticamente ovunque.

  1. Per le applicazioni destinate ad ASP.NET Core 3 o versioni successive, utilizza la libreria Google.Cloud.Diagnostics.AspNetCore3. Puoi installare questa libreria da NuGet.
  2. Per le applicazioni che hanno come target versioni precedenti di ASP.NET Core, utilizza la libreria Google.Cloud.Diagnostics.AspNetCore. Puoi installare questa libreria da NuGet.
  3. Per le applicazioni destinate a framework non ASP.NET Core, utilizza la libreria Google.Cloud.Diagnostics.Common. Puoi installare questa libreria da NuGet.

Per ulteriori informazioni sull'installazione, consulta la documentazione per il set di librerie Google.Cloud.Diagnostica . Puoi anche segnalare i problemi utilizzando lo strumento di monitoraggio dei problemi.

Configurazione della libreria client

Per ulteriori informazioni ed esempi, consulta le seguenti risorse:

  • Google.Cloud.Diagnostics.AspNetCore3 documentazione
  • Google.Cloud.Diagnostics.AspNetCore documentazione
  • Google.Cloud.Diagnostics.Common documentazione
  • Segnalare errori

    Per ulteriori informazioni ed esempi, consulta le seguenti risorse:

  • Google.Cloud.Diagnostics.AspNetCore3 documentazione
  • Google.Cloud.Diagnostics.AspNetCore documentazione
  • Google.Cloud.Diagnostics.Common documentazione
  • Esecuzione in Google Cloud

    Per utilizzare il set di librerie di Google.Cloud.Diagnostica, è necessario il ruolo di Writer Error Reporting Identity and Access Management. La maggior parte delle piattaforme di computing Google Cloud fornisce questo ruolo per impostazione predefinita.

    Puoi configurare Error Reporting per .NET nei seguenti ambienti Google Cloud.

    Ambiente flessibile di App Engine

    App Engine concede per impostazione predefinita il ruolo Writer Error Reporting.

    Il set di librerie Google.Cloud.Diagnostica può essere utilizzato senza dover fornire esplicitamente le credenziali.

    Error Reporting viene abilitato automaticamente per le applicazioni dell'ambiente flessibile di App Engine. Non sono richieste configurazioni aggiuntive. I messaggi scritti da App Engine a stderr vengono analizzati e, se contengono un'analisi dello stack, verranno visualizzati da Error Reporting.

    Per istruzioni su come visualizzare i dati sugli errori e sulle eccezioni per l'applicazione in Google Cloud Console, consulta l'articolo Visualizzazione degli errori.

    Google Kubernetes Engine

    Su GKE, devi aggiungere l'ambito di accesso cloud-platform quando crei il cluster, come mostra il seguente comando di esempio:

    gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform
    

    Compute Engine

    Quando utilizzi le istanze VM di Compute Engine, aggiungi l'ambito di accesso cloud-platform a ciascuna istanza. Quando crei una nuova istanza tramite la console Google Cloud, puoi farlo nella sezione Identità e accesso API del riquadro Crea istanza. Utilizza l'account di servizio predefinito di Compute Engine o un altro account di servizio a tua scelta e seleziona Consenti accesso completo a tutte le API Cloud nella sezione Identità e accesso API. Qualunque sia l'account di servizio selezionato, assicurati che sia stato concesso il ruolo Writer Error Reporting nella sezione IAM e amministrazione della console Google Cloud.

    Esecuzione locale e altrove

    Per utilizzare il set di librerie Google.Cloud.Diagnostica al di fuori di Google Cloud, inclusa l'esecuzione della libreria sulla tua workstation, sui computer dei data center o sulle istanze VM di un altro provider cloud, devi fornire il tuo ID progetto Google Cloud e le credenziali dell'account di servizio direttamente al set di librerie Google.Cloud.Diagnostica.

    Puoi creare e ottenere manualmente le credenziali dell'account di servizio. Quando specifichi il campo Ruolo, utilizza il ruolo Writer Error Reporting. Per saperne di più sui ruoli di Identity and Access Management, vai alla guida al controllo dell'accesso.

    Visualizzazione dei rapporti degli errori

    Dopo il deployment, puoi visualizzare i report sugli errori nella dashboard di Error Reporting di Google Cloud Console.

    Vai alla dashboard di Error Reporting

    Per ulteriori informazioni, consulta la sezione Visualizzare gli errori.