צפייה ביומני אירועים של חברות בקבוצות מולטיקאסט

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

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

מידע על יומני אירועים של חברות בקבוצה

‫Google Cloud כותב יומני אירועים של חברות בקבוצה עבור שידור מרובה כתובות אל Cloud Logging.

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

משאב תיאור היומנים
טווח קבוצות מולטיקאסט

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

היומנים האלה זמינים רק בפרויקטים של אדמינים של שידורים מרובי משתתפים.

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

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

היומנים האלה זמינים בפרויקטים שמכילים הגדרות של צרכני multicast וברשתות המתאימות של צרכני multicast. אם אתם משתמשים ב-VPC משותף, זהו הפרויקט המארח.

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

אירועים שנשמרים ביומן

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

כשצרכן של שידור מרובה משתתפים שולח דוח חברות ב-IGMP כדי להצטרף לקבוצה, הודעות היומן שמתקבלות הן:

  • אם הצטרפות ל-IGMP מצליחה, מופיעות שתי הודעות ביומן: הודעה IGMP join request received ואחריה הודעה IGMP consumer joined.
  • הצטרפות IGMP שנכשלה מובילה לשתי הודעות ביומן: הודעה מסוג IGMP join request received ואחריה הודעה מסוג IGMP join request rejected due to *.
  • לצרכן מולטיקאסט שכבר הצטרף לקבוצה בהצלחה, בקשת הצטרפות IGMP keepalive בהודעה אחת IGMP join request received.

בטבלה הבאה מופיעה רשימה מלאה של האירועים שנרשמים ביומן ותיאורים שלהם.

אירוע תיאור
IGMP join request received

מישור הבקרה Google Cloud קיבל את בקשת ההצטרפות. ההודעה הזו לא מאשרת שההצטרפות הושלמה בהצלחה.

כל בקשה להצטרפות מתועדת, כולל בקשות keepalive שצרכני שידור מרובה כתובות שולחים מעת לעת כחלק מפרוטוקול IGMP.
IGMP consumer joined

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

תמיד קודם לאירוע הזה אירוע IGMP join request received.
IGMP consumer left

מישור הבקרה Google Cloud קיבל בקשת יציאה מפורשת מ-IGMP מצרכן המולטיקאסט ויישם את הבקשה.
IGMP consumer timed out

מישור הבקרה Google Cloud הסיר את צרכן ה-Multicast מהקבוצה כי הוא הפסיק להגיב לבקשות keepalive.
Consumer removed due to configuration change

מישור הבקרה Google Cloud הסיר את הצרכן של שידור מרובה משתתפים מהקבוצה כי נקודת הקצה של הצרכן נמחקה. לדוגמה, יכול להיות שמופע הצרכן או הפרויקט נמחקו.
IGMP join request rejected due to full tree

מישור הבקרה Google Cloud קיבל את בקשת ההצטרפות, אבל דחה אותה כי הקבוצה לשידור מרובה משתתפים כבר מלאה.
IGMP join request rejected due to missing quota

Google Cloud מישור הבקרה קיבל את בקשת ההצטרפות, אבל דחה אותה כי ברשת ה-VPC של צרכן ה-Multicast כבר נעשה שימוש בכל המכסות של מכונות וירטואליות של צרכן ה-Multicast לכל רשת VPC.
IGMP join request rejected due to unknown reason

מישור הבקרה Google Cloud קיבל את בקשת ההצטרפות, אבל דחה את הבקשה בגלל כשל שלא מוסבר בסיבה ייעודית.
IGMP entitlement rejected

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

  • ההגדרה של רשת ה-VPC של צרכן ה-multicast לא הושלמה.
  • ההגדרה של רשת ה-VPC של צרכן ה-multicast לא הועברה לתשתית ה-multicast של הדומיין.
  • צרכן ה-multicast לא מוגדר ל-IGMP.

האירוע הזה זמין רק ביומנים של משאב ההפעלה של הצרכן בקבוצת ה-Multicast.
Consumer network activated

