Puoi inviare errori dalle applicazioni Google Kubernetes Engine a Error Reporting in uno dei due seguenti modi:
Effettuando 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 Errori di formattazione in Cloud Logging.
Utilizzare l'API Error Reporting. L'applicazione può inviare richieste HTTP utilizzando l'API REST oppure può utilizzare librerie sperimentali in diversi linguaggi.
Utilizzo di Logging per segnalare errori
L'agente Logging predefinito di GKE fornisce una soluzione gestita per eseguire il deployment e gestire gli agenti che inviano i log per i tuoi cluster a Cloud Logging. La struttura dell'agente dipende dalla versione del cluster. Per informazioni su questo agente, consulta Gestione dei log di GKE.
Error Reporting richiede che le eccezioni o le analisi dello stack siano contenute in un'unica voce di log. La maggior parte degli agenti di logging è in grado di riconoscere che diverse righe di log (stack frame stampati ciascuna su una nuova riga) rappresentano un'analisi dello stack e la inviano a Cloud Logging come una singola voce di log.
Se l'agente non è in grado di ricostruire più righe come un singolo 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 la scrittura di informazioni sull'errore 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 pulsante 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 di Stackdriver ASP.NET, aggiungi la seguente istruzione al codice dell'applicazione per iniziare a inviare errori a Stackdriver:
using Google.Cloud.Diagnostics.AspNet;
Aggiungi il seguente codice HttpConfiguration
al metodo Register
dell'applicazione web .NET (sostituendo your-project-id
con l'ID progetto effettivo per attivare la segnalazione delle eccezioni:
Dopo aver aggiunto questo metodo all'applicazione ASP.NET, puoi visualizzare tutte le eccezioni non rilevate che si verificano quando vengono segnalate a Google Cloud nella 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 l'ID progetto:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Assicurati di sostituire [YOUR_PROJECT_ID]
con il valore corretto dalla console Google Cloud.
Quindi, invia dati di eccezione con un codice simile al seguente:
Go
Consulta la sezione Configurare Error Reporting per Go.
Java
Consulta la sezione Configurazione di Error Reporting per Java.
Node.js
Consulta la sezione Configurazione di Error Reporting per Node.js.
Ruby
Consulta la sezione Configurazione di Error Reporting per Ruby.
Python
Consulta la sezione Configurazione di Error Reporting per Python.
PHP
Consulta la sezione Configurazione di Error Reporting per PHP.
Visualizza gruppi di errori
Nella console Google Cloud, seleziona Error Reporting oppure fai clic sul pulsante seguente e seleziona un progetto: