Recoger registros de Apigee

En este documento se describe cómo puede recoger registros de Apigee habilitando la ingestión de telemetría en Google Security Operations y cómo se asignan los campos de registro de Apigee a los campos del modelo de datos unificado (UDM) de Google Security Operations. Google Cloud

Para obtener más información, consulta Ingestión de datos en Google Security Operations.

Un despliegue típico consiste en registros de Apigee habilitados para la ingestión en Google Security Operations. Cada implementación de cliente puede ser diferente de esta representación y puede ser más compleja.

La implementación contiene los siguientes componentes:

• Google Cloud: los Google Cloud servicios y productos de los que recoges registros.

• Registros de Apigee: los registros de Apigee que se han habilitado para la ingestión en Google Security Operations.

• Google Security Operations: Google Security Operations conserva y analiza los registros de Apigee.

Una etiqueta de ingestión identifica el analizador que normaliza los datos de registro sin procesar en formato UDM estructurado. La información de este documento se aplica al analizador con la etiqueta de ingestión GCP_APIGEE_X.

Antes de empezar

• Asegúrate de que todos los sistemas de la arquitectura de implementación estén configurados en la zona horaria UTC.

• Antes de empezar, confirma que tienes configurada la opción Recogida de registros con la política MessageLogging o Recogida de registros(antigua) con la política ServiceCallout.

• Para configurar la recogida de registros con la política MessageLogging, sigue los pasos de la guía de integración de Apigee Google Cloud .

Configurar Google Cloud para ingerir registros de Apigee

Para ingerir registros de Apigee en Google Security Operations, sigue los pasos que se indican en la página Ingerir registros en Google Security Operations Google Cloud .

Si tienes problemas al ingerir registros de Apigee, ponte en contacto con el equipo de Asistencia de Google Security Operations.

Formatos de registro de Apigee admitidos

El analizador de Apigee admite registros en formato JSON.

Registros de ejemplo de Apigee admitidos

• 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"
    }
  

Referencia de asignación de campos

En esta sección se explica cómo asigna el analizador de Google SecOps los campos de los registros de Apigee a los campos del modelo de datos unificado (UDM) de Google Security Operations.

Referencia de asignación de campos: recogida de registros de GCP_APIGEE_X con registros de la política MessageLogging

En la siguiente tabla se enumeran los campos de registro del tipo de registro GCP_APIGEE_X Recogida de registros con política de registro de mensajes y sus campos de UDM correspondientes.

Referencia de la asignación de campos: recogida de registros de GCP_APIGEE_X con registros de la política ServiceCallout

En la siguiente tabla se indican los campos de registro de la recogida de registros GCP_APIGEE_X (antigua) con el tipo de registro de la política ServiceCallout y sus campos de UDM correspondientes.

Siguientes pasos

• Ingestión de datos en Google Security Operations

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.