הופעלה רשת VPC של צרכן multicast עבור טווח של קבוצת multicast. הפעולה הזו מקבילה ליצירה של משאב multicast group consumer activation.

האירוע הזה זמין רק לאדמינים של שידורים לקבוצות ביומנים של משאבי טווח קבוצות לשידורים לקבוצות.
Consumer network deactivated

רשת VPC של צרכן multicast הושבתה עבור טווח של קבוצת multicast. כלומר, משאב של הפעלת צרכן של קבוצת מולטיקאסט נמחק או שהסטטוס שלו השתנה ל-INACTIVE.

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

פורמט היומן לטווחים של קבוצות מולטיקאסט

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

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

סוג המשאב במעקב ושם היומן ב-Cloud Logging הם:

  • Resource type: networkservices.googleapis.com/MulticastGroupRange
  • שם היומן: networkservices.googleapis.com%2Fmulticast_memberships

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

אירוע IGMP

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

שדה סוג תיאור
consumerIp מחרוזת כתובת ה-IPv4 הפנימית הראשית של הצרכן של שידור מרובה משתתפים. דוגמה: 10.0.0.1
consumerLocation מחרוזת האזור של ה-VPC של צרכן ה-multicast. דוגמה: us-east5-a
consumerNetwork משאב רשת ה-VPC של צרכן ה-multicast. רק מזהה המספר השלם מאוכלס. דוגמה: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Project הפרויקט שמכיל את רשת ה-VPC של צרכן ה-multicast. רק מספר הפרויקט מאוכלס. דוגמה: 
      consumerProject {
       number: "5678"
      }
consumerResource משאב המכונה הווירטואלית של צרכן ה-multicast. רק מזהה המספר השלם מאוכלס. דוגמה: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Project הפרויקט שמכיל את מכונת ה-VM של צרכן ה-multicast. יכול להיות שהפרויקט הזה יהיה שונה מהפרויקט שמכיל את רשת ה-VPC של צרכן המולטיקאסט, למשל כשמשתמשים ב-VPC משותף. רק מספר הפרויקט מאוכלס. דוגמה: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription מחרוזת אחד מהאירועים שמתוארים בקטע אירועים שמתועדים ביומן. לדוגמה: IGMP consumer joined.
eventTime מחרוזת חותמת הזמן של האירוע בפורמט טקסט RFC 3339. לדוגמה: 2024-10-21T06:46:42.990162973Z.
multicastDomain מחרוזת השם של דומיין ה-multicast. דוגמה: my-domain-name
multicastGroupRange מחרוזת השם של טווח קבוצות ה-multicast. דוגמה: my-group-range-name
multicastIp מחרוזת כתובת ה-IP של קבוצת המולטיקאסט. דוגמה: 224.0.0.1

הפעלה/השבתה

אם האירוע שנרשם ביומן הוא הפעלה או השבתה של רשת VPC של צרכן מולטיקאסט, היומן כולל את השדות הבאים:

שדה סוג תיאור
consumerLocation מחרוזת האזור שבו הופעלה רשת ה-VPC של צרכן ה-Multicast. דוגמה: us-east5-a
consumerNetwork משאב רשת ה-VPC של צרכן ה-multicast. רק מזהה המספר השלם מאוכלס. דוגמה: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Project הפרויקט שמכיל את רשת ה-VPC של צרכן ה-multicast. רק מספר הפרויקט מאוכלס. דוגמה: 
      consumerProject {
       number: "5678"
      }
eventDescription מחרוזת אחד מהאירועים שמתוארים בקטע אירועים שמתועדים ביומן. לדוגמה: Consumer network activated.
eventTime מחרוזת חותמת הזמן של האירוע בפורמט טקסט RFC 3339. לדוגמה: 2024-10-21T06:46:42.990162973Z.
multicastDomain מחרוזת השם של דומיין ה-multicast. דוגמה: my-domain-name
multicastGroupRange מחרוזת השם של טווח קבוצות ה-multicast. דוגמה: my-group-range-name

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

פורמט היומן של הפעלות צרכנים של קבוצות multicast

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

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

