É possível enviar erros dos aplicativos do Compute Engine 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).
Usando a API Error Reporting. Seu aplicativo pode enviar solicitações HTTP por meio da API REST ou usar bibliotecas experimentais em diversas linguagens.
Usar o Logging para relatar erros
Para conectar seus aplicativos do Compute Engine ao Error Reporting: as exceções ou outros erros ao Logging.
Exemplo:
- Instale o agente
google-fluentd
do Logging no estado em que se encontra apropriados 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 nem todas as informações juntos, o Error Reporting pode não detectar o erro. Você pode usar o formato estruturado JSON que os payloads de sua entrada de registro incluam tipos diferentes de informações cada erro.
Enable the Error Reporting API.
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 do ASP.NET relata exceções não capturadas de de aplicativos da Web 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 código HttpConfiguration
abaixo ao método Register
da sua
App da Web .NET (substituindo your-project-id
pelo seu
ID do projeto
para ativar o relatório de exceções:
Depois de adicionar esse método ao aplicativo ASP.NET, é possível visualizar as exceções não identificadas assim que elas forem registradas no Google Cloud na seção Error Reporting do console do Google Cloud.
C#
O exemplo a seguir pode ser encontrado GoogleCloudPlatform/dotnet-docs-samples repositório. 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 da
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 console do Google Cloud, acesse a página Error Reporting:
Também é possível encontrar essa página usando a barra de pesquisa.