Visualizzare i log degli eventi di appartenenza a un gruppo per ULL Multicast

Questa pagina fornisce informazioni sui log disponibili per il monitoraggio degli eventi di iscrizione al gruppo multicast, come le join IGMP, e descrive come abilitarli e visualizzarli.

Puoi utilizzare questi log per comprendere l'attività in un gruppo multicast, ad esempio quando un consumer multicast si è unito e quando ha abbandonato il gruppo o quanti consumer multicast sono presenti in un gruppo.

Informazioni sui log degli eventi di iscrizione al gruppo

Google Cloud scrive i log eventi di iscrizione al gruppo per il multicast in Cloud Logging.

Questa tabella fornisce un riepilogo dei log disponibili per ogni tipo di risorsa, incluso il progetto che riceve i log. Per ulteriori informazioni sugli eventi registrati e sul formato dei log, consulta le sezioni seguenti.

Risorsa Descrizione dei log
Attivazione consumer gruppo multicast

Log degli eventi di iscrizione al gruppo per i consumer multicast in una rete VPC consumer multicast specifica attivata per un intervallo di gruppi e una zona.

Questi log sono disponibili nei progetti che contengono configurazioni consumer multicast e la relativa rete consumer multicast. Se utilizzi il VPC condiviso, questo è il progetto host.

Consulta Abilitare il logging per un'attivazione consumer gruppo multicast attivazione.

Eventi registrati

Questa sezione descrive gli eventi di iscrizione al gruppo registrati per il multicast in Cloud Logging.

Quando un consumer multicast invia un report di appartenenza IGMP per unirsi a un gruppo, i messaggi di log risultanti sono i seguenti:

  • Una join IGMP riuscita genera due messaggi di log: un messaggio IGMP join request received seguito da IGMP consumer joined.
  • Per un consumer multicast che ha già eseguito la join a un gruppo, una richiesta di join IGMP keepalive in un singolo IGMP join request received messaggio.

Per un elenco completo degli eventi registrati e delle relative descrizioni, consulta la tabella seguente.

Evento Descrizione
IGMP join request received

Il Google Cloud control plane ha ricevuto la richiesta di join. Questo messaggio non conferma che la join sia stata completata correttamente.

Ogni richiesta di join viene registrata, incluse le richieste keepalive che i consumer multicast inviano periodicamente nell'ambito del protocollo IGMP.
IGMP consumer joined

Il Google Cloud control plane ha aggiunto correttamente il consumer multicast al gruppo. Dopo che questo evento è stato propagato all'infrastruttura multicast per il dominio, il consumer multicast inizia a ricevere traffico multicast.

Questo evento è sempre preceduto da un evento IGMP join request received.
IGMP consumer left

Il Google Cloud control plane ha ricevuto una richiesta di leave IGMP esplicita dal consumer multicast e l'ha applicata.
IGMP consumer timed out

Il Google Cloud control plane ha rimosso il consumer multicast da il gruppo perché il consumer multicast ha smesso di rispondere con le richieste keepalive.
IGMP entitlement rejected

Il Google Cloud control plane ha ricevuto la richiesta di join, ma l'ha rifiutata perché la configurazione consumer multicast richiesta non è completa, ad esempio nei seguenti casi:

  • La configurazione della rete VPC consumer multicast non è completa.
  • La configurazione della rete VPC consumer multicast non è stata propagata all'infrastruttura multicast per il dominio.
  • Il consumer multicast non è configurato per IGMP.

Questo evento è disponibile solo nei log della risorsa di attivazione consumer gruppo multicast.

Formato dei log per le attivazioni consumer gruppo multicast

Questa sezione descrive il formato dei log eventi di iscrizione al gruppo disponibili nei progetti che contengono configurazioni consumer multicast.

Questi log vengono scritti per gli eventi di appartenenza per i consumer multicast in una determinata rete VPC attivata per un intervallo di gruppi multicast e una zona. Puoi configurare il logging sulla risorsa di attivazione consumer gruppo multicast a livello di zona come descritto in Abilitare il logging per un'attivazione consumer gruppo multicast.

Il tipo di risorsa monitorata di Cloud Logging e il nome del log sono i seguenti:

  • Tipo di risorsa: networkservices.googleapis.com/MulticastGroupConsumerActivation
  • Nome del log: networkservices.googleapis.com%2Fmulticast_memberships

Il log include i seguenti campi:

