Protokollereignisse für die Mitgliedschaft in Multicast-Gruppen ansehen

Auf dieser Seite finden Sie Informationen zu den Logs, die zur Überwachung von Ereignissen zur Mitgliedschaft in Multicastgruppen, z. B. IGMP-Joins, verfügbar sind. Außerdem wird beschrieben, wie Sie sie aktivieren und ansehen können.

Anhand dieser Logs können Sie die Aktivität in einer Multicast-Gruppe nachvollziehen, z. B. wann ein Multicast-Nutzer einer Gruppe beigetreten ist und wann er sie verlassen hat oder wie viele Multicast-Nutzer sich in einer Gruppe befinden.

Protokolle für Ereignisse zur Gruppenmitgliedschaft

Google Cloud schreibt Ereignis-Logs zur Gruppenmitgliedschaft für Multicast in Cloud Logging.

Diese Tabelle enthält eine Zusammenfassung der Logs, die für die einzelnen Ressourcentypen verfügbar sind, einschließlich des Projekts, in dem die Logs empfangen werden. Weitere Informationen zu den protokollierten Ereignissen und zum Logformat finden Sie in den folgenden Abschnitten.

Ressource Beschreibung der Logs
Multicast-Gruppenbereich

Ereignisprotokolle zur Gruppenmitgliedschaft für alle Multicast-Nutzer eines Gruppenbereichs.

Diese Logs sind nur in Projekten mit Multicast-Administratoren verfügbar.

Sie können das Logging sowohl für einen globalen Multicast-Gruppenbereich als auch für eine zonale Aktivierung eines Multicast-Gruppenbereichs konfigurieren. Weitere Informationen finden Sie unter Logging für einen Multicast-Gruppenbereich aktivieren.
Aktivierung des Multicast-Gruppennutzers

Ereignisprotokolle zur Gruppenmitgliedschaft für Multicast-Nutzer in einem bestimmten VPC-Netzwerk für Multicast-Nutzer, das für einen Gruppenbereich und eine Zone aktiviert ist.

Diese Logs sind in Projekten verfügbar, die Multicast-Nutzerressourcen enthalten. Das kann je nach Topologie der Multicast-Domain entweder das Multicast-Administratorprojekt oder ein separates Multicast-Nutzerprojekt sein.

Weitere Informationen finden Sie unter Logging für die Aktivierung eines Multicast-Gruppennutzers aktivieren.

Protokollierte Ereignisse

In diesem Abschnitt werden die Gruppenmitgliedschaftsereignisse beschrieben, die für Multicast in Cloud Logging protokolliert werden.

Wenn ein Multicast-Empfänger einen IGMP-Mitgliedschaftsbericht sendet, um einer Gruppe beizutreten, sind die resultierenden Log-Nachrichten wie folgt:

  • Ein erfolgreicher IGMP-Join führt zu zwei Logmeldungen: einer IGMP join request received-Meldung gefolgt von IGMP consumer joined.
  • Ein fehlgeschlagener IGMP-Join führt zu zwei Log-Nachrichten: einer IGMP join request received-Nachricht, gefolgt von IGMP join request rejected due to *.
  • Bei einem Multicast-Nutzer, der einer Gruppe bereits erfolgreich beigetreten ist, führt eine Keep-Alive-IGMP-Beitrittsanfrage zu einer einzelnen IGMP join request received-Nachricht.

Eine vollständige Liste der protokollierten Ereignisse und ihrer Beschreibungen finden Sie in der folgenden Tabelle.

Ereignis Beschreibung
IGMP join request received

Die Google Cloud Steuerungsebene hat die Beitrittsanfrage erhalten. Diese Nachricht bestätigt nicht, dass die Mitgliedschaft erfolgreich abgeschlossen wurde.

Jede Join-Anfrage wird protokolliert, einschließlich Keepalive-Anfragen, die Multicast-Consumer im Rahmen des IGMP-Protokolls regelmäßig senden.
IGMP consumer joined

Die Google Cloud Steuerungsebene hat der Gruppe den Multicast-Nutzer hinzugefügt. Nachdem dieses Ereignis an die Multicast-Infrastruktur für die Domain weitergeleitet wurde, beginnt der Multicast-Empfänger mit dem Empfang von Multicast-Traffic.

Diesem Ereignis geht immer ein IGMP join request received-Ereignis voraus.
IGMP consumer left

Die Google Cloud -Steuerungsebene hat eine explizite IGMP-Austrittsanfrage vom Multicast-Consumer erhalten und die Anfrage angewendet.
IGMP consumer timed out

