הגדרת רישום ביומן של בקשות

בדף הזה מוסבר איך להגדיר רישום ביומן של בקשות ב-Media CDN.

הפעלת יומנים

רישום ביומן מושבת כברירת מחדל כדי לצמצם את כמות הנתונים שמאוחסנים. היומנים מנותבים, מסוננים ומאוחסנים ב-Cloud Logging.

  • הפעלת רישום ביומן עבור שירות Media CDN ספציפי:

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

  • השבתת הרישום ביומן:

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

  • כדי לקבל את המצב הנוכחי של הרישום ביומן בשירות מסוים:

    gcloud edge-cache services describe SERVICE_NAME

    הפלט אמור להיראות כך:

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

הגדרת קצב הדגימה של היומן

במקרים של נפח גדול של בקשות, במקום לתעד יומן לכל בקשה, יכול להיות שתעדיפו לדגום יומנים ולהסתמך על מדדים לצורך מעקב וחקירה פרואקטיביים.

כדי להטמיע ולאחסן יומנים רק עבור 10% מהבקשות, מגדירים את logConfig.sampleRate ל-0.1:

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

כדי לשנות את קצב הדגימה, צריך להפעיל את הרישום ביומן.

אם לא מציינים את קצב הדגימה, ברירת המחדל היא 0 (0%), כלומר כל בקשה לשירות המוגדר מתועדת.

יומני שאילתות

כדי לשלוח שאילתות ליומנים, אפשר להשתמש ב-Logs Explorer במסוף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) קצר מדי
  • מפתח מטמון ספציפי מדי
  • מעט מדי בקשות להשארת נתונים במטמון

כדי לזהות החמצות במטמון, אפשר לסנן את היומנים ב-Logs Explorer.

שאילתת היומן הבאה מציגה בקשות שאפשר לשמור במטמון (חיפוש), אבל שנדרש מילוי שלהן מהמקור:

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

אם אתם צריכים לסנן לפי כתובת URL ספציפית, אתם יכולים לסנן לפי השדה httpRequest.requestUrl:

httpRequest.requestUrl = "URL"

כדי לסנן לפי חלק מכתובת ה-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")

מידע נוסף על התחביר המקיף של Logging להתאמה ולסינון זמין במאמר כתיבת שאילתות מתקדמות באמצעות שפת השאילתות של Logging.

סינון יומנים מאוחסנים

כדי לסנן יומנים לפני שמאחסנים אותם – למשל, כדי לתעד רק שדות רלוונטיים ולהקטין את נפח היומן הכולל שצריך לאחסן ולשאול עליו שאילתות – אפשר להגדיר מסנני החרגה. המסננים האלה מאפשרים להגדיר שאילתה (מסנן) שכוללת או מחריגה שדות לפני האחסון.

אפשר גם להגדיר כמה מסננים – לדוגמה, לתעד את כל הבקשות של אי מציאה במטמון או את כל הבקשות של שם מארח ספציפי, ולקחת רק מדגם מכל היומנים.

יומני ניתוב

‫Media CDN משתלב ישירות עם Cloud Logging, וכך עוזר לכם לצבור ולנתב את היומנים בדרכים הבאות:

  • ליעדי אחסון, כמו Cloud Storage ו-BigQuery

  • לנושאי Pub/Sub, שאליהם יעדים של צד שלישי יכולים להירשם כדי לגשת ליומנים

סקירה כללית על ניתוב יומנים מ-Logging מופיעה במאמר סקירה כללית על ניתוב ואחסון.

המאמרים הבאים