סוג המשאב במעקב ושם היומן ב-Cloud Logging הם:

  • Resource type: networkservices.googleapis.com/MulticastGroupConsumerActivation
  • שם היומן: networkservices.googleapis.com%2Fmulticast_memberships

היומן כולל את השדות הבאים:

שדה סוג תיאור
consumerIp מחרוזת כתובת ה-IPv4 הפנימית הראשית של הצרכן של שידור מרובה משתתפים. דוגמה: 10.0.0.1
consumerLocation מחרוזת האזור של צרכן ה-multicast. דוגמה: us-east5-a
consumerNetwork משאב רשת ה-VPC של צרכן ה-multicast. דוגמה: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Project הפרויקט שמכיל את רשת ה-VPC של צרכן ה-multicast. דוגמה: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource משאב המכונה הווירטואלית של צרכן ה-multicast. דוגמה: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Project הפרויקט שמכיל את מכונת ה-VM של צרכן ה-multicast. יכול להיות שהפרויקט הזה יהיה שונה מהפרויקט שמכיל את רשת ה-VPC של צרכן המולטיקאסט, למשל כשמשתמשים ב-VPC משותף. דוגמה: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription מחרוזת אחד מהאירועים שמתוארים בקטע אירועים שמתועדים ביומן. לדוגמה: IGMP consumer joined.
eventTime מחרוזת חותמת הזמן של האירוע בפורמט טקסט RFC 3339. לדוגמה: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation מחרוזת השם של שיוך צרכן ה-multicast בין רשת ה-VPC של צרכן ה-multicast לבין הדומיין. דוגמה: my-consumer-association-name
multicastGroupConsumerActivation מחרוזת השם של הפעלת הצרכן של קבוצת המולטיקאסט. דוגמה: my-group-consumer-activation-name
multicastIp מחרוזת כתובת ה-IP של קבוצת המולטיקאסט. דוגמה: 224.0.0.1

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

הפניה לפורמט של שדה

פרויקט

שדה סוג תיאור
number מחרוזת (uint64) מזהה הפרויקט כמספר שלם שנוצר באופן אוטומטי. דוגמה: 5678
id מחרוזת המזהה שהוקצה לפרויקט על ידי המשתמש. דוגמה: my-project

משאב

שדה סוג תיאור
id מחרוזת (uint64) מזהה המשאב כמספר שלם שנוצר באופן אוטומטי. דוגמה: 1111
name מחרוזת השם שהמשתמש הקצה למשאב. דוגמה: my-instance

הפעלת רישום ביומן של אירועים שקשורים לחברות בקבוצה

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

הפעלת רישום ביומן לטווח של קבוצות מולטיקאסט

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

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

אפשר להגדיר רישום ביומן של אירועים שקשורים לחברות בשני המקורות הבאים:

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

gcloud

  • כדי להפעיל או להשבית רישום ביומן לטווח של קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-ranges update.

    gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
    --location=global \
    [--enable-logging | --no-enable-logging]

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
    • ‫--[no-]enable-logging: קובעת אם רישום ביומן של אירועי חברות מופעל.
      • כדי להפעיל את הרישום ביומן, משתמשים ב---enable-logging.
      • כדי להשבית את הרישום ביומן, משתמשים ב---no-enable-logging.

  • כדי להפעיל או להשבית רישום ביומן להפעלה של טווח קבוצות מולטיקאסט, משתמשים בפקודה network-services multicast-group-range-activations update.

    gcloud network-services multicast-group-range-activations update GROUP_RANGE_ACTIVATION_NAME \
    --location=ZONE \
    [--enable-logging | --no-enable-logging]

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫GROUP_RANGE_ACTIVATION_NAME: השם של טווח ההפעלה של קבוצת הכתובות לשידור מרובה משתתפים
    • ‫ZONE: האזור של הפעלת טווח קבוצות ה-Multicast
    • ‫--[no-]enable-logging: קובעת אם רישום ביומן של אירועי חברות מופעל.
      • כדי להפעיל את הרישום ביומן, משתמשים ב---enable-logging.
      • כדי להשבית את הרישום ביומן, משתמשים ב---no-enable-logging.

