Vous pouvez envoyer des erreurs depuis les applications EC2 à Error Reporting à l'aide de l'une des deux méthodes suivantes :
En vous connectant à Cloud Logging. Si vous utilisez déjà Cloud Logging, la seule condition requise est que vos entrées de journal soient reconnaissables par Error Reporting. Pour en savoir plus sur les exigences en matière de mise en forme des erreurs, consultez la page Formater les erreurs dans Cloud Logging.
En utilisant l'API Error Reporting. L'application peut envoyer des requêtes HTTP à l'aide de l'API REST ou utiliser des bibliothèques expérimentales dans plusieurs langages.
Utiliser Logging pour signaler des erreurs
Pour connecter vos applications EC2 à Error Reporting, procédez comme suit : envoyer vos exceptions ou autres erreurs à Logging.
Exemple :
- Connectez le système Amazon Web Services (AWS) à Google Cloud. Pour en savoir plus, consultez la section Installer l'agent Logging sur des VM individuelles.
- Installez l'agent Logging
google-fluentd
selon les besoins de votre environnement. Pour obtenir des instructions, consultez la section Installer l'agent Logging. Modifiez l'application afin qu'elle enregistre les exceptions et leurs traces de pile dans Logging.
Vous devez inclure toutes les informations d'une seule erreur ou exception dans la même entrée de journal, y compris tous les cadres d'une trace de pile. Si toutes les informations ne sont pas peuvent ne pas détecter l'erreur. Vous pouvez utiliser le format JSON structuré. pour vos charges utiles entrée de journal afin d’inclure différents types d’informations pour chaque erreur.
Enable the Error Reporting API.
Signalez les erreurs à l'API à l'aide de l'API REST ou d'une bibliothèque cliente.
- Cliquez avec le bouton droit sur votre solution et sélectionnez Gérer les packages NuGet pour la solution.
- Cochez la case Inclure la version préliminaire.
- Recherchez et installez le package nommé
Google.Cloud.Diagnostics.AspNet
.
Java
Ajoutez le code ci-dessous à votre fichier pom.xml
:
Exécutez ensuite le code suivant pour envoyer les données relatives aux exceptions :
Python
Commencez par installer la bibliothèque fluent-logger-python
:
sudo pip install fluent-logger
Exécutez ensuite le code suivant pour envoyer les données relatives aux exceptions :
Node.js
Commencez par installer la bibliothèque fluent-logger-node
:
npm install --save fluent-logger
Exécutez ensuite le code suivant pour envoyer les données relatives aux exceptions :
Go
Commencez par installer le package fluent-logger-golang
:
go get github.com/fluent/fluent-logger-golang/
Exécutez ensuite le code suivant pour envoyer les données relatives aux erreurs :
Utiliser l'API Error Reporting pour écrire des erreurs
L'API Error Reporting fournit un point de terminaison report
pour écrire les informations d'erreur à destination du service.
Exemples
ASP.NET
Le package NuGet ASP.NET signale les exceptions non interceptées depuis des applications Web ASP.NET vers Error Reporting.
Installer le package NuGet
Pour installer le package NuGet ASP.NET Stackdriver dans Visual Studio :
Utilisation
Une fois que vous avez installé le package NuGet ASP.NET Stackdriver, ajoutez la déclaration suivante à votre code d'application pour commencer à envoyer des erreurs à Stackdriver :
using Google.Cloud.Diagnostics.AspNet;
Ajoutez le code HttpConfiguration
suivant à la méthode Register
de votre
Application Web .NET (remplacez your-project-id
par votre application
ID du projet
pour pouvoir signaler des exceptions:
Une fois que vous avez ajouté cette méthode à votre application ASP.NET, vous pouvez afficher les exceptions non détectées qui se produisent lorsqu'elles sont signalées à Google Cloud. dans la section Error Reporting de la console Google Cloud.
C#
L'exemple suivant est disponible dans le dépôt GoogleCloudPlatform/dotnet-docs-samples. Pour l'utiliser après avoir créé le projet, spécifiez votre ID de projet :
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Veillez à remplacer [YOUR_PROJECT_ID]
par la valeur correcte issue de
console Google Cloud.
Ensuite, envoyez les données d'exception avec le code suivant :
Go
Consultez la page Configurer Error Reporting pour Go.
Java
Consultez la page Configurer Error Reporting pour Java.
Node.js
Consultez la page Configurer Error Reporting pour Node.js.
Ruby
Consultez la page Configurer Error Reporting pour Ruby.
Python
Consultez la page Configurer Error Reporting pour Python.
PHP
Consultez la page Configurer Error Reporting pour PHP.
Afficher les groupes d'erreurs
Dans la console Google Cloud, accédez à la page Error Reporting:
Vous pouvez également accéder à cette page à l'aide de la barre de recherche.