Die Google Cloud -Steuerungsebene hat den Multicast-Nutzer aus der Gruppe entfernt, weil der Multicast-Nutzer nicht mehr mit Keep-Alive-Anfragen reagiert hat.
Consumer removed due to configuration change

Die Google Cloud Steuerungsebene hat den Multicast-Consumer aus der Gruppe entfernt, weil der Consumer-Endpunkt gelöscht wurde. Beispielsweise wurde die Nutzerinstanz oder das Nutzerprojekt möglicherweise gelöscht.
IGMP join request rejected due to full tree

Die Google Cloud -Steuerungsebene hat die Beitrittsanfrage erhalten, aber abgelehnt, weil die Multicastgruppe bereits voll ausgelastet ist.
IGMP join request rejected due to missing quota

Die Google Cloud Steuerungsebene hat die Beitrittsanfrage erhalten, sie aber abgelehnt, weil das Multicast-Nutzer-VPC-Netzwerk bereits das gesamte Kontingent für Multicast-Nutzer-VMs pro VPC-Netzwerk nutzt.
IGMP join request rejected due to unknown reason

Die Google Cloud -Steuerungsebene hat die Beitrittsanfrage erhalten, aber aufgrund eines Fehlers ohne dedizierten Grund abgelehnt.
IGMP entitlement rejected

Die Steuerungsebene Google Cloud hat die Beitrittsanfrage erhalten, aber abgelehnt, weil die erforderliche Konfiguration des Multicast-Consumers nicht vollständig ist, z. B. in den folgenden Fällen:

  • Die VPC-Netzwerkkonfiguration des Multicast-Nutzer ist nicht vollständig.
  • Die VPC-Netzwerkkonfiguration des Multicast-Consumers wurde nicht an die Multicast-Infrastruktur für die Domain weitergegeben.
  • Der Multicast-Empfänger ist nicht für IGMP konfiguriert.

Dieses Ereignis ist nur in den Logs für die Ressource zur Nutzeraktivierung für die Multicast-Gruppe verfügbar.
Consumer network activated

Ein VPC-Netzwerk für Multicast-Nutzer wurde für einen Multicast-Gruppenbereich aktiviert. Dies entspricht der Erstellung einer Nutzeraktivierung für die Multicast-Gruppe-Ressource.

Dieses Ereignis ist nur für Multicast-Administratoren in den Logs für Multicast-Gruppenbereichsressourcen verfügbar.
Consumer network deactivated

Ein VPC-Netzwerk für Multicast-Nutzer wurde für einen Multicast-Gruppenbereich deaktiviert. Das bedeutet, dass eine Nutzeraktivierung für die Multicast-Gruppe-Ressource gelöscht wurde oder ihr Status in INACTIVE geändert wurde.

Dieses Ereignis ist nur für Multicast-Administratoren in den Logs für Multicast-Gruppenbereichsressourcen verfügbar.

Logformat für Multicast-Gruppenbereiche

In diesem Abschnitt wird das Format der Ereignisprotokolle für Gruppenmitgliedschaften beschrieben, die im Multicast-Administratorprojekt mit Ressourcen für Multicast-Domänen und ‑Gruppenbereiche verfügbar sind.

Diese Logs werden für Mitgliedschaftsereignisse für alle Multicast-Nutzer eines bestimmten Multicast-Gruppenbereichs geschrieben. Sie können das Logging sowohl für die globalen als auch für die zonalen Aktivierungsressourcen für Multicast-Gruppenbereiche konfigurieren, wie unter Logging für einen Multicast-Gruppenbereich aktivieren beschrieben.

Der überwachte Cloud Logging-Ressourcentyp und der Logname sind wie folgt:

  • Ressourcentyp: networkservices.googleapis.com/MulticastGroupRange
  • Log name: networkservices.googleapis.com%2Fmulticast_memberships

Das Log-Format hängt vom Typ des protokollierten Ereignisses ab. Weitere Informationen finden Sie in den Tabellen auf den einzelnen Tabs.

IGMP-Ereignis

Wenn das protokollierte Ereignis ein IGMP-Ereignis ist, enthält das Log die folgenden Felder:

Feld Typ Beschreibung
consumerIp String Die primäre interne IPv4-Adresse des Multicast-Consumers. Beispiel: 10.0.0.1.
consumerLocation String Die Zone des VPC-Netzwerks des Multicast-Nutzers. Beispiel: us-east5-a.
consumerNetwork Ressource Das VPC-Netzwerk des Multicast-Nutzers. Nur die Ganzzahl-ID wird ausgefüllt. Beispiel: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projekt Das Projekt, das das VPC-Netzwerk des Multicast-Empfängers enthält. Nur die Projektnummer wird ausgefüllt. Beispiel: 
      consumerProject {
       number: "5678"
      }
