Logs zu Ereignissen der Gruppenmitgliedschaft für ULL Multicast ansehen

Allgemeine Verfügbarkeit mit Zulassungsliste: Die ULL-Lösung ist nur für zugelassene Börsenbetreiber und deren Börsenteilnehmer verfügbar. Wenn Sie ein zugelassener Börsenteilnehmer sind, wenden Sie sich an [e-mail], um Zugriff anzufordern.

Auf dieser Seite finden Sie Informationen zu den Logs, die zur Überwachung von Ereignissen der Multicast-Gruppenmitgliedschaft wie IGMP-Beitrittsanfragen verfügbar sind. Außerdem wird beschrieben, wie Sie diese aktivieren und ansehen.

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

Logs zu Ereignissen der Gruppenmitgliedschaft

Google Cloud schreibt Logs zu Ereignissen der Gruppenmitgliedschaft für Multicast in Cloud Logging.

Diese Tabelle enthält eine Zusammenfassung der Logs, die für jeden Ressourcentyp verfügbar sind, einschließlich des Projekts, das die Logs empfängt. Weitere Informationen zu den protokollierten Ereignissen und zum Logformat finden Sie in den folgenden Abschnitten.

Ressource

Beschreibung der Logs

Aktivierung des Multicast-Gruppennutzers

Logs zu Ereignissen der Gruppenmitgliedschaft für Multicast-Nutzer in einem bestimmten Multicast-Nutzer-VPC-Netzwerk, das für einen Gruppenbereich und eine Zone aktiviert ist. Diese Logs sind in Projekten verfügbar, die Konfigurationen für Multicast-Nutzer und das entsprechende Netzwerk für Multicast-Nutzer enthalten. Wenn Sie eine freigegebene VPC verwenden, ist dies das Hostprojekt. Weitere Informationen finden Sie unter Logging für eine Aktivierung des Multicast-Gruppennutzers aktivieren.

Protokollierte Ereignisse

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

Wenn ein Multicast-Nutzer einen IGMP-Mitgliedschaftsbericht sendet, um einer Gruppe beizutreten, sehen die resultierenden Logmeldungen so aus:

• Ein erfolgreicher IGMP-Beitritt führt zu zwei Logmeldungen: eine Meldung IGMP join request received (IGMP-Beitrittsanfrage empfangen) gefolgt von IGMP consumer joined (IGMP-Nutzer beigetreten).
• Für einen Multicast-Nutzer, der bereits erfolgreich einer Gruppe beigetreten ist, wird eine Keep-Alive-IGMP-Beitrittsanfrage in einer einzelnen IGMP join request received Meldung protokolliert.

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 Meldung bestätigt nicht, dass der Beitritt erfolgreich abgeschlossen wurde. Jede Beitrittsanfrage wird protokolliert, einschließlich der Keep-Alive-Anfragen, die Multicast-Nutzer regelmäßig im Rahmen des IGMP-Protokolls senden.
IGMP consumer joined	Die Google Cloud Steuerungsebene hat den Multicast Nutzer erfolgreich der Gruppe hinzugefügt. Nachdem dieses Ereignis an die Multicast Infrastruktur für die Domain weitergegeben wurde, empfängt der Multicast-Nutzer Multicast-Traffic. Diesem Ereignis geht immer ein Ereignis IGMP join request received (IGMP-Beitrittsanfrage empfangen) voraus.
IGMP consumer left	Die Google Cloud Steuerungsebene hat eine explizite IGMP-Austrittsanfrage vom Multicast-Nutzer erhalten und die Anfrage angewendet.
IGMP consumer timed out	Die Google Cloud Steuerungsebene hat den Multicast-Nutzer aus der Gruppe entfernt, da er nicht mehr mit Keep-Alive-Anfragen reagiert hat.
IGMP entitlement rejected	Die Google Cloud Steuerungsebene hat die Beitrittsanfrage erhalten, sie aber abgelehnt, weil die erforderliche Konfiguration des Multicast-Nutzers nicht vollständig ist, z. B. in den folgenden Fällen: Die Konfiguration des VPC-Netzwerk für Multicast-Nutzer ist nicht vollständig. Die Konfiguration des VPC-Netzwerk für Multicast-Nutzer wurde nicht an die Multicast-Infrastruktur für die Domain weitergegeben. Der Multicast-Nutzer ist nicht für IGMP konfiguriert. Dieses Ereignis ist nur in den Logs für die Ressource zur Aktivierung des Multicast-Gruppen nutzers verfügbar.

