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

本頁面提供相關資訊，說明如何監控多點傳播群組成員資格事件 (例如 IGMP 聯結) 的記錄，以及如何啟用及查看這些記錄。

您可以透過這些記錄瞭解多點傳播群組中的活動，例如多點傳播用戶端加入和離開的時間，或是群組中的多點傳播用戶端數量。

關於群組成員記錄事件記錄

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

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

資源 記錄說明
多點傳播群組範圍

群組範圍內所有多點傳播用戶的群組成員資格事件記錄。

這些記錄檔僅適用於多點傳播管理員專案。

您可以針對全域多點傳播群組範圍和可用區多點傳播群組範圍啟用作業設定記錄功能。請參閱「啟用多點傳播群組範圍的記錄功能」。
多點傳播群組用戶啟用作業

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

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

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

已記錄的事件

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

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

  • 如果 IGMP 聯播成功，系統會顯示兩則記錄訊息：IGMP join request received訊息，後面接著 IGMP consumer joined。
  • 如果 IGMP 加入作業失敗，系統會產生兩則記錄訊息：IGMP join request received 訊息，後面接著 IGMP join request rejected due to *。
  • 對於已成功加入群組的多點傳播消費者，單一 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 控制層已從群組中移除該用戶端。
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 控制層收到加入要求，但由於多點傳播用戶端虛擬私有雲網路已用盡每個虛擬私有雲網路的多點傳播用戶端 VM 配額，因此拒絕要求。
IGMP join request rejected due to unknown reason

Google Cloud 控制層收到加入要求，但因發生沒有專屬原因的失敗情形，因此拒絕要求。
IGMP entitlement rejected

Google Cloud 控制層收到加入要求，但由於必要的多播消費者設定不完整，因此拒絕要求，例如：

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

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

已為多點傳播群組範圍啟用多點傳播用戶虛擬私有雲網路。這對應於建立 多點傳播群組用戶啟用資源。

只有多點傳播管理員才能在多點傳播群組範圍資源的記錄中查看這項事件。
Consumer network deactivated

多點傳播群組範圍的多點傳播用戶端虛擬私有雲網路已停用。這表示多點傳播群組用戶啟用作業資源已遭刪除，或狀態已變更為 INACTIVE。

只有多點傳播管理員才能在多點傳播群組範圍資源的記錄中查看這項事件。

多點傳播群組範圍的記錄格式

本節說明群組成員資格事件記錄的格式，這類記錄位於包含多點傳播網域和群組範圍資源的多點傳播管理員專案中。

系統會針對特定多點傳播群組範圍的所有多點傳播用戶，記錄成員資格事件。您可以針對全域多點傳播群組範圍和可用區多點傳播群組範圍啟用資源設定記錄，詳情請參閱「啟用多點傳播群組範圍的記錄功能」。

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

  • 資源類型：networkservices.googleapis.com/MulticastGroupRange
  • 記錄名稱：networkservices.googleapis.com%2Fmulticast_memberships

記錄檔格式會因記錄的事件類型而異。詳情請參閱下列各分頁中的表格。

IGMP 事件

如果記錄的事件是 IGMP 事件，記錄會包含下列欄位：

欄位 類型 說明
consumerIp 字串 多點播送接收端的主要內部 IPv4 位址。 範例：10.0.0.1。
consumerLocation 字串 多點傳播用戶 VPC 的可用區。 範例：us-east5-a。
consumerNetwork 資源 多點傳播用戶虛擬私有雲網路。系統只會填入整數 ID。範例：
      consumerNetwork {
       id: "1234"
      }
consumerProject 專案 包含多播消費者虛擬私有雲網路的專案。 系統只會填入專案編號。 範例：
      consumerProject {
       number: "5678"
      }
consumerResource 資源 多點傳播用戶端 VM 執行個體。系統只會填入整數 ID。 範例：
      consumerResource {
       id: "1111"
      }
consumerResourceProject 專案 包含多點傳播消費者 VM 執行個體的專案。 這可能與包含多點傳播消費者虛擬私有雲網路的專案不同，例如使用 Shared VPC 時。系統只會填入專案編號。 範例：
      consumerResourceProject {
       number: "4321"
      }
eventDescription 字串 記錄的事件中描述的其中一個事件。 範例：IGMP consumer joined。
eventTime 字串 事件的時間戳記，採用 RFC 3339 文字格式。範例：2024-10-21T06:46:42.990162973Z。
multicastDomain 字串 多點傳播網域名稱。 範例：my-domain-name。
multicastGroupRange 字串 多點傳播群組範圍的名稱。 範例：my-group-range-name。
multicastIp 字串 多點傳播群組的 IP 位址。範例：224.0.0.1。

啟用/停用

如果記錄的事件是多點傳播用戶端虛擬私有雲網路啟用或停用，記錄檔會包含下列欄位：

欄位 類型 說明
consumerLocation 字串 啟用多點傳播用戶端虛擬私有雲網路的可用區。範例：us-east5-a。
consumerNetwork 資源 多點傳播用戶虛擬私有雲網路。系統只會填入整數 ID。範例：
      consumerNetwork {
       id: "1234"
      }
consumerProject 專案 包含多播消費者虛擬私有雲網路的專案。 系統只會填入專案編號。 範例：
      consumerProject {
       number: "5678"
      }
eventDescription 字串 記錄的事件中描述的其中一個事件。 範例：Consumer network activated。
eventTime 字串 事件的時間戳記，採用 RFC 3339 文字格式。範例：2024-10-21T06:46:42.990162973Z。
multicastDomain 字串 多點傳播網域名稱。 範例：my-domain-name。
multicastGroupRange 字串 多點傳播群組範圍的名稱。 例如：my-group-range-name。

多點傳播消費者資源 (例如專案、網路和執行個體) 會使用整數 ID，以維護隱私權。

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

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

這些記錄會針對已啟用多點傳播群組範圍和可用區的特定虛擬私有雲網路，記錄多點傳播用戶端的成員資格事件。您可以按照「啟用多點傳播群組用戶啟用作業的記錄功能」一文的說明，設定可用區多點傳播群組用戶啟用資源的記錄功能。

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-ranges update 指令。

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

    更改下列內容：

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

  • 如要啟用或停用多點傳播群組範圍啟用作業的記錄功能，請使用 multicastGroupRangeActivations.patch 方法。

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

    更改下列內容：

    • PROJECT_ID：專案 ID
    • GROUP_RANGE_ACTIVATION_NAME：多點傳播群組範圍啟用作業的名稱
    • ZONE：多點傳播群組範圍啟用作業的可用區
    • LOGGING_ENABLED：指定是否啟用會員事件記錄。
      • 如要啟用記錄功能，請設為 true。
      • 如要停用記錄功能，請設為 false。

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

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

針對已啟用多點傳播流量的特定 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：多點傳播群組用戶啟用作業的名稱
  • 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. 如要查看多點播送群組成員資格事件記錄，請從「所有資源」清單中選取下列任一受監控資源類型：
    • 如果您是多點傳播管理員，想查看群組中所有多點傳播用戶的群組成員資格事件記錄，請選取「多點傳播群組範圍」。
    • 如果您是多點傳播用戶虛擬私有雲網路管理員，且想查看網路的群組成員資格事件記錄，請選取「多點傳播群組用戶啟用」。

後續步驟