設定要求記錄功能

本頁面說明如何設定 Media CDN 的要求記錄。

啟用記錄功能

系統預設會停用記錄功能，以減少儲存的資料量。系統會將記錄檔路由、篩選並儲存在 Cloud Logging 中。

  • 為特定 Media CDN 服務啟用記錄功能：

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

  • 停用記錄：

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

  • 取得服務記錄的目前狀態：

    gcloud edge-cache services describe YOUR_SERVICE

    輸出結果會與下列內容相似：

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

設定記錄取樣率

如果要求量龐大，您可能會選擇擷取記錄樣本，並利用指標進行主動監控和調查，而非為每項要求擷取記錄。

如要只擷取及儲存 10% 要求的記錄，請將 logConfig.sampleRate 設為 0.1：

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

您必須啟用記錄功能，才能變更取樣率。

除非另有指定，否則取樣率預設為 0 (0%)，這會記錄已設定服務的每項要求。

查詢記錄

如要查詢記錄，您可以使用Google Cloud 控制台中的 記錄檔探索工具，也可以使用 Google Cloud CLI。

如要在 Google Cloud 控制台中查看記錄，請篩選 Media CDN 資源類型，並視需要依專案和服務名稱篩選。

以下記錄查詢會顯示所有 Media CDN 服務的記錄：

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

如要篩選與特定 EdgeCacheService 資源和專案相關聯的記錄，請擴充以下查詢：

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

如要比對部分名稱或使用規則運算式，請參閱記錄查詢語言比較。

範例：找出快取遺漏

物件要求可能會發生快取遺漏，但可能會因下列原因導致快取填補：

  • 存留時間 (TTL) 太短
  • 過於具體的快取索引鍵
  • 快取的要求數量太少

如要找出快取遺漏情形，您可以在 記錄檔探索工具中篩選記錄。

以下記錄查詢會顯示可快取 (查詢) 但需要從來源填入的請求：

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

如果您需要依據特定網址篩選，請篩選 httpRequest.requestUrl 欄位：

httpRequest.requestUrl = "URL"

如要篩選網址的部分內容 (例如路徑元件)，請使用 has 運算子：

# `:` 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")

如要進一步瞭解記錄查詢語言的完整比對和篩選語法，請參閱「使用記錄查詢語言撰寫進階查詢」。

篩選儲存的記錄

如要先篩選記錄再儲存 (例如只擷取相關欄位，以減少需要儲存及查詢的記錄總量)，您可以設定排除篩選器，藉此定義在儲存前要包含或排除的欄位。

您也可以設定多個篩選器，例如擷取所有快取遺漏要求或特定主機名稱的所有要求，並只擷取所有記錄的樣本。

路線記錄

Media CDN 可直接整合 Cloud Logging，協助您以下列方式匯總及路由記錄：

  • 儲存目的地 (例如 Cloud Storage 和 BigQuery)

  • 將記錄傳送至 Pub/Sub 主題，第三方目的地可訂閱該主題來存取記錄

如要瞭解 Logging 如何轉送記錄檔，請參閱「轉送和儲存空間總覽」。

後續步驟