Envie os erros dos seus aplicativos do EC2 para o Error Reporting de duas maneiras:
Fazendo login no Cloud Logging. Se você já estiver usando o Cloud Logging, o único requisito adicional é que as entradas de registro sejam reconhecíveis pelo Error Reporting. Para mais informações sobre requisitos de erros de formatação, leia Erros de formatação no Cloud Logging (em inglês).
Como usar a API Error Reporting. O aplicativo pode enviar solicitações HTTP usando a API REST ou usar bibliotecas experimentais em várias linguagens.
Usar o Logging para relatar erros
Para conectar seus aplicativos do EC2 ao Error Reporting, envie exceções ou outros erros ao Logging.
Exemplo:
- Conecte o sistema da Amazon Web Services (AWS) ao Google Cloud. Para mais informações, consulte Como instalar o agente do Logging em VMs individuais.
- Instale o agente
google-fluentd
do Logging conforme apropriado para seu ambiente. Para instruções, consulte Como instalar o agente do Logging. Modifique seu aplicativo para que ele registre exceções e stack traces no Logging.
É preciso incluir todas as informações de um único erro ou exceção na mesma entrada de registro, incluindo todos os frames de qualquer stack trace. Se todas as informações não estiverem juntas, o Error Reporting poderá não detectar o erro. É possível usar o formato JSON estruturado nos payloads de entrada de registro para incluir diferentes tipos de informações de cada erro.
Ative a API Error Reporting.
Informe erros na API usando a API REST ou uma biblioteca de cliente.
- Clique com o botão direito do mouse em sua solução e selecione Gerenciar pacotes NuGet para solução.
- Marque a caixa de seleção Incluir pré-lançamento.
- Pesquise e instale o pacote
Google.Cloud.Diagnostics.AspNet
.
Java
Adicione a instrução a seguir ao seu arquivo pom.xml
:
Depois, use o código como o demonstrado a seguir para enviar os dados da exceção:
Python
Primeiro, instale a biblioteca fluent-logger-python
(em inglês):
sudo pip install fluent-logger
Depois, use o código como o demonstrado a seguir para enviar os dados da exceção:
Node.js
Primeiro, instale a biblioteca fluent-logger-node
(em inglês):
npm install --save fluent-logger
Depois, use o código como o demonstrado a seguir para enviar os dados da exceção:
Go
Primeiro, instale o pacote fluent-logger-golang
(em inglês):
go get github.com/fluent/fluent-logger-golang/
Depois, use o código como o demonstrado a seguir para enviar dados do erro:
Usar a API Error Reporting para gravar erros
A API Error Reporting fornece um endpoint report
para gravar informações de erro no serviço.
Amostras
ASP.NET
O pacote NuGet para ASP.NET relata exceções não capturadas de aplicativos da Web do ASP.NET para o Error Reporting.
Instalar o pacote NuGet
Para instalar o pacote NuGet para ASP.NET do Stackdriver no Visual Studio:
Uso
Após instalar o pacote NuGet para ASP.NET do Stackdriver, adicione o comando a seguir ao código do seu aplicativo para começar a enviar os erros ao Stackdriver:
using Google.Cloud.Diagnostics.AspNet;
Adicione o seguinte código HttpConfiguration
ao método Register
do seu app da web .NET, substituindo your-project-id
pelo ID do projeto atual para ativar a geração de relatórios de exceções:
Depois de adicionar esse método ao seu aplicativo ASP.NET, é possível visualizar todas as exceções não identificadas que ocorrem conforme elas são relatadas ao Google Cloud na seção Error Reporting do console do Google Cloud.
C#
O exemplo a seguir está localizado no repositório GoogleCloudPlatform/dotnet-docs-samples. Para usá-lo após a criação do projeto, especifique seu código do projeto:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Substitua [YOUR_PROJECT_ID]
pelo valor correto do
console do Google Cloud.
Em seguida, envie os dados da exceção com um código semelhante a este:
Go
Java
Node.js
Ruby
Python
PHP
Mostrar grupos de erros
No painel de navegação do console do Google Cloud, selecione Error Reporting e escolha seu projeto do Google Cloud: