Puoi inviare gli errori dalle tue applicazioni Google Kubernetes Engine a Error Reporting in due modi:
Eseguendo il logging in Cloud Logging. Se utilizzi già Cloud Logging, l'unico requisito aggiuntivo è che le voci di log siano riconoscibili da Error Reporting. Per saperne di più sui requisiti di formattazione degli errori, consulta Formattazione degli errori in Cloud Logging.
Utilizzo dell'API Error Reporting. La tua applicazione può inviare richieste HTTP utilizzando l'API REST oppure può utilizzare librerie sperimentali in diverse lingue.
Utilizzare Logging per segnalare gli errori
L'agente di logging predefinito di GKE fornisce una soluzione gestita per il deployment e la gestione degli agenti che inviano i log dei tuoi cluster a Cloud Logging. La struttura dell'agente dipende dalla versione del cluster. Per informazioni su questo agente, vedi Gestione dei log di GKE.
Error Reporting richiede che le eccezioni o le analisi dello stack siano contenute
in una singola voce di log. La maggior parte degli agenti di logging è in grado di riconoscere che
diverse righe di log, i frame dello stack stampati ciascuno su una nuova riga, rappresentano
una analisi dello stack e di inviarla a Cloud Logging come una singola voce di log.
Se l'agente non è in grado di ricostruire più righe come un unico errore,
utilizza l'endpoint API projects.events.report
,
che ti consente di controllare i contenuti di un errore.
Utilizzo dell'API Error Reporting per scrivere errori
L'API Error Reporting fornisce un endpoint report
per scrivere
le informazioni sugli errori nel servizio.
Enable the Error Reporting API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin
), which contains theserviceusage.services.enable
permission. Learn how to grant roles.Segnala gli errori all'API utilizzando l'API REST o una libreria client.
Esempi
ASP.NET
Il pacchetto NuGet ASP.NET segnala le eccezioni non rilevate dalle applicazioni web ASP.NET a Error Reporting.
Installa il pacchetto NuGet
Per installare il pacchetto NuGet Stackdriver ASP.NET in Visual Studio:
- Fai clic con il tasto destro del mouse sulla soluzione e seleziona Gestisci pacchetti NuGet per soluzione.
- Seleziona la casella di controllo Includi pre-release.
- Cerca e installa il pacchetto denominato
Google.Cloud.Diagnostics.AspNet
.
Utilizzo
Dopo aver installato il pacchetto NuGet Stackdriver ASP.NET, aggiungi la seguente istruzione al codice dell'applicazione per iniziare a inviare gli errori a Stackdriver:
using Google.Cloud.Diagnostics.AspNet;
Aggiungi il seguente codice HttpConfiguration
al metodo Register
della tua app web .NET (sostituendo your-project-id
con il tuo ID progetto effettivo) per attivare la segnalazione delle eccezioni:
Una volta aggiunto questo metodo all'applicazione ASP.NET, puoi visualizzare tutte le eccezioni non rilevate che si verificano man mano che vengono segnalate a Google Cloudnella sezione Error Reporting della console Google Cloud .
C#
Il seguente esempio è disponibile nel repository GoogleCloudPlatform/dotnet-docs-samples. Per utilizzarlo, dopo aver creato il progetto, specifica il tuo ID progetto:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Assicurati di sostituire [YOUR_PROJECT_ID]
con il valore corretto della consoleGoogle Cloud .
Poi, invia i dati delle eccezioni con un codice simile al seguente:
Vai
Consulta la sezione Configurazione di Error Reporting per Go.
Java
Node.js
Consulta la sezione Configurazione di Error Reporting per Node.js.
Ruby
Python
PHP
Consulta la sezione Configurazione di Error Reporting per PHP.
Visualizza gruppi di errori
Nella console Google Cloud , vai alla pagina Error Reporting:
Puoi trovare questa pagina anche utilizzando la barra di ricerca.