Coletar dados de erros usando o Error Reporting

Este documento lista os ambientes compatíveis com o Error Reporting e há links para guias específicos de linguagens para desenvolvedores de aplicativos. Recomendamos que você use as bibliotecas de cliente específicas da linguagem ou usam entradas de registro coletadas automaticamente. No entanto, é possível gravar dados de erros com a API Cloud Logging ou a API Error Reporting. Por exemplo, se você usar Cloud Run; as exceções gravadas em stderr serão enviadas automaticamente ao Cloud Logging.

O Error Reporting é um serviço global baseado em o Cloud Logging e pode analisar entradas de registro quando todas as condições a seguir forem verdadeiras:

  • O Assured Workloads está desativado. Para mais informações, consulte Visão geral do Assured Workloads.
  • Chaves de criptografia gerenciadas pelo cliente (CMEK) está desativado em todos os buckets que armazenam a entrada de registro. Para mais informações sobre como determinar a configuração da CMEK para um bucket de registros, consulte Verifique a ativação da chave.
  • O bucket de registros atende a um dos itens a seguir:
    • O bucket de registros é armazenado no mesmo projeto em que as entradas de registro foram originadas.
    • As entradas de registro foram encaminhadas para um projeto, que armazenou essas entradas de registro em um bucket de registros próprio.
Se você estiver armazenando suas entradas de registro em buckets com a CMEK ativada, ainda poderá usar o Error Reporting. No entanto, é preciso usar o cliente do Error Reporting ou a API Error Reporting. Para mais informações, consulte a Visão geral da API Error Reporting e as bibliotecas de cliente do Error Reporting.

Suporte à nuvem privada virtual

O Error Reporting é uma nuvem privada virtual (VPC) compatível serviço.

Para reduzir o risco de exfiltração de dados, use o VPC Service Controls para criar uma perímetro de serviço em torno dos serviços gerenciados pelo Google. Para informações sobre o VPC Service Controls e como criar um serviço , consulte o parâmetro Documentação do VPC Service Controls.

Configurar ambientes para informar dados de erros automaticamente

Para informações sobre os requisitos de configuração específicos do ambiente, consulte os seguintes guias:

Instrumentar os apps usando bibliotecas de cliente

Para informações sobre como configurar seu aplicativo para enviar relatórios de erros, consulte os guias de configuração específicos para cada linguagem:

Gravar dados de erros usando uma API

Para relatar eventos de erro ao seu projeto do Google Cloud, executando o método da API Error Reporting report ou o método da API Cloud Logging write

  • Se você precisar de autenticação baseada em chave de API, use a API Error Reporting. Para informar um evento de erro usando o API Error Reporting, execute o método report e formatar o corpo da solicitação do método como um objeto ReportedErrorEvent.

    Ao usar a API Error Reporting, as entradas de registro com mensagens de erro formatadas são geradas e gravadas automaticamente Cloud Logging: Essas entradas são gravadas em um com logName formatado da seguinte forma:

    projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors

    Como as entradas de registro são geradas por chamadas para report, você pode incorrer em custos de ingestão do Cloud Logging. Para controlar quais entradas de registro são ingeridas, consulte Filtros de exclusão.

    Se você relatar eventos de erro usando a API Error Reporting, o restante deste documento não se aplica.

  • Para usar a API Cloud Logging, formate o objeto LogEntry para que inclua um stack trace; ou um objeto ReportedErrorEvent. Para mais informações sobre os requisitos de formatação, consulte Formatar erros em registros.