使用 Error Reporting 收集错误数据

本文档列出了 Error Reporting 支持的环境，并提供了面向应用开发者的特定语言指南的链接。 我们建议您使用特定于语言的客户端库或依赖于自动收集的日志条目；不过，您也可以使用 Cloud Logging API 或 Error Reporting API 写入错误数据。例如，如果您使用 Cloud Run，则写入 stderr 的异常会自动发送到 Cloud Logging。

Error Reporting 是基于 Cloud Logging 构建的全球服务，当满足以下所有条件时，它可以分析日志条目：

  • Assured Workloads 已停用。如需了解详情，请参阅 Assured Workloads 概览。
  • 存储日志条目的所有日志存储分区均已停用客户管理的加密密钥 (CMEK)。Error Reporting 无法将日志条目存储在启用 CMEK 的日志存储分区中。如需了解如何确定日志存储桶的 CMEK 配置，请参阅验证密钥的启用状态。
  • 日志存储桶满足以下条件之一：
    • 日志存储桶存储在日志条目源自的同一项目中。
    • 日志条目被路由到一个项目，然后该项目将这些日志条目存储在自己拥有的日志存储桶中。

Virtual Private Cloud 支持

Error Reporting 是一项受 Virtual Private Cloud (VPC) 支持的服务。

为降低数据渗漏风险，请使用 VPC Service Controls 在 Google 托管式服务周围创建服务边界。如需了解 VPC Service Controls 以及如何创建服务参数，请参阅 VPC Service Controls 文档。

配置环境以自动报告错误数据

如需了解特定于环境的配置要求，请参阅以下指南：

使用客户端库检测应用

如需了解如何配置应用以发送错误报告，请参阅特定于语言的配置指南：

使用 API 写入错误数据

您可以通过执行 Error Reporting API 方法 report 或 Cloud Logging API 方法 write，向您的 Google Cloud 项目报告错误事件。

  • 如果您需要基于 API 密钥的身份验证，则必须使用 Error Reporting API。如需使用 Error Reporting API 报告错误事件，请执行方法 report，并将该方法的请求正文格式设置为 ReportedErrorEvent 对象。

    使用 Error Reporting API 时，系统会自动生成包含具有适当格式设置的错误消息的日志条目，并将其写入 Cloud Logging。这些日志条目会写入 logName 格式如下的日志中：

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

    由于日志条目是通过对 report 的调用生成的，因此您可能需要支付 Cloud Logging 注入费用。如需控制注入哪些日志条目，请参阅排除项过滤条件。

    如果您使用 Error Reporting API 报告错误事件，则本文档的其余部分不适用。

  • 如果您想使用 Cloud Logging API，则必须将 LogEntry 对象格式化为包含堆栈轨迹或 ReportedErrorEvent 对象。如需详细了解格式设置要求，请参阅设置日志中的错误格式。