マルチキャストグループメンバーシップイベントログを表示する

このページでは、IGMP 参加などのマルチキャストグループメンバーシップイベントのモニタリングに使用できるログについて説明します。また、これらのログを有効にして表示する方法についても説明します。

これらのログを使用すると、マルチキャストグループのアクティビティ（マルチキャストコンシューマーが参加した時間、離脱した時間、グループ内のマルチキャストコンシューマーの数など）を把握できます。

グループメンバーシップのイベントログについて

Google Cloud は、マルチキャストのグループメンバーシップイベントログを Cloud Logging に書き込みます。

次の表に、各リソースタイプで使用できるログの概要を示します。これには、ログを受信するプロジェクトも含まれます。ロギングされるイベントとログ形式の詳細については、次のセクションをご覧ください。

リソース	ログの説明
マルチキャストグループ範囲	グループ範囲のすべてのマルチキャストコンシューマーのグループメンバーシップイベントログ。これらのログは、マルチキャスト管理者プロジェクトでのみ使用できます。ロギングは、グローバルマルチキャストグループ範囲とゾーンマルチキャストグループ範囲の有効化の両方で構成できます。マルチキャストグループ範囲のロギングを有効にするをご覧ください。
マルチキャストグループコンシューマーの有効化	グループ範囲とゾーンで有効になっている特定のマルチキャストコンシューマー VPC ネットワーク内のマルチキャストコンシューマーのグループメンバーシップイベントログ。これらのログは、マルチキャストコンシューマーリソースを含むプロジェクトで使用できます。マルチキャストドメインのトポロジに応じて、マルチキャスト管理者プロジェクトまたは個別のマルチキャストコンシューマープロジェクトのいずれかになります。マルチキャストグループコンシューマーの有効化のロギングを有効にするをご覧ください。

リソース

ログの説明

マルチキャストグループ範囲

グループ範囲のすべてのマルチキャストコンシューマーのグループメンバーシップイベントログ。

これらのログは、マルチキャスト管理者プロジェクトでのみ使用できます。

ロギングは、グローバルマルチキャストグループ範囲とゾーンマルチキャストグループ範囲の有効化の両方で構成できます。マルチキャストグループ範囲のロギングを有効にするをご覧ください。

マルチキャストグループコンシューマーの有効化

グループ範囲とゾーンで有効になっている特定のマルチキャストコンシューマー VPC ネットワーク内のマルチキャストコンシューマーのグループメンバーシップイベントログ。

これらのログは、マルチキャストコンシューマーリソースを含むプロジェクトで使用できます。マルチキャストドメインのトポロジに応じて、マルチキャスト管理者プロジェクトまたは個別のマルチキャストコンシューマープロジェクトのいずれかになります。

マルチキャストグループコンシューマーの有効化のロギングを有効にするをご覧ください。

記録されるイベント

このセクションでは、Cloud Logging でマルチキャスト用にロギングされるグループメンバーシップイベントについて説明します。

マルチキャストコンシューマーがグループに参加するために IGMP メンバーシップレポートを送信すると、次のようなログメッセージが生成されます。

IGMP 参加が成功すると、2 つのログメッセージが生成されます（「IGMP join request received」の後に「IGMP consumer joined」が生成されます）。
IGMP 参加が失敗すると、2 つのログメッセージが生成されます（「IGMP join request received」の後に「IGMP join request rejected due to *」が生成されます）。
グループにすでに正常に参加しているマルチキャストコンシューマーの場合、キープアライブ IGMP 参加リクエストは 1 つの IGMP join request received メッセージになります。

ログに記録されるイベントとその説明の完全なリストについては、次の表をご覧ください。

