התאמה אזורית של היומנים

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

אפשר גם להגדיר מיקום אחסון שיוגדר כברירת מחדל לדלי _Default ודלי _Required חדשים על ידי הגדרת ברירת מחדל לארגון או לתיקייה. מידע נוסף זמין במאמר הגדרת מיקום אחסון ברירת מחדל.

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

  1. יוצרים קטגוריית יומנים באזור המיועד לאחסון היומנים.

  2. מפנים את יעד הטבילה _Default כדי לנתב את היומנים לקטגוריה ביומן החדשה.

  3. חיפוש יומנים ב-Logs Explorer.

סקירה כללית

ב-Logging, מאגרי יומנים הם משאבים אזוריים: התשתית שמאחסנת את היומנים, יוצרת אינדקסים ומבצעת חיפושים בהם ממוקמת במיקום גיאוגרפי ספציפי. למעט קטגוריות ביומן באזורים global, eu או us,‏Google Cloud מנהל את התשתית כך שהאפליקציות שלכם יהיו זמינות באופן יתיר באזורים בתוך האזור של קטגוריית היומן.

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

אם יש לכם דרישות לגבי מיקום הנתונים, אל תפעילו שירותים שיכולים לשלוח שאילתות לנתוני יומן ולשמור את תוצאת השאילתה במיקום global. דוגמה לשירות כזה היא Gemini Cloud Assist.

מושגים מרכזיים

המושגים הבאים חלים על אזוריות הנתונים ב-Logging.

מיקומים של Log Router

Log Router מעבד את כל רשומות היומן שנכתבות ב-Cloud Logging API. הוא בודק כל רשומה ביומן מול הכללים הקיימים כדי לקבוע אילו רשומות ביומן לשמור בדלי Logging ואילו רשומות ביומן לנתב ליעדים נתמכים באמצעות sinks. כדי לנתב את היומנים בצורה מהימנה, נתב היומנים מאחסן את היומנים גם באופן זמני, וכך מגן מפני שיבושים זמניים בכל יעד.

הכלי Log Router מעבד את היומנים באזור שבו הם מתקבלים. יכול להיות שנתוני היומן יישלחו לאזור אחר על ידי נתב היומנים, בהתאם להגדרות של sink או אם בחרתם לשתף את נתוני היומן עם שירות אחר שלGoogle Cloud Google, כמו Security Command Center Threat Detection. מאגרי נתונים חלים על יומנים באופן שווה ולא משנה באיזה אזור הם נמצאים.

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

מאגרי יומנים הם מאגרי נתונים בGoogle Cloud פרויקט, בחשבון לחיוב, בתיקייה ובארגון, שבהם מאוחסנים ומאורגנים נתוני היומנים.

לכל Google Cloud פרויקט, חשבון לחיוב, תיקייה וארגון, Logging יוצר באופן אוטומטי שתי קטגוריות של יומנים: _Required ו-_Default, שנמצאות במיקום global. אי אפשר לשנות את המיקום של קטגוריות קיימות. עם זאת, הארגון יכול ליצור מדיניות שמגדירה מיקום ברירת מחדל שונה לדליים האלה. מידע נוסף מופיע במאמר קביעת הגדרות ברירת מחדל לארגונים ולתיקיות.

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

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

האזור של קטגוריה ביומן מוצג בדף Logs Storage ובחלק מתיבות הדו-שיח. לדוגמה, כשעוברים לדף Logs Explorer ומשתמשים בבורר צמצום ההיקף כדי להציג רשימה של תצוגות יומן, מוצג גם מידע על האזור. בבורר הזה, כשהאזור הוא global, גם האזור וגם מיקום האחסון הנוכחי מוצגים בפורמט שדומה ל-GLOBAL (US-WEST4).

לפני שמתחילים

  1. מזהים את Google Cloud הפרויקט שבו יאוחסנו רשומות היומן.
  2. מזהים את השם והמיקום של קטגוריה ביומן שבה יישמרו רשומות ביומן.
  3. קובעים אילו רשומות ביומן רוצים להפנות אל קטגוריה ביומן. במדריך הזה אנחנו כוללים את כל היומנים שמועברים על ידי יעד _Default הנתונים.

  4. במסוף Google Cloud , מפעילים את Cloud Shell.

    הפעלת Cloud Shell

    בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

אזורים נתמכים

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