consumerResource Ressource Die VM-Instanz des Multicast-Nutzers. Nur die Ganzzahl-ID wird ausgefüllt. Beispiel: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Projekt Das Projekt, das die VM-Instanz des Multicast-Nutzer enthält. Dies kann sich vom Projekt mit dem VPC-Netzwerk des Multicast-Empfängers unterscheiden, z. B. bei Verwendung einer freigegebene VPC. Nur die Projektnummer wird ausgefüllt. Beispiel: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription String Eines der Ereignisse, die unter Protokollierte Ereignisse beschrieben werden. Beispiel: IGMP consumer joined.
eventTime String Der Zeitstempel des Ereignisses im RFC 3339-Textformat. Beispiel: 2024-10-21T06:46:42.990162973Z.
multicastDomain String Der Name der Multicast-Domain. Beispiel: my-domain-name.
multicastGroupRange String Der Name des Multicast-Gruppenbereichs. Beispiel: my-group-range-name.
multicastIp String Die IP-Adresse der Multicast-Gruppe. Beispiel: 224.0.0.1.

Aktivierung/Deaktivierung

Wenn das protokollierte Ereignis eine Aktivierung oder Deaktivierung des VPC-Netzwerk für Multicast-Nutzer ist, enthält das Log die folgenden Felder:

Feld Typ Beschreibung
consumerLocation String Die Zone, in der das VPC-Netzwerk des Multicast-Nutzers aktiviert wurde. Beispiel: us-east5-a.
consumerNetwork Ressource Das VPC-Netzwerk des Multicast-Nutzers. Nur die Ganzzahl-ID wird ausgefüllt. Beispiel: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projekt Das Projekt, das das VPC-Netzwerk des Multicast-Empfängers enthält. Nur die Projektnummer wird ausgefüllt. Beispiel: 
      consumerProject {
       number: "5678"
      }
eventDescription String Eines der Ereignisse, die unter Protokollierte Ereignisse beschrieben werden. Beispiel: Consumer network activated.
eventTime String Der Zeitstempel des Ereignisses im RFC 3339-Textformat. Beispiel: 2024-10-21T06:46:42.990162973Z.
multicastDomain String Der Name der Multicast-Domain. Beispiel: my-domain-name.
multicastGroupRange String Der Name des Multicast-Gruppenbereichs. Beispiel: my-group-range-name

Für Ressourcen von Multicast-Consumern wie Projekte, Netzwerke und Instanzen werden zur Wahrung des Datenschutzes Ganzzahl-IDs verwendet.

Logformat für Nutzeraktivierungen für Multicast-Gruppen

In diesem Abschnitt wird das Format von Ereignisprotokollen für Gruppenmitgliedschaften beschrieben, die in Projekten mit Multicast-Nutzerressourcen verfügbar sind. Das Projekt kann je nach Topologie der Multicast-Domain entweder das Multicast-Administratorprojekt oder ein separates Multicast-Consumer-Projekt sein.

Diese Logs werden für Mitgliedschaftsereignisse für Multicast-Nutzer in einem bestimmten VPC-Netzwerk geschrieben, das für einen Multicast-Gruppenbereich und eine Zone aktiviert ist. Sie können das Logging für die zonale Ressource für die Nutzeraktivierung für die Multicast-Gruppe konfigurieren, wie unter Logging für eine Nutzeraktivierung für eine Multicast-Gruppe aktivieren beschrieben.

Der überwachte Cloud Logging-Ressourcentyp und der Logname lauten so:

  • Ressourcentyp: networkservices.googleapis.com/MulticastGroupConsumerActivation
  • Log name: networkservices.googleapis.com%2Fmulticast_memberships

Das Log enthält die folgenden Felder:

Feld Typ Beschreibung
consumerIp String Die primäre interne IPv4-Adresse des Multicast-Consumers. Beispiel: 10.0.0.1.
consumerLocation String Die Zone des Multicast-Nutzers. Beispiel: us-east5-a.
consumerNetwork Ressource Das VPC-Netzwerk des Multicast-Nutzers. Beispiel: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Projekt Das Projekt, das das VPC-Netzwerk des Multicast-Empfängers enthält. Beispiel: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Ressource Die VM-Instanz des Multicast-Nutzers. Beispiel: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Projekt Das Projekt, das die VM-Instanz des Multicast-Nutzer enthält. Dies kann sich vom Projekt unterscheiden, das das VPC-Netzwerk des Multicast-Empfängers enthält, z. B. bei Verwendung einer freigegebene VPC. Beispiel: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription String Eines der Ereignisse, die unter Protokollierte Ereignisse beschrieben werden. Beispiel: IGMP consumer joined.
eventTime String Der Zeitstempel des Ereignisses im RFC 3339-Textformat. Beispiel: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation String Der Name der Multicast-Nutzerzuordnung zwischen dem VPC-Netzwerk des Multicast-Nutzers und der Domain. Beispiel: my-consumer-association-name.
multicastGroupConsumerActivation String Der Name der Nutzeraktivierung für die Multicast-Gruppe. Beispiel: my-group-consumer-activation-name.
multicastIp String Die IP-Adresse der Multicast-Gruppe. Beispiel: 224.0.0.1.

Anders als bei den Logs für den Multicast-Gruppenbereich werden in den Logs für die Nutzeraktivierung von Multicast-Gruppen String-IDs für das Projekt und das Netzwerk verwendet, da die Logs nur für das Projekt verfügbar sind, das die Multicast-Nutzerressourcen enthält.

Referenz zum Feldformat

Projekt

Feld Typ Beschreibung
number String (uint64) Die automatisch generierte Ganzzahl-ID des Projekts. Beispiel: 5678.
id String Die vom Nutzer zugewiesene ID des Projekts. Beispiel: my-project.

Ressource

Feld Typ Beschreibung
id String (uint64) Die automatisch generierte Ganzzahl-ID der Ressource. Beispiel: 1111.
name String Der vom Nutzer zugewiesene Name der Ressource. Beispiel: my-instance.

Ereignisprotokollierung für Gruppenmitgliedschaft aktivieren

In den folgenden Abschnitten wird beschrieben, wie Sie die Ereignisprotokollierung für Gruppenmitgliedschaften für einen Multicast-Gruppenbereich oder ein bestimmtes VPC-Netzwerk für Multicast-Consumer aktivieren.

Logging für einen Multicast-Gruppenbereich aktivieren

In diesem Abschnitt wird beschrieben, wie ein Multicast-Administrator die Protokollierung von Gruppenmitgliedschaftsereignissen für einen vorhandenen Multicast-Gruppenbereich konfigurieren kann.

Weitere Informationen zum Konfigurieren des Loggings beim Erstellen eines neuen Multicast-Gruppenbereichs finden Sie unter Multicast-Gruppenbereiche erstellen. Das Logging von Mitgliedschaftsereignissen ist nicht standardmäßig aktiviert.

Sie können das Logging von Mitgliedschaftsereignissen für die folgenden Ressourcen konfigurieren:

  • Multicast-Gruppenbereich:Die Protokollierungskonfiguration eines globalen Gruppenbereichs gilt für alle Aktivierungen des Gruppenbereichs.
  • Aktivierung des Multicast-Gruppenbereichs:Die Protokollierungskonfiguration einer zonalen Gruppenbereichsaktivierung überschreibt die globale Gruppenbereichskonfiguration.

gcloud

  • Verwenden Sie den Befehl network-services multicast-group-ranges update, um das Logging für einen Multicast-Gruppenbereich zu aktivieren oder zu deaktivieren.

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

    Ersetzen Sie Folgendes:

    • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
    • --[no-]enable-logging: Gibt an, ob das Logging von Mitgliedschaftsereignissen aktiviert ist.
      • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
      • Verwenden Sie --no-enable-logging, um das Logging zu deaktivieren.

  • Verwenden Sie den Befehl network-services multicast-group-range-activations update, um das Logging für die Aktivierung eines Multicast-Gruppenbereichs zu aktivieren oder zu deaktivieren.

    gcloud network-services multicast-group-range-activations update GROUP_RANGE_ACTIVATION_NAME \
    --location=ZONE \
    [--enable-logging | --no-enable-logging]

    Ersetzen Sie Folgendes:

    • GROUP_RANGE_ACTIVATION_NAME: Der Name der Aktivierung des Multicastgruppenbereichs.
    • ZONE: Zone der Aktivierung des Multicast-Gruppenbereichs
    • --[no-]enable-logging: Gibt an, ob das Logging von Mitgliedschaftsereignissen aktiviert ist.
      • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
      • Verwenden Sie --no-enable-logging, um das Logging zu deaktivieren.