イベント	説明
`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 コントロールプレーンは参加リクエストを受信しましたが、マルチキャストコンシューマー VPC ネットワークが VPC ネットワークあたりのマルチキャストコンシューマー VM の割り当てをすべて使用しているため、リクエストを拒否しました。
`IGMP join request rejected due to unknown reason`	Google Cloud コントロールプレーンは参加リクエストを受信しましたが、特定の理由がない障害のため、リクエストを拒否しました。
`IGMP entitlement rejected`	Google Cloud コントロールプレーンは参加リクエストを受信しましたが、必要なマルチキャストコンシューマー構成が完了していないため、リクエストを拒否しました。次のような状況が考えられます。マルチキャストコンシューマー VPC ネットワークの構成が完了していない。マルチキャストコンシューマー VPC ネットワーク構成が、ドメインのマルチキャストインフラストラクチャに伝播されていない。マルチキャストコンシューマーが IGMP 用に構成されていない。このイベントは、マルチキャストグループコンシューマーの有効化リソースのログでのみ利用できます。
`Consumer network activated`	マルチキャストグループ範囲に対してマルチキャストコンシューマー VPC ネットワークが有効になりました。これは、マルチキャストグループコンシューマーの有効化リソースの作成に対応します。このイベントは、マルチキャストグループ範囲リソースのログでマルチキャスト管理者のみが利用できます。
`Consumer network deactivated`	マルチキャストグループ範囲のマルチキャストコンシューマー VPC ネットワークが無効になりました。これは、マルチキャストグループコンシューマーの有効化リソースが削除されたか、ステータスが `OBSOLETE` に変更されたことを意味します。このイベントは、マルチキャストグループ範囲リソースのログでマルチキャスト管理者のみが利用できます。

マルチキャストグループ範囲のログ形式

このセクションでは、マルチキャストドメインとグループ範囲リソースを含むマルチキャスト管理者プロジェクトで使用可能なグループメンバーシップイベントログの形式について説明します。

これらのログは、特定のマルチキャストグループ範囲のすべてのマルチキャストコンシューマーのメンバーシップイベントに対して書き込まれます。マルチキャストグループ範囲のロギングを有効にするで説明されているように、グローバルマルチキャストグループ範囲とゾーンマルチキャストグループ範囲の両方の有効化リソースでロギングを構成できます。

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`	リソース	マルチキャストコンシューマー VPC ネットワーク。整数 ID のみが入力されます。例: consumerNetwork { id: "1234" }
`consumerProject`	プロジェクト	マルチキャストコンシューマー VPC ネットワークを含むプロジェクト。プロジェクト番号のみが入力されます。例: consumerProject { number: "5678" }
`consumerResource`	リソース	マルチキャストコンシューマー VM インスタンス。整数 ID のみが入力されます。例: consumerResource { id: "1111" }
`consumerResourceProject`	プロジェクト	マルチキャストコンシューマー VM インスタンスを含むプロジェクト。これは、共有 VPC を使用する場合など、マルチキャストコンシューマーの 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`

有効化 / 無効化

ログに記録されたイベントがマルチキャストコンシューマー VPC ネットワークの有効化または無効化の場合、ログには次のフィールドが含まれます。

フィールド	タイプ	説明
`consumerLocation`	文字列	マルチキャストコンシューマーネットワークが有効になったゾーン例: `us-east5-a`
`consumerNetwork`	リソース	マルチキャストコンシューマー VPC ネットワーク。整数 ID のみが入力されます。例: consumerNetwork { id: "1234" }
`consumerProject`	プロジェクト	マルチキャストコンシューマー VPC ネットワークを含むプロジェクト。プロジェクト番号のみが入力されます。例: 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 は、プロジェクト、ネットワーク、インスタンスなどのマルチキャストコンシューマーのリソースに使用され、プライバシーが保護されます。

マルチキャストグループコンシューマーの有効化のログ形式

このセクションでは、マルチキャストコンシューマーリソースを含むプロジェクトで使用できるグループメンバーシップイベントログの形式について説明します。プロジェクトは、マルチキャストドメインのトポロジに応じて、マルチキャスト管理者プロジェクトまたは個別のマルチキャストコンシューマープロジェクトのいずれかになります。

これらのログは、マルチキャストグループ範囲とゾーンで有効になっている特定の VPC ネットワーク内のマルチキャストコンシューマーのメンバーシップイベントに対して書き込まれます。マルチキャストグループコンシューマーの有効化のロギングを有効にするで説明されているように、ゾーンマルチキャストグループコンシューマーの有効化リソースでロギングを構成できます。

Cloud Logging のモニタリング対象リソースタイプとログ名は次のとおりです。

リソースタイプ: networkservices.googleapis.com/MulticastGroupConsumerActivation
ログ名: networkservices.googleapis.com%2Fmulticast_memberships

ログには次のフィールドが含まれます。

フィールド	タイプ	説明
`consumerIp`	文字列	マルチキャストコンシューマーのプライマリ内部 IPv4 アドレス。例: `10.0.0.1`
`consumerLocation`	文字列	マルチキャストコンシューマーのゾーン。例: `us-east5-a`
`consumerNetwork`	リソース	マルチキャストコンシューマー VPC ネットワーク。例: consumerNetwork { name: "my-network" id: "1234" }
`consumerProject`	プロジェクト	マルチキャストコンシューマー VPC ネットワークを含むプロジェクト。例: consumerProject { id: "my-project" number: "5678" }
`consumerResource`	リソース	マルチキャストコンシューマー VM インスタンス。例: consumerResource { name: "my-instance" id: "1111" }
`consumerResourceProject`	プロジェクト	マルチキャストコンシューマー VM インスタンスを含むプロジェクト。これは、共有 VPC を使用する場合など、マルチキャストコンシューマーの VPC ネットワークを含むプロジェクトとは異なる場合があります。例: consumerResourceProject { id: "my-instance-project" number: "4321" }
`eventDescription`	文字列	ログに記録されたイベントに記載されているイベントのいずれか。例: `IGMP consumer joined`
`eventTime`	文字列	イベントのタイムスタンプ（RFC 3339 のテキスト形式）。例: `2024-10-21T06:46:42.990162973Z`
`multicastConsumerAssociation`	文字列	マルチキャストコンシューマー VPC ネットワークとドメイン間のマルチキャストコンシューマーの関連付けの名前。例: `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`

グループメンバーシップのイベントロギングを有効にする

以降のセクションでは、マルチキャストグループ範囲または特定のマルチキャストコンシューマー VPC ネットワークに対してグループメンバーシップイベントロギングを有効にする方法について説明します。

マルチキャストグループ範囲のロギングを有効にする

このセクションでは、マルチキャスト管理者が既存のマルチキャストグループ範囲のグループメンバーシップイベントロギングを構成する方法について説明します。

新しいマルチキャストグループ範囲の作成時にロギングを構成する方法については、マルチキャストグループ範囲を作成するをご覧ください。メンバーシップイベントロギングはデフォルトでは有効になっていません。

メンバーシップイベントのロギングは、次の両方のリソースで構成できます。

マルチキャストグループ範囲: グローバルグループ範囲のロギング構成は、グループ範囲のすべての有効化に適用されます。
マルチキャストグループ範囲の有効化: ゾーングループ範囲の有効化のロギング構成は、グローバルグループ範囲の構成をオーバーライドします。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

権限

networkservices.multicastGroupRanges.update
networkservices.multicastGroupRangeActivations.update

ロール

マルチキャスト管理者（roles/compute.multicastAdmin）

gcloud

マルチキャストグループ範囲のロギングを有効または無効にするには、network-services multicast-group-ranges update コマンドを使用します。
```
gcloud beta 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 beta 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/v1beta1/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/v1beta1/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 ネットワークのグループメンバーシップイベントロギングを構成する方法について説明します。