יצירת קטגוריית יומן

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

  1. פותחים מעטפת.

    לדוגמה, כדי להשתמש ב-Cloud Shell:

    1. נכנסים למסוף Google Cloud :

      כניסה למסוף Google Cloud

    2. בסרגל הכלים, לוחצים על  הפעלת Cloud Shell.

  2. כדי ליצור קטגוריה ביומן, מריצים את הפקודה gcloud logging buckets create במעטפת. לפני שמריצים את הפקודה לדוגמה, מחליפים את המשתנים הבאים בערכים:

    • ‫BUCKET_ID: השם או המזהה של קטגוריה ביומן.
    • ‫LOCATION: המיקום של קטגוריה ביומן.
    • ‫PROJECT_ID: מזהה הפרויקט.

    פקודה לדוגמה:

    gcloud logging buckets create BUCKET_ID \
  --location=LOCATION \
  --project=PROJECT_ID

  3. מוודאים שהקטגוריה נוצרה:

    gcloud logging buckets list --project=PROJECT_ID

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

הפניה מחדש של _Default יעד היומנים

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

כדי לעדכן יעד, מריצים את הפקודה gcloud logging sinks update. לפני שמריצים את הפקודה לדוגמה, מחליפים את המשתנים הבאים בערכים:

  • ‫_Default: בדוגמה הזו מתבצע עדכון של היעד של מקור הנתונים שנקרא _Default. אם רוצים לעדכן יעד אחר, צריך לשנות את השם של המשתנה הזה.
  • ‫BUCKET_ID: השם או המזהה של קטגוריה ביומן.
  • ‫LOCATION: המיקום של קטגוריה ביומן.
  • ‫PROJECT_ID: מזהה הפרויקט.

פקודה לדוגמה:

gcloud logging sinks update _Default \
  logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
  --log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT
    LOG_ID("externalaudit.googleapis.com/activity") AND NOT
    LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT
    LOG_ID("externalaudit.googleapis.com/system_event") AND NOT
    LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT
    LOG_ID("externalaudit.googleapis.com/access_transparency")' \
  --description="Updated the _Default sink to route logs to the LOCATION region"

יצירת רשומה ביומן כדי לבדוק את מאגר הנתונים

כדי לוודא שעדכנתם את יעד הנתונים כמו שצריך, מבצעים את השלבים הבאים:

  1. שולחים הודעת יומן בדיקה לקטגוריה האזורית באמצעות הפקודה gcloud logging write. לפני שמריצים את הפקודה לדוגמה, מחליפים את המשתנים הבאים בערכים:

    • ‫LOG_NAME: השם של היומן.
    • ‫BUCKET_ID: השם או המזהה של קטגוריה ביומן.
    • ‫PROJECT_ID: מזהה הפרויקט.

    פקודה לדוגמה:

    gcloud logging write LOG_NAME "Test to route logs to BUCKET_ID" \
--project=PROJECT_ID

  2. כדי לראות את הרשומה ביומן:

    1. במסוף Google Cloud , נכנסים לדף Logs Explorer:

      כניסה אל Logs Explorer

      אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.

    2. בסרגל הכלים, לוחצים על Refine scope (הגדרת היקף) ואז בוחרים באפשרות Current project (הפרויקט הנוכחי).

      הכלי Logs Explorer מוגדר להצגת רשומות ביומן שמקורן בפרויקט.

    3. בחלונית Log field, בוחרים את סוג המשאב Global.

    4. רשומת יומן הבדיקה מוצגת בחלונית Query results.

חיפוש ביומנים במסוף Google Cloud

כדי לראות את רשומות היומן בקטגוריה ביומן, עוברים אלGoogle Cloud המסוף ומבצעים את השלבים הבאים:

  1. במסוף Google Cloud , נכנסים לדף Logs Explorer:

    כניסה אל Logs Explorer

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.

  2. לוחצים על צמצום ההיקף.

  3. בחלונית Refine scope, בוחרים באפשרות Log view.

  4. בוחרים את התצוגה המפורטת _AllLogs שמשויכת ל-BUCKET_NAME.

  5. לוחצים על אישור.

    Logs Explorer מתעדכן כדי להציג יומנים מהמאגר.

    מידע על השימוש ב-Logs Explorer זמין במאמר הצגת יומנים באמצעות Logs Explorer.

השלבים הבאים