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.

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.

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.

      consumerNetwork {
       id: "1234"
      }
      

      consumerProject {
       number: "5678"
      }
      

      consumerResource {
       id: "1111"
      }
      

      consumerResourceProject {
       number: "4321"
      }
      

      consumerNetwork {
       id: "1234"
      }
      

      consumerProject {
       number: "5678"
      }
      

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:

        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
        

        consumerProject {
          id: "my-project"
          number: "5678"
        }
        

        consumerResource {
          name: "my-instance"
          id: "1111"
        }
        

        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
        

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

Ressource

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.

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 network-services multicast-group-consumer-activations update GROUP_CONSUMER_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

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

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.

Nächste Schritte

• Übersicht über die Multicast-Beobachtbarkeit
• Flusslogs für Multicast ansehen
• Mitgliedschaftsmesswerte für Multicast beobachten