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

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

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

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

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

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

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

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

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

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

יומני אירועים של חברות בקבוצה עבור צרכני Multicast ברשת VPC ספציפית של צרכני 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 הבקרה הסיר את הצרכן של שידור מרובה משתתפים מהקבוצה כי הצרכן הפסיק להגיב לבקשות keepalive.
Consumer removed due to configuration change

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

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

Google Cloud מישור הבקרה קיבל את בקשת ההצטרפות, אבל דחה אותה כי רשת ה-VPC של צרכן המולטיקאסט כבר משתמשת בכל המכסות שלה למכונות וירטואליות של צרכן מולטיקאסט לכל רשת 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 משאב מכונת ה-VM של צרכן ה-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 של קבוצת ה-multicast. דוגמה: 224.0.0.1

הפעלה/השבתה

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

שדה סוג תיאור
consumerLocation מחרוזת האזור שבו הופעלה רשת ה-VPC של צרכן המולטיקאסט. דוגמה: 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.

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

סוג המשאב במעקב ושם היומן ב-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 משאב מכונת ה-VM של צרכן ה-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 מחרוזת השם של הפעלת צרכן של קבוצת multicast. דוגמה: my-group-consumer-activation-name
multicastIp מחרוזת כתובת ה-IP של קבוצת ה-multicast. דוגמה: 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 נתונה שהפעלתם בה את האפשרות לצרוך תנועת מולטיקאסט, אתם יכולים להגדיר רישום ביומן של אירועי חברות בהפעלה של צרכן קבוצת המולטיקאסט המתאימה.

מידע נוסף על הגדרת רישום ביומן כשיוצרים הפעלה חדשה של צרכן בקבוצת מולטיקאסט זמין במאמר הפעלת צריכה של תנועת מולטיקאסט ברשת 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. כדי לראות יומני אירועים של חברות בקבוצת מולטיקאסט, בוחרים אחד מסוגי המשאבים במעקב הבאים מהרשימה All resources:
    • אם אתם אדמינים של שידור מרובה משתתפים ורוצים לראות את יומני האירועים של חברות בקבוצה של כל הצרכנים של שידור מרובה משתתפים בקבוצה, בוחרים באפשרות טווח של קבוצות לשידור מרובה משתתפים.
    • אם אתם אדמינים של רשת VPC עם צרכני Multicast ורוצים לראות יומני אירועים של חברות בקבוצה ברשת שלכם, בוחרים באפשרות הפעלה של צרכני קבוצת Multicast.

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