查看多點傳播群組成員資格事件記錄
本頁面提供可用於監控多點傳播群組成員資格事件 (例如 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訊息中傳送 Keepalive IGMP 加入要求。
如需記錄事件及其說明的完整清單,請參閱下表。
| 事件 | 說明 |
|---|---|
IGMP join request received |
Google Cloud 控制層收到加入要求。這則訊息不代表加入作業已順利完成。 系統會記錄每項加入要求,包括多點傳播用戶端定期傳送的 Keepalive 要求 (屬於 IGMP 通訊協定的一部分)。 |
IGMP consumer joined |
Google Cloud 控制層已成功將多點傳播用戶新增至群組。這項事件傳播至網域的多點傳播基礎架構後,多點傳播用戶就會開始接收多點傳播流量。 這個事件一律會先於 |
IGMP consumer left |
Google Cloud 控制層收到多點傳播用戶端傳送的明確 IGMP 離開要求,並已套用該要求。 |
IGMP consumer timed out |
Google Cloud 控制層已將多點傳播用戶從群組中移除,因為多點傳播用戶停止回應 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 控制層收到加入要求,但多點傳播用戶虛擬私有雲網路已用盡「每個虛擬私有雲網路的多點傳播用戶 VM」配額,因此拒絕要求。 |
IGMP join request rejected due to unknown reason |
Google Cloud 控制層收到加入要求,但因發生未指定原因的失敗而拒絕要求。 |
IGMP entitlement rejected |
Google Cloud 控制層收到加入要求,但因必要的多點傳播消耗者設定不完整而拒絕要求,例如:
這項事件只會顯示在多點傳播群組用戶啟用資源的記錄中。 |
Consumer network activated |
已為多點傳播群組範圍啟用多點傳播用戶虛擬私有雲網路。這相當於建立多點傳播群組用戶啟用資源。 只有多點傳播管理員,才能在多點傳播群組範圍資源的記錄中查看這項事件。 |
Consumer network deactivated |
多點傳播群組範圍的多點傳播用戶虛擬私有雲網路已停用。這表示多點傳播群組用戶啟用作業資源已刪除,或狀態變更為 只有多點傳播管理員,才能在多點傳播群組範圍資源的記錄中查看這項事件。 |
多點傳播群組範圍的記錄格式
本節說明群組成員事件記錄的格式,這些記錄位於含有多點傳播網域和群組範圍資源的多點傳播管理員專案中。
系統會為特定多點傳播群組範圍內,所有多點傳播用戶的成員資格事件寫入這些記錄。您可以按照「啟用多點傳播群組範圍的記錄功能」一節的說明,設定全域多點傳播群組範圍和可用區多點傳播群組範圍啟用資源的記錄功能。
Cloud Logging 受監控資源類型和記錄名稱如下:
- 資源類型:
networkservices.googleapis.com/MulticastGroupRange - 記錄檔名稱:
networkservices.googleapis.com%2Fmulticast_memberships
記錄格式會因記錄事件類型而異。詳情請參閱下列各分頁中的表格。
IGMP 事件
如果記錄的事件是 IGMP 事件,記錄會包含下列欄位:
| 欄位 | 類型 | 說明 |
|---|---|---|
consumerIp |
字串 | 多點傳播消費者的主要內部 IPv4 位址。範例:10.0.0.1。 |
consumerLocation |
字串 | 多點傳播用戶虛擬私有雲的可用區。範例: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:專案 IDGROUP_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:專案 IDGROUP_RANGE_ACTIVATION_NAME: 多點傳播群組範圍啟用的名稱ZONE:多點傳播群組範圍啟用作業的可用區LOGGING_ENABLED:指定是否在這個區域啟用成員資格事件記錄,覆寫全域群組範圍設定。- 如要啟用這個區域的記錄功能,請設為
true。 - 如要停用這個區域的記錄功能,請設為
false。
- 如要啟用這個區域的記錄功能,請設為
啟用多點傳播群組用戶啟用作業的記錄功能
本節說明多點傳播用戶網路管理員如何為虛擬私有雲網路設定群組成員事件記錄。
針對已啟用多點傳播流量的特定虛擬私有雲網路,您可以在對應的多點傳播群組用戶啟用項目上,設定成員資格事件記錄。
如要進一步瞭解如何在建立新的多點傳播群組用戶啟用作業時設定記錄功能,請參閱「啟用虛擬私有雲網路以取用多點傳播流量」。成員資格事件記錄功能預設為停用。
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:專案 IDGROUP_CONSUMER_ACTIVATION_NAME:多點傳播群組用戶啟用作業的名稱ZONE:多點傳播群組用戶啟用作業的可用區LOGGING_ENABLED:指定是否啟用成員資格事件記錄。- 如要啟用記錄功能,請設為
true。 - 如要停用記錄功能,請設為
false。
- 如要啟用記錄功能,請設為
查看群組成員資格事件記錄
本節說明如何查看多點傳播的群組成員事件記錄。
詳情請參閱「Logs Explorer 總覽」。
控制台
- 前往 Google Cloud 控制台的「Logs Explorer」頁面:
- 如要查看多點傳播群組成員資格事件記錄,請從「All resources」(所有資源) 清單中選取下列其中一種受監控資源類型:
- 如果您是多點傳播管理員,且想查看群組中所有多點傳播用戶的群組成員資格事件記錄,請選取「Multicast Group Range」(多點傳播群組範圍)。
- 如果您是多點傳播用戶虛擬私有雲網路管理員,且想查看網路的群組成員事件記錄,請選取「多點傳播群組用戶啟用」。