Anfragen protokollieren

Auf dieser Seite erfährst du, wie du die Anfrageprotokollierung für Media CDN konfigurierst.

Logs aktivieren

Logging ist standardmäßig deaktiviert, um die gespeicherten Daten zu minimieren. Logs werden weitergeleitet, gefiltert und in Cloud Logging gespeichert.

  • So aktivieren Sie das Logging für einen bestimmten Media CDN-Dienst:

    gcloud edge-cache services update YOUR_SERVICE \
   --enable-logging \
   --logging-sample-rate=1.0

  • So deaktivieren Sie das Logging:

    gcloud edge-cache services update YOUR_SERVICE \
   --no-enable-logging

  • So rufen Sie den aktuellen Status des Loggings für einen Dienst ab:

    gcloud edge-cache services describe YOUR_SERVICE

    Die Ausgabe sieht in etwa so aus:

    ...
logConfig:
 enable: true
 sampleRate: 1.0
...

Abtastrate für Protokolle festlegen

Bei einem großen Anfragevolumen sollten Sie lieber Stichproben aus den Logs nehmen, als für jede Anfrage ein Log zu erstellen, und sich für das proaktive Monitoring und die Prüfung auf Messwerte verlassen.

Wenn Sie Logs nur für 10% Ihrer Anfragen aufnehmen und speichern möchten, setzen Sie logConfig.sampleRate auf 0.1:

gcloud edge-cache services update YOUR_SERVICE \
    --enable-logging \
    --logging-sample-rate=0.1

Logging muss aktiviert sein, um die Abtastrate zu ändern.

Die Abtastrate beträgt, sofern nicht anders angegeben, standardmäßig den Wert 0 (0%), wodurch jede Anfrage für den konfigurierten Dienst protokolliert wird.

Abfragelogs

Sie können Logs mithilfe des Log-Explorers in derGoogle Cloud -Konsole oder der Google Cloud CLI abfragen.

Wenn Sie Logs in der Google Cloud Console aufrufen möchten, filtern Sie nach dem Ressourcentyp „Media CDN“ und (optional) nach Projekt- und Dienstname.

Die folgende Logging-Abfrage zeigt die Logs für alle Ihre Media CDN-Dienste:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"

Wenn Sie nach Logs filtern möchten, die mit einer bestimmten EdgeCacheService-Ressource und einem bestimmten Projekt verknüpft sind, erweitern Sie diese Abfrage:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"
resource.labels.resource_container="projects/12345678"
resource.labels.service_name="MY_PROJECT"

Informationen zum Abgleich mit partiellen Namen oder zur Verwendung regulärer Ausdrücke finden Sie unter Vergleiche der Logging-Abfragesprache.

Beispiel: Cache-Fehler identifizieren

Eine Anfrage für ein Objekt kann aus folgenden Gründen ein Cache-Fehler haben und eine Cache-Füllung verursachen:

  • Eine zu kurze Gültigkeitsdauer (TTL)
  • Ein zu spezifischer Cache-Schlüssel
  • Zu wenige Anfragen für die Speicherung im Cache

Zum Identifizieren von Cache-Fehlern können Sie im Log-Explorer nach Logs filtern.

Die folgende Logabfrage zeigt Anfragen, die im Cache zwischengespeichert werden können (nachgeschlagen werden), aber ein Ausfüllen vom Ursprung erfordern:

resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"
resource.labels.resource_container="projects/12345678"
resource.labels.service_name="MY_PROJECT"
jsonPayload.cacheStatus="miss"

Wenn Sie nach einer bestimmten URL filtern müssen, können Sie nach dem Feld httpRequest.requestUrl filtern:

httpRequest.requestUrl = "URL"

Verwenden Sie den has-Operator, um nach einem Teil der URL zu filtern, z. B. der Pfadkomponente:

# `:` is the `has` comparison operator

httpRequest.requestUrl: "/videos/1381381_1080.mp4"
# You can use `OR` or `AND` to filter on multiple values

httpRequest.requestUrl: ("https://media-test.example.com/" OR "https://canary.example.net")

Weitere Informationen zur umfassenden Syntax von Logging für den Abgleich und die Filterung finden Sie unter Erweiterte Abfragen mit der Logging-Abfragesprache schreiben.

Gespeicherte Logs filtern

Wenn Sie Logs vor dem Speichern filtern möchten, z. B. um nur relevante Felder zu erfassen, um das Gesamtvolumen der zu speichernden und abzufragenden Logs zu reduzieren, können Sie Ausschlussfilter konfigurieren, mit denen Sie eine Abfrage (Filter) definieren können, die Felder vor der Speicherung ein- oder ausschließt.

Sie können auch mehrere Filter einrichten und beispielsweise alle Cache-Fehleranfragen oder alle Anfragen für einen bestimmten Hostnamen erfassen und nur eine Stichprobe aller Logs aufnehmen.

Logs weiterleiten

Media CDN lässt sich direkt in Cloud Logging einbinden. So können Sie Ihre Logs auf folgende Arten zusammenfassen und weiterleiten:

  • Zu Speicherzielen wie Cloud Storage und BigQuery

  • An Pub/Sub-Themen, die von Drittanbieterzielen abonniert werden können, um auf die Protokolle zuzugreifen

Eine Übersicht dazu, wie Protokolle aus Logging weitergeleitet werden, finden Sie unter Routing und Speicher – Übersicht.

Nächste Schritte