收集 Apigee 日志

解析器版本： 6.0

本文档介绍了如何通过启用 Google Cloud 向 Google Security Operations 注入遥测数据来收集 Apigee 日志，以及如何将 Apigee 日志的日志字段映射到 Google Security Operations 统一数据模型 (UDM) 字段。

如需了解详情，请参阅将数据注入到 Google Security Operations。

典型的部署包括已启用注入到 Google Security Operations 的 Apigee 日志。每个客户部署都可能与此表示法不同，并且可能更复杂。

该部署包含以下组件：

• Google Cloud：您从中收集日志的 Google Cloud 服务和产品。

• Apigee 日志：已 启用注入到 Google Security Operations 的 Apigee 日志。

• Google Security Operations：Google Security Operations 会保留和分析来自 Apigee 的日志。

注入标签标识哪个解析器将原始日志数据标准化为结构化 UDM 格式。本文档中的信息适用于具有 GCP_APIGEE_X 注入标签的解析器。

准备工作

• 确保部署架构中的所有系统都配置为使用世界协调时间 (UTC) 时区。

• 在开始之前，请确认您已设置使用 MessageLogging 政策进行日志收集 或 （旧版）使用 ServiceCallout 政策进行日志收集。

• 如需设置使用 MessageLogging 政策进行日志收集，请按照 Apigee Google Cloud Integration 指南中的步骤操作。

配置 Google Cloud 以注入 Apigee 日志

如需将 Apigee 日志注入到 Google Security Operations，请按照 将 Google Cloud 日志注入到 Google Security Operations 页面上的步骤操作。

如果您在注入 Apigee 日志时遇到问题，请与 Google Security Operations 支持团队联系。

支持的 Apigee 日志格式

Apigee 解析器支持 JSON 格式的日志。

支持的 Apigee 示例日志

• JSON

    {
      "insertId": "12wnv8zf7np8nh",
      "jsonPayload": {
        "proxy.name": "myproxy",
        "app.name": "",
        "environment.name": "test-env",
        "system.region.name": "us-west1",
        "developer.email": "",
        "target.country": "",
        "request.content-length": "",
        "client.state": "",
        "response.status.code": "200",
        "request.content-type": "",
        "response.content-type": "application/xml; charset\u003dutf-8",
        "proxy.revision": "6",
        "response.content-length": "141",
        "proxy.proxyendpoint.name": "default",
        "organization.name": "test-dummy-57377",
        "error.state": "",
        "error": "false",
        "fault.name": "",
        "client.locality": "",
        "target.state": "",
        "proxy.pathsuffix": "",
        "client.port": "50386",
        "system.uuid": "7f2fde33-5f39-4866-a073-e6c31a4664e2",
        "target.scheme": "https",
        "request.user-agent": "curl/8.5.0",
        "target.locality": "",
        "messageid": "f8093238-2f51-42ab-ae44-dec9f451c7474",
        "target.port": "443",
        "target.ip": "198.51.100.0",
        "apiproduct.name": "",
        "request.url": "https://",
        "request.x-cloud-trace-context": "e3d3fea1742455ede2dad1d975361511/11739831648342702971",
        "request.httpversion": "1.1",
        "target.host": "mocktarget.apigee.net",
        "target.url": "https://mocktarget.apigee.net/xml",
        "proxy.basepath": "/myproxy",
        "target.cn": "mocktarget.apigee.net",
        "client.country": "",
        "client.cn": "",
        "cachehit": "",
        "target.organization": "",
        "client.ip": "198.51.100.0",
        "system.timestamp": "1754652492121",
        "request.host": "",
        "request.verb": "GET",
        "request.x-b3-traceid": "31339f721d4be35ff2932fa471979252",
        "client.scheme": "https",
        "error.message": ""
      },
      "resource": {
        "type": "api",
        "labels": {
          "project_id": "test-dummy-57377",
          "version": "",
          "location": "",
          "method": "",
          "service": ""
        }
      },
      "timestamp": "2025-08-08T11:28:12.203938277Z",
      "severity": "INFO",
      "logName": "projects/test-dummy-57377/logs/apigee-secops-integration-test-env",
      "receiveTimestamp": "2025-08-08T11:28:12.203938277Z"
    }
  

字段映射参考

本部分介绍了 Google SecOps 解析器如何将 Apigee 日志字段映射到 Google Security Operations 统一数据模型 (UDM) 字段。

字段映射参考：使用 MessageLogging 政策进行日志收集的 GCP_APIGEE_X 日志

下表列出了使用 MessageLogging 政策进行日志收集的 GCP_APIGEE_X 日志类型的日志字段及其对应的 UDM 字段。

字段映射参考：使用 ServiceCallout 政策进行日志收集的 GCP_APIGEE_X 日志

下表列出了使用 ServiceCallout 政策进行日志收集的 GCP_APIGEE_X（旧版）日志类型的日志字段及其对应的 UDM 字段。

后续步骤

• 将数据注入到 Google Security Operations

更新日志

查看此解析器的更新日志

需要更多帮助？获得社区成员和 Google SecOps 专业人士的解答。