查看 ULL 多點傳播的群組成員資格事件記錄

本頁提供可用於監控多點播送群組成員資格事件 (例如 IGMP 聯結) 的記錄資訊,並說明如何啟用及查看這些記錄。

您可以透過這些記錄瞭解多點傳播群組中的活動,例如多點傳播消費者加入和離開的時間,或是群組中的多點傳播消費者人數。

關於群組成員事件記錄

Google Cloud 會將多點傳播的群組成員資格事件記錄檔寫入 Cloud Logging。

下表列出各資源類型可用的記錄摘要,包括接收記錄的專案。如要進一步瞭解記錄的事件和記錄格式,請參閱下列章節。

資源 記錄說明
多點傳播群組用戶啟用作業

針對已啟用群組範圍和可用區的特定多點傳播用戶虛擬私有雲網路,記錄多點傳播用戶的群組成員資格事件。

這些記錄會顯示在包含多點傳播用戶端設定和對應多點傳播用戶端網路的專案中。 如果您使用 Shared VPC,這就是主專案。

請參閱「啟用多點傳播群組用戶啟用作業的記錄功能」。

記錄事件

本節說明 Cloud Logging 中記錄的多點傳播群組成員資格事件。

當多點播送消費者傳送 IGMP 成員資格報告來加入群組時,產生的記錄訊息如下:

  • 如果 IGMP 聯播成功,系統會產生兩則記錄訊息:IGMP join request received 訊息,後面接著 IGMP consumer joined。
  • 對於已成功加入群組的多點傳播消費者,請在單一 IGMP join request received 訊息中發出 IGMP 保持連線加入要求。

如需完整的記錄事件清單和說明,請參閱下表。

事件 說明
IGMP join request received

Google Cloud 控制層收到加入要求。這則訊息不會確認加入作業是否順利完成。

系統會記錄每項加入要求,包括多點傳播消費者定期傳送的存活要求 (這是 IGMP 通訊協定的一部分)。

IGMP consumer joined

Google Cloud 控制層已成功將多點傳播消費者新增至群組。這個事件傳播至網域的多點傳播基礎架構後,多點傳播消費者就會開始接收多點傳播流量。

這個事件一律會先觸發 IGMP join request received 事件。

IGMP consumer left

Google Cloud 控制層收到來自多點播送消費者的明確 IGMP 離開要求,並套用該要求。

IGMP consumer timed out

多點傳播消費者停止回應存活要求,因此 Google Cloud 控制平面已將多點傳播消費者從群組中移除。

IGMP entitlement rejected

Google Cloud 控制層收到加入要求,但因必要的多播消費者設定不完整而拒絕要求,例如:

  • 多點傳播用戶虛擬私有雲網路設定不完整。
  • 多點傳播用戶端虛擬私有雲網路設定尚未傳播至網域的多點傳播基礎架構。
  • 多點傳播消費者未設定 IGMP。

這個事件只會記錄在多點傳播群組用戶啟用資源的記錄中。

多點傳播群組用戶啟用作業的記錄格式

本節說明專案中多點傳播用戶設定的群組成員資格事件記錄格式。

這些記錄檔會針對特定虛擬私有雲網路中多點傳播用戶的成員資格事件編寫,該網路已針對多點傳播群組範圍和區域啟用。您可以按照「為多點傳播群組用戶啟用項目啟用記錄功能」一文的說明,在可用區多點傳播群組用戶啟用資源上設定記錄功能。

Cloud Logging 受監控資源類型和記錄名稱如下:

  • 資源類型:networkservices.googleapis.com/MulticastGroupConsumerActivation
  • 記錄檔名稱:networkservices.googleapis.com%2Fmulticast_memberships

記錄包含下列欄位:

欄位 類型 說明
consumerIp 字串 多點播送消費者主要內部 IPv4 位址。 範例:10.0.0.1。
consumerLocation 字串 多點傳播用戶的可用區。 範例:us-east5-a。
consumerNetwork 資源 多點傳播用戶虛擬私有雲網路。範例:
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
        
consumerProject 專案 包含多播消費者虛擬私有雲網路的專案。範例:
        consumerProject {
          id: "my-project"
          number: "5678"
        }
        
consumerResource 資源 多點傳播用戶端 VM 執行個體。範例:
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
        
consumerResourceProject 專案 含有多點傳播消費者 VM 執行個體的專案。 這可能與包含多點傳播消費者虛擬私有雲網路的專案不同,例如使用 Shared VPC 時。範例:
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
        
eventDescription 字串 已記錄的事件中描述的其中一個事件。 範例:IGMP consumer joined。
eventTime 字串 事件的時間戳記,採用 RFC 3339 文字格式。範例:2024-10-21T06:46:42.990162973Z。
multicastConsumerAssociation 字串 多點傳播用戶虛擬私有雲網路與網域之間的多點傳播用戶關聯名稱。範例:my-consumer-association-name。
multicastGroupConsumerActivation 字串 多點傳播群組用戶啟用作業的名稱。 範例:my-group-consumer-activation-name。
multicastIp 字串 多點傳播群組的 IP 位址。範例:224.0.0.1。

與多點傳播群組範圍記錄不同,多點傳播群組用戶啟用記錄會使用專案和網路的字串 ID,因為記錄只會提供給包含多點傳播用戶設定的專案。

欄位格式參考資料

專案

欄位 類型 說明
number 字串 (uint64) 系統自動產生的專案整數 ID。 範例:5678。
id 字串 使用者指派的專案 ID。 範例:my-project。

資源

欄位 類型 說明
id 字串 (uint64) 系統自動產生的資源整數 ID。 範例:1111。
name 字串 資源的使用者指派名稱。 範例:my-instance。

啟用群組成員資格事件記錄功能

下列各節說明如何啟用群組成員資格事件記錄。

啟用多點傳播群組用戶啟用作業的記錄功能

本節說明多點傳播用戶網路管理員如何為虛擬私有雲網路設定群組成員資格事件記錄。

針對已啟用多點傳播流量的虛擬私有雲網路,您可以在相應的多點傳播群組用戶啟用項目中,設定成員資格事件記錄。

如要進一步瞭解如何在建立新的多點傳播群組用戶啟用作業時設定記錄,請參閱「啟用虛擬私有雲網路以取用多點傳播流量」。根據預設,系統不會啟用會員活動記錄功能。

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:多點傳播群組用戶啟用作業的名稱
  • ZONE:多點傳播群組用戶啟用作業的可用區
  • --[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:專案 ID
  • GROUP_CONSUMER_ACTIVATION_NAME:多點傳播群組用戶啟用作業的名稱
  • ZONE:多點傳播群組用戶啟用作業的可用區
  • LOGGING_ENABLED:指定是否啟用會員事件記錄。
    • 如要啟用記錄功能,請設為 true。
    • 如要停用記錄功能,請設為 false。

查看群組成員資格事件記錄

本節說明如何查看多點傳播的群組成員資格事件記錄。

詳情請參閱「Logs Explorer 總覽」。

控制台

  1. 前往 Google Cloud 控制台的「Logs Explorer」頁面:

    前往 Logs Explorer

  2. 如要查看多點播送群組成員資格事件記錄,請從「所有資源」清單中選取下列其中一種受監控的資源類型:
    • 如果您是多點傳播用戶虛擬私有雲網路管理員,且想查看網路的群組成員資格事件記錄,請選取「多點傳播群組用戶啟用作業」。