Plattform-Logs

Google Cloud bietet zwei Arten von API Gateway-Logs:

Google Cloud -Dienste generieren automatisch Plattformlogs für jede API Gateway-Anfrage. Diese Logs bieten Einblick in die Verarbeitung von Anfragen, die Authentifizierung und die Interaktionen mit anderen Google Cloud -Diensten. Diese Logs sind wichtig, um Gateway-Fehler zu beheben, die Leistung zu analysieren und Trafficmuster zu verstehen. Weitere Informationen zu Arten von Plattformlogs finden Sie unter:

  1. Anforderungsprotokolle

    Jeder Logeintrag stellt eine von Ihrem API-Gateway verarbeitete Anfrage dar. Es enthält nützliche Informationen wie den HTTP-Statuscode, die Latenz, den Antwortgrund, die Größen von Anfragen und Antworten und mehr für jede Anfrage.

    Log-Abfrage

    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"
    • Dabei ist GATEWAY_ID der Name Ihrer API Gateway-Instanz.
    • Dabei ist LOCATION die Region, in der Ihre API Gateway-Instanz bereitgestellt wird.
    • Dabei ist PROJECT_ID die ID Ihres Google Cloud -Projekts.
  2. JWKS-Abfrageprotokolle

    Wenn Sie die JWT-Authentifizierung verwenden, ruft Ihr API Gateway regelmäßig den angegebenen JWKs-Endpunkt in Ihrer API-Konfiguration auf, um die erforderlichen JWKs abzurufen. Diese Logs enthalten nützliche Informationen zu erfolgreichen und nicht erfolgreichen Anfragen an Ihren JWKs-Endpunkt.

    Log-Abfrage

    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"
    • Dabei ist GATEWAY_ID der Name Ihrer API Gateway-Instanz.
    • Dabei ist LOCATION die Region, in der Ihre API Gateway-Instanz bereitgestellt wird.
    • Dabei ist PROJECT_ID die ID Ihres Google Cloud -Projekts.
  3. Logs für Service Control-Abfragen

    Wenn Ihr API Gateway Traffic verarbeitet, werden check- (zum Überprüfen von Kontingenten und API-Schlüsseln) und report-Aufrufe (für Messwerte und Logs) an Google Cloud Service Control gesendet. Nur wenn ein check- oder report-Aufruf fehlschlägt, wird ein service_control_queries-Log mit weiteren Informationen ausgegeben.

    Log-Abfrage

    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"
    • Dabei ist GATEWAY_ID der Name Ihrer API Gateway-Instanz.
    • Dabei ist LOCATION die Region, in der Ihre API Gateway-Instanz bereitgestellt wird.
    • Dabei ist PROJECT_ID Ihre Google Cloud -Projekt-ID.
  4. Protokolle der produzierten API

    Zusätzlich zu den Protokollen, die mit apigateway.googleapis.com verknüpft sind, werden auch Protokolle für erstellte APIs in API Gateway eingetragen. Diese Logs sind Ihrem verwalteten Dienst zugeordnet und können verwendet werden, um Logs für alle API Gateways aufzurufen, die einen bestimmten verwalteten Dienst implementieren.

    Log-Abfrage

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

    Dabei ist MANAGED_SERVICE der Name Ihres verwalteten Dienstes, den Sie durch Abfragen Ihrer API Gateway-API-Ressource ermitteln können.