API

  • Verwenden Sie die Methode multicastGroupRanges.patch, um das Logging für einen Multicastgruppenbereich zu aktivieren oder zu deaktivieren.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID des Projekts
    • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
    • LOGGING_ENABLED: Gibt an, ob das Logging von Mitgliedschaftsereignissen aktiviert ist.
      • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
      • Setzen Sie den Wert auf false, um das Logging zu deaktivieren.

  • Verwenden Sie die Methode multicastGroupRangeActivations.patch, um das Logging für die Aktivierung eines Multicast-Gruppenbereichs zu aktivieren oder zu deaktivieren.

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Die ID des Projekts
    • GROUP_RANGE_ACTIVATION_NAME: Der Name der Aktivierung des Multicastgruppenbereichs.
    • ZONE: Zone der Aktivierung des Multicast-Gruppenbereichs
    • LOGGING_ENABLED: Gibt an, ob das Logging von Mitgliedschaftsereignissen aktiviert ist.
      • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
      • Setzen Sie den Wert auf false, um das Logging zu deaktivieren.

Logging für die Aktivierung eines Multicast-Gruppennutzers aktivieren

In diesem Abschnitt wird beschrieben, wie ein Administrator eines Multicast-Nutzernetzwerks das Logging von Gruppenmitgliedschaftsereignissen für sein VPC-Netzwerk konfigurieren kann.

Für ein bestimmtes VPC-Netzwerk, das Sie für den Empfang von Multicast-Traffic aktiviert haben, können Sie die Protokollierung von Mitgliedschaftsereignissen für die entsprechende Nutzeraktivierung der Multicast-Gruppe konfigurieren.

Weitere Informationen zum Konfigurieren des Loggings beim Erstellen einer neuen Multicast-Gruppe für die Consumer-Aktivierung finden Sie unter VPC-Netzwerk für den Empfang von Multicast-Traffic aktivieren. Das Logging von Mitgliedschaftsereignissen ist nicht standardmäßig aktiviert.

gcloud

Verwenden Sie den network-services multicast-group-consumer-activations update-Befehl, um das Logging für eine Nutzeraktivierung für die Multicast-Gruppe zu aktivieren oder zu deaktivieren.

  gcloud network-services multicast-group-consumer-activations update GROUP_CONSUMER_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

Ersetzen Sie Folgendes:

  • GROUP_CONSUMER_ACTIVATION_NAME: Der Name der Aktivierung des Multicastgruppen-Consumers.
  • ZONE: Die Zone der Aktivierung des Multicast-Gruppennutzers.
  • --[no-]enable-logging: Gibt an, ob die Protokollierung von Mitgliedschaftsereignissen aktiviert ist.
    • Verwenden Sie --enable-logging, um das Logging zu aktivieren.
    • Verwenden Sie --no-enable-logging, um das Logging zu deaktivieren.

API

Verwenden Sie die multicastGroupConsumerActivations.patch-Methode, um das Logging für eine Nutzeraktivierung für die Multicast-Gruppe zu aktivieren oder zu deaktivieren.

  PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME?updateMask=logConfig
  {
    "logConfig": {"enabled": "LOGGING_ENABLED"}
  }

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts
  • GROUP_CONSUMER_ACTIVATION_NAME: Der Name der Aktivierung des Multicastgruppen-Consumers.
  • ZONE: Die Zone der Aktivierung des Multicast-Gruppennutzers.
  • LOGGING_ENABLED: Gibt an, ob das Logging von Mitgliedschaftsereignissen aktiviert ist.
    • Setzen Sie den Wert auf true, um das Logging zu aktivieren.
    • Setzen Sie den Wert auf false, um das Logging zu deaktivieren.

Protokollereignisse für die Gruppenmitgliedschaft ansehen

In diesem Abschnitt wird beschrieben, wie Sie Ereignisprotokolle zur Gruppenmitgliedschaft für Multicast aufrufen.

Weitere Informationen finden Sie unter Log-Explorer – Übersicht.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf:

    Zum Log-Explorer

  2. Wenn Sie Ereignisprotokolle zur Mitgliedschaft in Multicastgruppen aufrufen möchten, wählen Sie in der Liste Alle Ressourcen einen der folgenden überwachten Ressourcentypen aus:

    • Wenn Sie Multicast-Administrator sind und die Ereignisprotokolle zur Gruppenmitgliedschaft für alle Multicast-Nutzer in einer Gruppe aufrufen möchten, wählen Sie Multicast-Gruppenbereich aus.
    • Wenn Sie ein VPC-Netzwerkadministrator für Multicast-Nutzer sind und Ereignisprotokolle zur Gruppenmitgliedschaft für Ihr Netzwerk aufrufen möchten, wählen Sie Aktivierung des Multicast-Gruppennutzers aus.

Nächste Schritte