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 ulteriori informazioni sui requisiti di formattazione degli errori, consulta Errori di formattazione in Cloud Logging.
Utilizzare l'API Error Reporting. L'applicazione può inviare richieste HTTP utilizzando l'API REST o può utilizzare librerie sperimentali in diversi linguaggi.
Utilizzare Logging per segnalare gli errori
L'agente di logging predefinito di GKE fornisce una soluzione gestita per eseguire il deployment e gestire gli 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, consulta Gestire i log di GKE.
Error Reporting richiede che le eccezioni o le tracce 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, ovvero frame dello stack stampati ciascuno su una nuova riga, rappresentano una analisi dello stack e di inviarla a Cloud Logging come singola voce di log.
Se l'agente non è in grado di ricostruire più righe come un singolo errore,
utilizza l'endpoint dell'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 informazioni sugli errori nel servizio.
Enable the Error Reporting API.
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 di Stackdriver ASP.NET in Visual Studio:
- Fai clic con il tasto destro del mouse sulla soluzione e seleziona Gestisci pacchetti NuGet per la soluzione.
- Seleziona la casella di controllo Includi prerelease.
- Cerca e installa il pacchetto
Google.Cloud.Diagnostics.AspNet
.
Utilizzo
Dopo aver installato il pacchetto NuGet di Stackdriver ASP.NET, aggiungi la seguente dichiarazione 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 reale
ID progetto
per attivare la segnalazione delle eccezioni:
Dopo aver aggiunto questo metodo all'applicazione ASP.NET, puoi visualizzare eventuali eccezioni non rilevate che si verificano quando vengono segnalate a Google Cloud nella sezione Report sugli errori della console Google Cloud.
C#
L'esempio seguente è disponibile nel repo GoogleCloudPlatform/dotnet-docs-samples. Per utilizzarlo, dopo aver compilato 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 console Google Cloud.
Invia quindi i dati relativi all'eccezione con un codice simile al seguente:
Vai
Consulta la sezione Configurare Error Reporting per Go.
Java
Consulta Configurare Error Reporting per Java.
Node.js
Consulta Configurare Error Reporting per Node.js.
Ruby
Consulta Configurare Error Reporting per Ruby.
Python
Consulta Configurare Error Reporting per Python.
PHP
Consulta la sezione Configurare 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.