Logformat für Aktivierungen des Multicast-Gruppennutzers

In diesem Abschnitt wird das Format der Logs zu Ereignissen der Gruppenmitgliedschaft beschrieben, die in Projekten mit Konfigurationen für Multicast-Nutzer 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 eine Aktivierung des Multicast-Gruppennutzers aktivieren beschrieben.

Der überwachte Ressourcentyp und der Logname von Cloud Logging 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-Nutzers. 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-Nutzers 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-Nutzers enthält. Dieses kann sich vom Projekt unterscheiden, das das VPC-Netzwerk des Multicast Nutzers enthält, z. B. bei Verwendung einer freigegebene VPC. Beispiel: consumerResourceProject { id: "my-instance-project" number: "4321" }
eventDescription	String	Eines der unter Protokollierte Ereignisse beschriebenen Ereignisse. Beispiel: IGMP consumer joined (IGMP-Nutzer beigetreten).
eventTime	String	Der Zeitstempel des Ereignisses im RFC 3339-Textformat. Beispiel: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation	String	Der Name der Multicast-Nutzerverknüpfung zwischen dem Multicast Nutzer-VPC-Netzwerk und der Domain. Beispiel: my-consumer-association-name.
multicastGroupConsumerActivation	String	Der Name der Aktivierung des Multicast-Gruppennutzers. 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 Aktivierung des Multicast-Gruppennutzers String-IDs für das Projekt und das Netzwerk verwendet, da die Logs nur für das Projekt verfügbar sind, das die Konfigurationen für Multicast-Nutzer 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.

Logging von Ereignissen der Gruppenmitgliedschaft aktivieren

In den folgenden Abschnitten wird beschrieben, wie Sie das Logging von Ereignissen der Gruppenmitgliedschaft aktivieren.

Logging für eine Aktivierung des Multicast-Gruppennutzers aktivieren

In diesem Abschnitt wird beschrieben, wie ein Netzwerkadministrator für Multicast-Nutzer das Logging von Ereignissen der Gruppenmitgliedschaft für sein VPC-Netzwerk konfigurieren kann.

Für ein bestimmtes VPC-Netzwerk, das Sie für die Nutzung von Multicast-Traffic aktiviert haben, können Sie das Logging von Mitgliedschaftsereignissen für die entsprechende Aktivierung des Multicast-Gruppennutzers konfigurieren.

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

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen oder eine der folgenden IAM-Rollen.

Berechtigungen

• networkservices.multicastGroupConsumerActivations.update

Rollen

• Multicast-Administrator (roles/compute.multicastAdmin)

gcloud

Verwenden Sie den network-services multicast-group-consumer-activations update Befehl, um das Logging für eine Aktivierung des Multicast-Gruppennutzers 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 Multicast-Gruppennutzers
• ZONE: die Zone der Aktivierung des Multicast-Gruppennutzers
• --[no-]enable-logging: bestimmt, 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-Gruppennutzers 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 Aktivierung des Multicast-Gruppennutzers
• 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.

Logs zu Ereignissen der Gruppenmitgliedschaft ansehen

In diesem Abschnitt wird beschrieben, wie Sie Logs zu Ereignissen der Gruppenmitgliedschaft für Multicast ansehen.

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 Logs zu Ereignissen der Multicast-Gruppenmitgliedschaft ansehen möchten, wählen Sie in der Liste Alle Ressourcen einen der folgenden überwachten Ressourcentypen aus:
   • Wenn Sie ein Netzwerkadministrator für ein Multicast-Consumer-VPC-Netzwerk sind und Logs zu Ereignissen der Gruppenmitgliedschaft für Ihr Netzwerk ansehen möchten, wählen Sie Aktivierung des Multicast-Gruppennutzers aus.