Auf dieser Seite erfahren Sie, wie Sie das Anfrage-Logging konfigurieren. für Media CDN.
Logs aktivieren
Logging ist standardmäßig deaktiviert, um die gespeicherten Daten zu minimieren. Logs werden weitergeleitet, gefiltert und gespeichert in Cloud Logging:
Aktivieren Sie die Protokollierung für einen bestimmten Media CDN-Dienst:
gcloud edge-cache services update YOUR_SERVICE \ --enable-logging \ --logging-sample-rate=1.0
Deaktivieren Sie das Logging:
gcloud edge-cache services update YOUR_SERVICE \ --no-enable-logging
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 ...
Log-Sampling-Rate festlegen
Bei großen Anfragen müssen Sie, anstatt für jede Anfrage ein Log zu erfassen, ziehen möglicherweise Stichproben von Logs und Messwerten für das proaktive Monitoring vor. und Ermittlungen.
Wenn Sie Logs nur für 10% Ihrer Anfragen aufnehmen und speichern möchten, legen Sie
logConfig.sampleRate in 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.
Sofern nicht anders angegeben, ist die Stichprobenrate standardmäßig auf 0 (0%) festgelegt, was protokolliert jede Anfrage für den konfigurierten Dienst.
Abfragelogs
Zum Abfragen von Logs können Sie den Log-Explorer in der Google Cloud Console oder die Google Cloud CLI.
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 Protokolle für alle Ihre Media CDN-Dienste:
resource.type="edgecache.googleapis.com/EdgeCacheRouteRule"
Zum Filtern nach Logs, die mit einer bestimmten EdgeCacheService-Ressource verknüpft sind, und
Projekt ist, 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 von Teilnamen oder zur Verwendung regulärer Ausdrücke finden Sie im Abschnitt zur Logging-Abfrage Sprachvergleiche
Beispiel: Cache-Fehler identifizieren
Eine Objektanfrage kann ein Cache-Fehler sein, folgenden Gründen:
- 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öchten, filtern Sie nach dem
Feld httpRequest.requestUrl:
httpRequest.requestUrl = "URL"
Wenn Sie nach einem Teil der URL filtern möchten, z. B. nach der Pfadkomponente, verwenden Sie die Funktion has
Operator:
# `:` 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 Logging-Syntax für den Abgleich und Filtern, siehe Erweiterte Abfragen mithilfe der Logging-Abfrage schreiben Sprache.
Gespeicherte Logs filtern
Um Logs vor dem Speichern zu filtern, z. B. nur die relevanten Felder zu erfassen um das gesamte Logvolumen zu reduzieren, das Sie speichern und abfragen müssen. Konfigurieren Sie Ausschlussfilter, mit denen Sie eine Abfrage (einen Filter) definieren können, die Felder ein- oder ausschließt vor der Speicherung.
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, unterstützt Sie beim Aggregieren und Routing Ihrer Logs auf folgende Weise:
An Speicherziele wie Cloud Storage und BigQuery
An Pub/Sub-Themen, an die Drittanbieterziele weitergeleitet werden können Abonnieren, um auf die Logs zuzugreifen
Eine Übersicht über das Routing von Logs aus Logging finden Sie unter Routing und Speicher
Nächste Schritte
- Weitere Informationen zum Einrichten logbasierter Messwerte zum Definieren des eigenen Messwerten basierend auf protokollierten Anfragen, siehe den Abschnitt Logbasierte Messwerte .
- Weitere Informationen zu den Preisen für Logging finden Sie unter Google Cloud Observability – Preise
- Informationen zur Funktionsweise von Audit-Logging und zum Aktivieren und Konfigurieren von Audit-Logs für Administratoraktivitäten finden Sie in der Cloud-Audit-Logs – Dokumentation.