Registros de plataforma

Google Cloud ofrece dos tipos de registros de API Gateway:

Los servicios deGoogle Cloud generan automáticamente registros de plataforma para cada solicitud de API Gateway. Estos registros proporcionan visibilidad sobre el control de solicitudes, la autenticación y las interacciones con otros servicios de Google Cloud . Estos registros son fundamentales para depurar errores de la puerta de enlace, analizar el rendimiento y comprender los patrones de tráfico. Para obtener más información sobre los tipos de registros de plataforma, consulta lo siguiente:

  1. Cómo solicitar registros

    Cada entrada de registro representa una consulta que entrega tu API Gateway. Contiene información útil, como el código de estado HTTP, la latencia, el motivo de la respuesta, los tamaños de solicitud y respuesta, y mucho más para cada solicitud.

    En el caso de una solicitud del Protocolo de contexto del modelo (MCP), la entrada también contiene el método de MCP en jsonPayload.mcp.method y, para una solicitud tools/call, el nombre de la herramienta en jsonPayload.mcp.tool. Para obtener más información, consulta Configura el protocolo de contexto de modelo.

    Consulta de registro

    resource.type="apigateway.googleapis.com/Gateway"
    resource.labels.gateway_id="GATEWAY_ID"
    resource.labels.location="LOCATION"
    log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Frequests"
    • Donde GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Donde LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el comando anterior, PROJECT_ID es el ID del proyecto de Google Cloud .
  2. Registros de consultas de JWKS

    Cuando uses la autenticación de JWT, tu API Gateway realizará llamadas periódicas para recuperar las JWK requeridas del extremo de JWK especificado en tu configuración de la API. Estos registros muestran información útil sobre las solicitudes exitosas y fallidas a tu extremo de JWK.

    Consulta de registro

    resource.type="apigateway.googleapis.com/Gateway"
    resource.labels.gateway_id="GATEWAY_ID"
    resource.labels.location="LOCATION"
    log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Fjwks_queries"
    • Donde GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Donde LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el comando anterior, PROJECT_ID es el ID del proyecto de Google Cloud .
  3. Registros de consultas de Service Control

    Cuando tu API Gateway entrega tráfico, realiza llamadas check (para verificar la cuota y las claves de API) y report (para las métricas y los registros) a Google Cloud Control de servicios. Solo si falla una llamada check o report, se propaga un registro service_control_queries con más información.

    Consulta de registro

    resource.type="apigateway.googleapis.com/Gateway"
    resource.labels.gateway_id="GATEWAY_ID"
    resource.labels.location="LOCATION"
    log_name="projects/PROJECT_ID/logs/apigateway.googleapis.com%2Fservice_control_queries"
    • Donde GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Donde LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el comando anterior, PROJECT_ID es el ID del proyecto de Google Cloud .
  4. Registros de la API producida

    Además de los registros asociados con apigateway.googleapis.com, API Gateway también propaga los registros de la API producida. Estos registros se asocian con tu servicio administrado y se pueden usar para ver los registros en todas las API Gateways que implementan un servicio administrado específico.

    Consulta de registro

    resource.type="api"
    resource.labels.service="MANAGED_SERVICE"

    Donde MANAGED_SERVICE es el nombre de tu servicio administrado, que se puede encontrar consultando tu recurso de API de API Gateway.