You can send errors from your EC2 applications to Error Reporting in one of two ways:
By logging to Cloud Logging. If you're already using Cloud Logging, the only additional requirement is that your log entries be recognizable by Error Reporting. For more information on error formatting requirements, read Formatting errors in Cloud Logging.
Using the Error Reporting API. Your application can send HTTP requests using the REST API, or can make use of experimental libraries in several languages.
Using Logging to report errors
To connect your EC2 applications to Error Reporting, send your exceptions or other errors to Logging.
For example:
- Connect the Amazon Web Services (AWS) system to Google Cloud. For more information, see Installing the Logging Agent on individual VMs.
- Install the Logging
google-fluentd
agent as is appropriate for your environment. For instructions, see Installing the Logging agent. Modify your application so that it logs exceptions and their stack traces to Logging.
You must include all the information for a single error or exception in the same log entry, including all the frames of any stack trace. If all the information isn't together, then Error Reporting might not detect the error. You can use the structured JSON format for your log entry payloads to include different kinds of information for each error.
Enable the Error Reporting API.
Report errors to the API using either the REST API or a client library.
- Right-click your solution and select Manage NuGet packages for solution.
- Select the Include prerelease checkbox.
- Search for and install the package named
Google.Cloud.Diagnostics.AspNet
.
Java
Add the following to your pom.xml
file:
Then use code like the following to send the exception data:
Python
First, install the
fluent-logger-python
library:
sudo pip install fluent-logger
Then use code like the following to send the exception data:
Node.js
First, install the
fluent-logger-node
library:
npm install --save fluent-logger
Then use code like the following to send the exception data:
Go
First, install the
fluent-logger-golang
package:
go get github.com/fluent/fluent-logger-golang/
Then use code like the following to send error data:
Using the Error Reporting API to write errors
The Error Reporting API provides a report
endpoint for writing
error information to the service.
Samples
ASP.NET
The ASP.NET NuGet package reports uncaught exceptions from ASP.NET web applications to Error Reporting.
Install the NuGet package
To install the Stackdriver ASP.NET NuGet package in Visual Studio:
Usage
Once you've installed the Stackdriver ASP.NET NuGet package, add the following statement to your application code to start sending errors to Stackdriver:
using Google.Cloud.Diagnostics.AspNet;
Add the following HttpConfiguration
code to the Register
method of your
.NET web app (replacing your-project-id
with your actual
project ID
to enable the reporting of exceptions:
Once you've added this method to your ASP.NET application, you can view any uncaught exceptions that occur as they get reported to Google Cloud in the Error Reporting section of the Google Cloud console.
C#
The following example can be found in the GoogleCloudPlatform/dotnet-docs-samples repo. To use it, after building the project, specify your project ID:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Make sure to replace [YOUR_PROJECT_ID]
with the correct value from the
Google Cloud console.
Then, send exception data with code similar to the following:
Go
Java
Node.js
Ruby
Python
PHP
View error groups
In the Google Cloud console, go to the Error Reporting page:
You can also find this page by using the search bar.