Registros de plataforma

Google Cloud ofrece dos tipos de registros de API Gateway:

Los servicios deGoogle Cloud generan automáticamente registros de la plataforma para cada solicitud de API Gateway. Estos registros proporcionan visibilidad sobre el procesamiento 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 la plataforma, consulta lo siguiente:

  1. Cómo solicitar registros

    Cada entrada de registro representa una consulta que publicó 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.

    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"
    • Aquí, GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Aquí, LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el ejemplo anterior, PROJECT_ID es el ID de tu proyecto de Google Cloud .
  2. Registros de consultas de JWKS

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

    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"
    • Aquí, GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Aquí, LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el ejemplo anterior, PROJECT_ID es el ID de tu proyecto de Google Cloud .
  3. Registros de consultas de Control de servicios

    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 Service Control. Solo si falla una llamada de check o report, se propaga un registro de 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"
    • Aquí, GATEWAY_ID es el nombre de tu instancia de API Gateway.
    • Aquí, LOCATION es la región en la que se implementa tu instancia de API Gateway.
    • En el ejemplo anterior, PROJECT_ID es el ID de tu proyecto de Google Cloud .
  4. Registros de la API producida

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

    Consulta de registro

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

    Aquí, MANAGED_SERVICE es el nombre de tu servicio administrado, que puedes encontrar consultando el recurso de la API de API Gateway.