将日志导出到 BigQuery

您可以在 日志路由器中创建日志接收器，将 Google Cloud Fraud Defense 生成的平台日志从 Cloud Logging 路由到 BigQuery。

您可以将平台日志导出到 BigQuery，以长期保留评估 数据，使用 SQL 分析风险评分和原因代码，并在 数据洞察中直观呈现流量趋势。Logging 中的 平台日志的 默认保留期限为 30 天， 您可以将其配置为最长 3,650 天。

Fraud Defense 支持以下 v1 API 操作的平台日志记录：

准备工作

如需获得启用平台日志并将其路由到 BigQuery 所需的权限，请让管理员向您授予 Google Cloud 项目的以下 Identity and Access Management 角色：

启用平台日志

在将日志路由到 BigQuery 之前，请在 Fraud Defense 中启用平台日志：

  1. 在 Google Cloud 控制台中，前往 Fraud Defense 页面。

    前往 Fraud Defense

  2. 验证您的项目名称是否显示在资源选择器中。

    如果您没有看到项目名称，请点击资源选择器，然后选择您的项目。

  3. 点击设置。

  4. 在 Platform logging （平台日志记录）卡片中，点击配置 。

  5. 在 Platform logging （平台日志记录）窗格中，点击 Enable assessment logs （启用评估日志）对应的切换开关。

  6. 可选：如需导出注解请求，请点击 Enable annotation logs （启用注解日志）旁边的切换开关。

  7. 点击保存 。

如需详细了解如何管理平台日志设置，请参阅 使用平台日志。

创建 BigQuery 接收器

启用平台日志后，在日志路由器中创建一个接收器，以将新的 reCAPTCHA 评估日志条目导出到 BigQuery：

  1. 在 Google Cloud 控制台中，前往日志路由器 页面。

    前往日志路由器

  2. 点击创建接收器 。

  3. 在接收器详细信息 部分，输入接收器名称和可选说明，然后点击下一步 。

  4. 如需配置目标数据集，请在接收器目标位置 部分完成以下步骤：

    1. 在选择接收器服务 菜单中，选择 BigQuery 数据集 。
    2. 在选择 BigQuery 数据集 菜单中，选择现有数据集，或选择新建 BigQuery 数据集 。
    3. 如果您创建了新数据集，请输入数据集名称，然后点击创建数据集 。
    4. 选择使用分区表，然后点击下一步。

  5. 如需包含所有评估日志条目，请在选择要包含在接收器中的日志 部分的构建包含过滤器 字段中输入以下包含过滤器：

    resource.type="recaptchaenterprise.googleapis.com/Key"
log_id("recaptchaenterprise.googleapis.com/assessment")

  6. 可选：如需在接收器中同时包含 assessment 和 annotation 平台日志，请输入以下过滤条件：

    resource.type="recaptchaenterprise.googleapis.com/Key"
(log_id("recaptchaenterprise.googleapis.com/assessment") OR
  log_id("recaptchaenterprise.googleapis.com/annotation"))

  7. 点击下一步 。

  8. 可选：根据需要配置排除过滤器，然后点击创建接收器 。

接收器创建完毕后，Logging 会显示确认消息，并自动预配一个写入器服务帐号，该账号具有将日志条目写入 BigQuery 数据集的权限。

价格

将平台日志导出到 BigQuery 会产生 Logging 和 BigQuery 的标准费用：

  • 如需了解日志提取和路由费用，请参阅 Logging 价格。
  • 如需了解数据存储区和 SQL 查询费用，请参阅 BigQuery 价格。

后续步骤