マルチキャストトラフィックを使用できるようにした特定の VPC ネットワークについて、対応するマルチキャストグループコンシューマーの有効化でメンバーシップイベントのロギングを構成できます。

新しいマルチキャストグループコンシューマーの有効化を作成するときにロギングを構成する方法については、VPC ネットワークでマルチキャストトラフィックを使用できるようにするをご覧ください。メンバーシップイベントロギングはデフォルトでは有効になっていません。

このタスクに必要な権限

このタスクを実行するには、次の権限または次の IAM ロールのいずれかが付与されている必要があります。

権限

networkservices.multicastGroupConsumerActivations.update

ロール

マルチキャスト管理者（roles/compute.multicastAdmin）

gcloud

マルチキャストグループコンシューマーの有効化のロギングを有効または無効にするには、network-services multicast-group-consumer-activations update コマンドを使用します。

  gcloud beta 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/v1beta1/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 に設定します。

グループメンバーシップのイベントログを表示する

このセクションでは、マルチキャストのグループメンバーシップイベントログを表示する方法について説明します。

詳細については、ログエクスプローラの概要をご覧ください。

コンソール

Google Cloud コンソールで、[ログエクスプローラ] ページに移動します。

[ログエクスプローラ] に移動
マルチキャストグループメンバーシップイベントログを表示するには、[すべてのリソース] リストから次のいずれかのモニタリング対象リソースタイプを選択します。
- マルチキャスト管理者がグループ内のすべてのマルチキャストコンシューマーのグループメンバーシップイベントログを表示する場合は、[Multicast Group Range] を選択します。
- マルチキャストコンシューマー VPC ネットワークの管理者で、ネットワークのグループメンバーシップイベントログを表示する場合は、[Multicast Group Consumer Activation] を選択します。

マルチキャスト グループ メンバーシップ イベントログを表示する

グループ メンバーシップのイベントログについて

記録されるイベント

マルチキャスト グループ範囲のログ形式

IGMP イベント

有効化 / 無効化

マルチキャスト グループ コンシューマーの有効化のログ形式

フィールド形式のリファレンス

プロジェクト

リソース

グループ メンバーシップのイベント ロギングを有効にする

マルチキャスト グループ範囲のロギングを有効にする

このタスクに必要な権限

gcloud

API

マルチキャスト グループ コンシューマーの有効化のロギングを有効にする

このタスクに必要な権限

gcloud

API

グループ メンバーシップのイベントログを表示する

コンソール

次のステップ

マルチキャストグループメンバーシップイベントログを表示する

グループメンバーシップのイベントログについて

マルチキャストグループ範囲のログ形式

マルチキャストグループコンシューマーの有効化のログ形式

グループメンバーシップのイベントロギングを有効にする

マルチキャストグループ範囲のロギングを有効にする

マルチキャストグループコンシューマーの有効化のロギングを有効にする

グループメンバーシップのイベントログを表示する