Visualizzare i log eventi di iscrizione al gruppo multicast

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

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

Informazioni sui log degli eventi di iscrizione ai gruppi

Google Cloud scrive i log degli 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 saperne di più sugli eventi registrati e sul formato dei log, consulta le sezioni seguenti.

Eventi registrati

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

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

• Un'operazione di join IGMP riuscita genera due messaggi di log: un messaggio IGMP join request received seguito da IGMP consumer joined.
• Un'operazione di unione IGMP non riuscita genera due messaggi di log: un messaggio IGMP join request received seguito da IGMP join request rejected due to *.
• Per un consumer multicast che ha già eseguito l'iscrizione a un gruppo, una richiesta di iscrizione IGMP keepalive in un unico messaggio IGMP join request received.

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

Formato log per gli intervalli di gruppi multicast

Questa sezione descrive il formato dei log eventi di iscrizione al gruppo disponibili nel progetto amministratore multicast che contiene le risorse del dominio multicast e dell'intervallo di gruppi.

Questi log vengono scritti per gli eventi di appartenenza per tutti i consumer multicast di un determinato intervallo di gruppi multicast. Puoi configurare la registrazione sia per l'intervallo di gruppi multicast globale sia per le risorse di attivazione dell'intervallo di gruppi multicast zonale, come descritto in Attivare la registrazione per un intervallo di gruppi multicast.

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

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

Il formato del log varia a seconda del tipo di evento registrato. Per i dettagli, consulta le tabelle in ciascuna delle seguenti schede.

      consumerNetwork {
       id: "1234"
      }
      

      consumerProject {
       number: "5678"
      }
      

      consumerResource {
       id: "1111"
      }
      

      consumerResourceProject {
       number: "4321"
      }
      

      consumerNetwork {
       id: "1234"
      }
      

      consumerProject {
       number: "5678"
      }
      

Per mantenere la privacy, vengono utilizzati ID interi per le risorse dei consumer multicast, come progetti, reti e istanze.

Formato log per le attivazioni consumer di gruppi 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 la registrazione nella risorsa di attivazione del consumer del gruppo multicast a livello di zona come descritto in Abilitare la registrazione per l'attivazione del consumer del 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 log: networkservices.googleapis.com%2Fmulticast_memberships

Il log include i seguenti campi:

        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"
        }
        

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

Riferimento per il formato dei campi

Progetto

Risorsa

Attivare il logging degli eventi di appartenenza al gruppo

Le sezioni seguenti descrivono come abilitare la registrazione degli eventi di iscrizione al gruppo.

Abilitare la registrazione per un intervallo di gruppi multicast

Questa sezione descrive come un amministratore multicast può configurare la registrazione degli eventi di appartenenza al gruppo per un intervallo di gruppi multicast esistente.

Per ulteriori informazioni sulla configurazione della registrazione durante la creazione di un nuovo intervallo di gruppi multicast, consulta Creare intervalli di gruppi multicast. La registrazione degli eventi relativi all'iscrizione non è abilitata per impostazione predefinita.

Puoi configurare la registrazione degli eventi di abbonamento in entrambe le seguenti risorse:

• Intervallo di gruppi multicast:la configurazione della registrazione di un intervallo di gruppi globale si applica a tutte le attivazioni dell'intervallo di gruppi.
• Attivazione intervallo di gruppi multicast:la configurazione della registrazione di un'attivazione dell'intervallo di gruppi a livello di zona sostituisce la configurazione dell'intervallo di gruppi globale.

Abilitare la registrazione per un'attivazione consumer gruppo multicast

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

Per una determinata rete VPC che hai attivato per utilizzare il traffico multicast, puoi configurare la registrazione degli eventi di appartenenza nell'attivazione del consumer del gruppo multicast corrispondente.

Per ulteriori informazioni sulla configurazione della registrazione durante la creazione di una nuova attivazione consumer del gruppo multicast, consulta Abilitare una rete VPC per l'utilizzo del traffico multicast. La registrazione degli eventi relativi all'iscrizione non è abilitata per impostazione predefinita.

  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"}
  }

Visualizzare i log degli eventi di appartenenza al gruppo

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

Per saperne di più, consulta la panoramica di Esplora log.

Passaggi successivi

• Acquisire una panoramica dell'osservabilità del multicast
• Visualizzare i log di flusso per il multicast
• Monitorare le metriche di abbonamento per il multicast