API

  • כדי להפעיל או להשבית את הרישום ביומן של טווח קבוצות מולטיקאסט, משתמשים בשיטה multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט
    • ‫GROUP_RANGE_NAME: השם של טווח קבוצות ה-Multicast
    • ‫LOGGING_ENABLED: מציין אם רישום ביומן של אירועים שקשורים למינוי מופעל.
      • כדי להפעיל את הרישום ביומן, מגדירים את הערך true.
      • כדי להשבית את הרישום ביומן, מגדירים את הערך false.

  • כדי להפעיל או להשבית את הרישום ביומן של הפעלה של טווח קבוצות מולטיקאסט, משתמשים בmulticastGroupRangeActivations.patch method.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט
    • ‫GROUP_RANGE_ACTIVATION_NAME: השם של טווח ההפעלה של קבוצת הכתובות לשידור מרובה משתתפים
    • ‫ZONE: האזור של הפעלת טווח קבוצות ה-Multicast
    • ‫LOGGING_ENABLED: מציין אם רישום ביומן של אירועים שקשורים למינוי מופעל.
      • כדי להפעיל את הרישום ביומן, מגדירים את הערך true.
      • כדי להשבית את הרישום ביומן, מגדירים את הערך false.

הפעלת רישום ביומן עבור הפעלה של צרכן בקבוצת מולטיקאסט

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

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

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

gcloud

כדי להפעיל או להשבית רישום ביומן להפעלת צרכן של קבוצת מולטיקאסט, משתמשים בפקודה network-services multicast-group-consumer-activations update.

  gcloud network-services multicast-group-consumer-activations update GROUP_CONSUMER_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

מחליפים את מה שכתוב בשדות הבאים:

  • ‫GROUP_CONSUMER_ACTIVATION_NAME: השם של הפעלת הצרכן של קבוצת ה-Multicast
  • ‫ZONE: האזור של הפעלת צרכן קבוצת ה-multicast
  • ‫--[no-]enable-logging: קובעת אם רישום ביומן של אירועי חברות מופעל.
    • כדי להפעיל את הרישום ביומן, משתמשים ב---enable-logging.
    • כדי להשבית את הרישום ביומן, משתמשים ב---no-enable-logging.

API

כדי להפעיל או להשבית את הרישום ביומן עבור הפעלת צרכן של קבוצת מולטיקאסט, משתמשים בשיטה multicastGroupConsumerActivations.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME?updateMask=logConfig
  {
    "logConfig": {"enabled": "LOGGING_ENABLED"}
  }

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט
  • ‫GROUP_CONSUMER_ACTIVATION_NAME: השם של הפעלת הצרכן של קבוצת ה-Multicast
  • ‫ZONE: האזור של הפעלת צרכן קבוצת ה-multicast
  • ‫LOGGING_ENABLED: מציין אם רישום ביומן של אירועים שקשורים למינוי מופעל.
    • כדי להפעיל את הרישום ביומן, מגדירים את הערך true.
    • כדי להשבית את הרישום ביומן, מגדירים את הערך false.

צפייה ביומני אירועים של חברות בקבוצות

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

מידע נוסף זמין במאמר סקירה כללית על Logs Explorer.

המסוף

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

    כניסה לדף Logs Explorer

  2. כדי לראות יומני אירועים של חברות בקבוצות multicast, בוחרים אחד מסוגי המשאבים במעקב הבאים מהרשימה All resources:
    • אם אתם אדמינים של שידור מרובה משתתפים ורוצים לראות את יומני האירועים של חברות בקבוצה של כל הצרכנים של שידור מרובה משתתפים בקבוצה, אתם צריכים לבחור באפשרות טווח קבוצות של שידור מרובה משתתפים.
    • אם אתם אדמינים של רשת VPC שהיא צרכן של שידור מרובה משתתפים ורוצים לראות יומני אירועים של חברות בקבוצה ברשת שלכם, בוחרים באפשרות הפעלה של צרכן בקבוצת שידור מרובה משתתפים.

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