Puoi inviare report sugli errori alle applicazioni di Error Reporting dalle applicazioni .NET utilizzando il set di librerie Google.Cloud.Diagnostics .
Error Reporting è integrato con alcuni servizi Google Cloud, come App Engine, Compute Engine e Google Kubernetes Engine. Error Reporting mostra gli errori registrati in Cloud Logging dalle applicazioni in esecuzione su tali servizi. Per ulteriori informazioni, vai alla 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
- 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.
-
Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Error Reporting API .
-
Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva Error Reporting API .
Installare la libreria client
L'insieme di librerie di Google.Cloud.Diagnostics consente di monitorare e visualizzare gli errori segnalati dalle applicazioni .NET in esecuzione quasi ovunque.
-
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. -
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. -
Per le applicazioni che hanno come target framework non ASP.NET Core, utilizza la libreria
Google.Cloud.Diagnostics.Common. Puoi installare questa libreria da NuGet.
Per ulteriori informazioni sull'installazione, leggi la documentazione per il set di librerie Google.Cloud.Diagnostics. Puoi anche segnalare i problemi utilizzando lo strumento Issue Tracker.
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
Errori nei report
Per ulteriori informazioni ed esempi, consulta le seguenti risorse:
Google.Cloud.Diagnostics.AspNetCore3
documentazione
Google.Cloud.Diagnostics.AspNetCore
documentazione
Google.Cloud.Diagnostics.Common
documentazione
In esecuzione su Google Cloud
L'utilizzo dell'insieme di librerie di Google.Cloud.Diagnostics richiede il ruolo Writer di Identity and Access Management Error Reporting Writer. 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.
L'insieme di librerie Google.Cloud.Diagnostics 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, vengono visualizzati da Error Reporting.
Per istruzioni sulla visualizzazione dei dati sugli errori e sulle eccezioni per l'applicazione nella console Google Cloud, consulta Visualizzazione degli errori.
Google Kubernetes Engine
Su GKE, devi aggiungere l'ambito di accesso cloud-platform durante la creazione del cluster, come illustrato nell'esempio seguente:
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 ogni 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 l'accesso completo a tutte le API Cloud nella sezione Identità e accesso API. A prescindere dall'account di servizio selezionato, assicurati che gli sia stato concesso il ruolo di Writer Error Reporting nella sezione IAM e amministrazione della console Google Cloud.
Pubblicazione locale e altrove
Per utilizzare il set di librerie Google.Cloud.Diagnostics al di fuori di Google Cloud, inclusa l'esecuzione della libreria sulla tua workstation, sui computer del tuo data center o sulle istanze VM di un altro cloud provider, devi fornire il tuo ID progetto Google Cloud e le credenziali dell'account di servizio appropriate direttamente nel set di librerie Google.Cloud.Diagnostics.
Puoi creare e ottenere le credenziali dell'account di servizio manualmente. Quando specifichi il campo Ruolo, utilizza il ruolo Writer errori. Per saperne di più sui ruoli di Identity and Access Management, vai alla Guida al controllo dell'accesso.
Visualizzazione dei rapporti degli errori
Nella console Google Cloud, seleziona Error Reporting o fai clic sul pulsante seguente, quindi seleziona un progetto:
Per ulteriori informazioni, consulta la sezione Visualizzare gli errori.