Campo Tipo Descrizione
consumerIp string L'indirizzo IPv4 interno principale del consumer multicast. Esempio: 10.0.0.1.
consumerLocation string La zona del consumer multicast. Esempio: us-east5-a.
consumerNetwork Risorsa La rete VPC consumer multicast. Esempio: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Progetto Il progetto che contiene la rete VPC consumer multicast. Esempio: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Risorsa L'istanza VM consumer multicast. Esempio: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Progetto Il progetto che contiene l'istanza VM consumer multicast. Questo può essere diverso dal progetto che contiene la rete VPC consumer multicast, ad esempio quando si utilizza il VPC condiviso. Esempio: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription string Uno degli eventi descritti in Eventi registrati. Esempio: IGMP consumer joined.
eventTime string Il timestamp dell'evento in formato di testo RFC 3339. Esempio: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation string Il nome dell'associazione del consumer multicast tra la rete VPC consumer multicast e il dominio. Esempio: my-consumer-association-name.
multicastGroupConsumerActivation string Il nome dell'attivazione consumer gruppo multicast. Esempio: my-group-consumer-activation-name.
multicastIp string L'indirizzo IP del gruppo multicast. Esempio: 224.0.0.1.

A differenza dei log dell'intervallo di gruppi multicast, i log di attivazione consumer gruppo multicast utilizzano ID stringa per il progetto e la rete perché i log sono disponibili solo per il progetto che contiene le configurazioni consumer multicast.

Riferimento per il formato dei campi

Progetto

Campo Tipo Descrizione
number string (uint64) L'ID intero del progetto generato automaticamente. Esempio: 5678.
id string L'ID del progetto assegnato dall'utente. Esempio: my-project.

Risorsa

Campo Tipo Descrizione
id string (uint64) L'ID intero della risorsa generato automaticamente. Esempio: 1111.
name string Il nome della risorsa assegnato dall'utente. Esempio: my-instance.

Abilitare il logging degli eventi di iscrizione al gruppo

Le sezioni seguenti descrivono come abilitare il logging degli eventi di iscrizione al gruppo.

Abilitare il logging per un'attivazione consumer gruppo multicast

Questa sezione descrive come un amministratore di rete consumer multicast può configurare il logging degli eventi di iscrizione al gruppo per la propria rete VPC.

Per una determinata rete VPC che hai abilitato per utilizzare il traffico multicast, puoi configurare il logging degli eventi di appartenenza sull'attivazione consumer gruppo multicast corrispondente.

Per ulteriori informazioni sulla configurazione del logging durante la creazione di una nuova attivazione consumer gruppo multicast, consulta Abilitare una rete VPC per utilizzare il traffico multicast. Il logging degli eventi di appartenenza non è abilitato per impostazione predefinita.

gcloud

Per abilitare o disabilitare il logging per un'attivazione consumer gruppo multicast, utilizza il network-services multicast-group-consumer-activations update comando.

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

Sostituisci quanto segue:

  • GROUP_CONSUMER_ACTIVATION_NAME: il nome dell'attivazione consumer gruppo multicast
  • ZONE: la zona dell'attivazione consumer gruppo multicast
  • --[no-]enable-logging: determina se il logging degli eventi di appartenenza è abilitato.
    • Per abilitare il logging, utilizza --enable-logging.
    • Per disabilitare il logging, utilizza --no-enable-logging.

API

Per abilitare o disabilitare il logging per un'attivazione consumer gruppo multicast, utilizza il multicastGroupConsumerActivations.patch metodo.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • GROUP_CONSUMER_ACTIVATION_NAME: il nome dell'attivazione consumer gruppo multicast
  • ZONE: la zona dell'attivazione consumer gruppo multicast
  • LOGGING_ENABLED: specifica se il logging degli eventi di appartenenza è abilitato.
    • Per abilitare il logging, imposta su true.
    • Per disabilitare il logging, imposta su false.

Visualizzare i log degli eventi di appartenenza a un gruppo

Questa sezione descrive come visualizzare i log degli eventi di appartenenza a un gruppo per il multicast.

Per ulteriori informazioni, consulta la panoramica di Esplora log.

Console

  1. Nella Google Cloud console, vai alla pagina Esplora log:

    Vai a Esplora log

  2. Per visualizzare i log eventi di iscrizione al gruppo multicast, seleziona uno dei seguenti tipi di risorsa monitorata dall'elenco Tutte le risorse :
    • Se sei un amministratore di rete VPC consumer multicast e vuoi visualizzare i log eventi di iscrizione al gruppo per la tua rete, seleziona Attivazione consumer gruppo multicast.