Protokollereignisse zur Multicast-Gruppenmitgliedschaft 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äten 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 des 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-Nutzerkonfigurationen und das entsprechende Multicast-Nutzer-Netzwerk enthalten. Wenn Sie eine freigegebene VPC verwenden, ist dies das Hostprojekt.

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

Protokollierte Ereignisse

In diesem Abschnitt werden die Ereignisse zur Gruppenmitgliedschaft 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 Logmeldungen 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 Logeinträgen: einer IGMP join request received-Meldung, gefolgt von IGMP join request rejected due to *.
  • Für einen Multicast-Nutzer, der einer Gruppe bereits erfolgreich beigetreten ist, eine Keep-Alive-IGMP-Beitrittsanfrage in 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 der Keep-Alive-Anfragen, die Multicast-Empfänger regelmäßig im Rahmen des IGMP-Protokolls senden.
IGMP consumer joined

Die Steuerungsebene Google Cloud hat der Gruppe erfolgreich 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 Steuerungsebene Google Cloud 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 Steuerungsebene Google Cloud hat den Multicast-Nutzer aus der Gruppe entfernt, weil der Nutzerendpunkt 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, aber abgelehnt, weil das VPC-Netzwerk des Multicast-Nutzers 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 Google Cloud -Steuerungsebene hat die Beitrittsanfrage erhalten, aber abgelehnt, weil die erforderliche Multicast-Consumer-Konfiguration nicht vollständig ist, z. B. in den folgenden Fällen:

  • Die VPC-Netzwerkkonfiguration des Multicast-Nutzers 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 Aktivierung von Multicast-Gruppennutzenden verfügbar.
Consumer network activated

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

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

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

Dieses Ereignis ist nur für Multicast-Administratoren in den Logs für Ressourcen des Multicast-Gruppenbereichs 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 Aktivierungsressourcen für den globalen Multicast-Gruppenbereich als auch für den zonalen Multicast-Gruppenbereich 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 Logformat 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 der VPC des Multicast-Nutzers. Beispiel: us-east5-a.
consumerNetwork Ressource Das VPC-Netzwerk des Multicast-Nutzers. Nur die Integer-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. Es wird nur die Integer-ID 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-Consumers 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 die Aktivierung oder Deaktivierung eines 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 Integer-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.

Protokollformat für die Aktivierung von Multicast-Gruppennutzern

In diesem Abschnitt wird das Format von Ereignisprotokollen für Gruppenmitgliedschaften beschrieben, die in Projekten mit Multicast-Nutzerkonfigurationen verfügbar sind.

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 zur Aktivierung des Multicast-Gruppennutzers konfigurieren, wie unter Logging für die Aktivierung des Multicast-Gruppennutzers aktivieren beschrieben.

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

  • 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 mit dem VPC-Netzwerk des Multicast-Empfängers unterscheiden, 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.

Im Gegensatz zu den Logs für den Multicast-Gruppenbereich werden in den Logs für die Nutzeraktivierung für die Multicast-Gruppe String-IDs für das Projekt und das Netzwerk verwendet, da die Logs nur für das Projekt verfügbar sind, das die Multicast-Nutzerkonfigurationen 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 das Logging von Gruppenmitgliedschaftsereignissen 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 Multicastgruppenbereich 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 Multicast-Gruppenbereich zu aktivieren oder zu deaktivieren.

    PATCH https://networkservices.googleapis.com/v1/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/v1/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 des Multicast-Gruppennutzers aktivieren

In diesem Abschnitt wird beschrieben, wie ein Administrator eines Multicast-Nutzernetzwerks die Protokollierung 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-Gruppenaktivierung für Consumer 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 Befehl network-services multicast-group-consumer-activations update, 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 Nutzeraktivierung für die Multicast-Gruppe.
  • ZONE: Die Zone der Nutzeraktivierung für die Multicast-Gruppe.
  • --[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 multicastGroupConsumerActivations.patch-Methode, um das Logging für eine Aktivierung des Multicast-Gruppennutzenden zu aktivieren oder zu deaktivieren.

  PATCH https://networkservices.googleapis.com/v1/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 Nutzeraktivierung für die Multicast-Gruppe.
  • ZONE: Die Zone der Nutzeraktivierung für die Multicast-Gruppe.
  • 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 für die 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 Multicast-Gruppenmitgliedschaft aufrufen möchten, wählen Sie in der Liste Alle Ressourcen einen der folgenden überwachten Ressourcentypen aus:
    • Wenn Sie als Multicast-Administrator 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 Multicast Group Consumer Activation (Aktivierung von Multicast-Gruppennutzern) aus.

Nächste Schritte