Visualizzare i log degli eventi di appartenenza al gruppo multicast

Questa pagina fornisce informazioni sui log disponibili per il monitoraggio degli eventi di appartenenza 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 è entrato e quando è uscito 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 appartenenza 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.

Risorsa Descrizione dei log
Intervallo di gruppi multicast

Log degli eventi di appartenenza al gruppo per tutti i consumer multicast di un intervallo di gruppi.

Questi log sono disponibili solo nei progetti di amministrazione multicast.

Puoi configurare la registrazione sia per un intervallo di gruppi multicast globale sia per un'attivazione dell'intervallo di gruppi multicast a livello di zona. Vedi Attivare la registrazione per un intervallo di gruppi multicast.
Attivazione consumer gruppo multicast

Log degli eventi di appartenenza 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 risorse consumer multicast, che possono essere il progetto amministratore multicast o un progetto consumer multicast separato, a seconda della topologia del dominio multicast.

Consulta Abilitare la registrazione per l'attivazione di un consumer del gruppo multicast.

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 unione 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 join IGMP keepalive genera un singolo messaggio IGMP join request received.

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 partecipazione. Questo messaggio non conferma che l'unione è 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 piano di controllo Google Cloud 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 control plane Google Cloud ha ricevuto una richiesta di uscita IGMP esplicita dal consumer multicast e l'ha applicata.
IGMP consumer timed out

Il Google Cloud control plane ha rimosso il consumer multicast dal gruppo perché il consumer multicast ha smesso di rispondere con richieste keepalive.
Consumer removed due to configuration change

Il Google Cloud control plane ha rimosso il consumer multicast dal gruppo perché l'endpoint consumer è stato eliminato. Ad esempio, l'istanza o il progetto consumer potrebbe essere stato eliminato.
IGMP join request rejected due to full tree

Il control plane ha ricevuto la richiesta di join, ma l'ha rifiutata perché il gruppo multicast è già al massimo della capacità. Google Cloud

IGMP join request rejected due to missing quota

Il Google Cloud control plane ha ricevuto la richiesta di unione, ma l'ha rifiutata perché la rete VPC consumer multicast sta già utilizzando tutta la quota per le VM consumer multicast per rete VPC.
IGMP join request rejected due to unknown reason

Il Google Cloud control plane ha ricevuto la richiesta di unione, ma l'ha rifiutata a causa di un errore che non ha un motivo specifico.
IGMP entitlement rejected

Il control plane Google Cloud ha ricevuto la richiesta di join, ma l'ha rifiutata perché la configurazione del 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 per la risorsa di attivazione del consumer del gruppo multicast.
Consumer network activated

È stata attivata una rete VPC consumer multicast per un intervallo di gruppi multicast. Corrisponde alla creazione di una risorsa attivazione consumer gruppo multicast.

Questo evento è disponibile solo per gli amministratori multicast nei log per le risorse dell'intervallo di gruppi multicast.
Consumer network deactivated

Una rete VPC consumer multicast è stata disattivata per un intervallo di gruppi multicast. Ciò significa che una risorsa multicast group consumer activation è stata eliminata o il suo stato è stato modificato in INACTIVE.

Questo evento è disponibile solo per gli amministratori multicast nei log per le risorse dell'intervallo di gruppi multicast.

Formato dei log per gli intervalli di gruppi multicast

Questa sezione descrive il formato dei log degli eventi di appartenenza 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 l'intervallo di gruppi multicast a livello di zona, 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 è diverso a seconda del tipo di evento registrato. Per i dettagli, consulta le tabelle in ciascuna delle seguenti schede.

Evento IGMP

Se l'evento registrato è un evento IGMP, 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 VPC consumer multicast. Esempio: us-east5-a.
consumerNetwork Risorsa La rete VPC consumer multicast. Viene compilato solo l'ID intero. Esempio: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Progetto Il progetto che contiene la rete VPC consumer multicast. Viene compilato solo il numero di progetto. Esempio: 
      consumerProject {
       number: "5678"
      }
consumerResource Risorsa L'istanza VM consumer multicast. Viene compilato solo l'ID intero. Esempio: 
      consumerResource {
       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. Viene compilato solo il numero di progetto. Esempio: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription string Uno degli eventi descritti in Eventi registrati. Esempio: IGMP consumer joined.
eventTime string Il timestamp dell'evento nel formato di testo RFC 3339. Esempio: 2024-10-21T06:46:42.990162973Z.
multicastDomain string Il nome del dominio multicast. Esempio: my-domain-name.
multicastGroupRange string Il nome dell'intervallo di gruppi multicast. Esempio: my-group-range-name.
multicastIp string L'indirizzo IP del gruppo multicast. Esempio: 224.0.0.1.

Attivazione/disattivazione

Se l'evento registrato è un'attivazione o una disattivazione della rete VPC consumer multicast, il log include i seguenti campi:

Campo Tipo Descrizione
consumerLocation string La zona in cui è stata attivata la rete VPC consumer multicast. Esempio: us-east5-a.
consumerNetwork Risorsa La rete VPC consumer multicast. Viene compilato solo l'ID intero. Esempio: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Progetto Il progetto che contiene la rete VPC consumer multicast. Viene compilato solo il numero di progetto. Esempio: 
      consumerProject {
       number: "5678"
      }
eventDescription string Uno degli eventi descritti in Eventi registrati. Esempio: Consumer network activated.
eventTime string Il timestamp dell'evento nel formato di testo RFC 3339. Esempio: 2024-10-21T06:46:42.990162973Z.
multicastDomain string Il nome del dominio multicast. Esempio: my-domain-name.
multicastGroupRange string Il nome dell'intervallo di gruppi multicast. Esempio: my-group-range-name

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

Formato dei log per le attivazioni consumer del gruppo multicast

Questa sezione descrive il formato dei log degli eventi di appartenenza al gruppo disponibili nei progetti che contengono risorse consumer multicast. Il progetto può essere il progetto amministratore multicast o un progetto consumer multicast separato, a seconda della topologia del dominio multicast.

Questi log vengono scritti per gli eventi di appartenenza per i consumer multicast in una determinata rete VPC attivata per un intervallo e una zona di gruppi multicast. 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 di un 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:

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 nel formato di testo RFC 3339. Esempio: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation string Il nome dell'associazione consumer multicast tra la rete VPC consumer multicast e il dominio. Esempio: my-consumer-association-name.
multicastGroupConsumerActivation string Il nome dell'attivazione del consumer del 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 dell'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 risorse del consumer multicast.

Riferimento al formato campo

Progetto

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

Risorsa

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

Attivare il logging degli eventi di appartenenza al gruppo

Le sezioni seguenti descrivono come attivare la registrazione degli eventi di appartenenza al gruppo per un intervallo di gruppi multicast o una rete VPC consumer multicast specifica.

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 di iscrizione non è abilitata per impostazione predefinita.

Puoi configurare la registrazione degli eventi di abbonamento su 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 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.

gcloud

  • Per attivare o disattivare la registrazione per un intervallo di gruppi multicast, utilizza il comando network-services multicast-group-ranges update.

    gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
    --location=global \
    [--enable-logging | --no-enable-logging]

    Sostituisci quanto segue:

    • GROUP_RANGE_NAME: il nome dell'intervallo di gruppi multicast
    • --[no-]enable-logging: determina se il logging degli eventi di abbonamento è abilitato.
      • Per attivare il logging, utilizza --enable-logging.
      • Per disattivare la registrazione, utilizza --no-enable-logging.

  • Per abilitare o disabilitare la registrazione per l'attivazione di un intervallo di gruppi multicast, utilizza il comando network-services multicast-group-range-activations update.

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

    Sostituisci quanto segue:

    • GROUP_RANGE_ACTIVATION_NAME: il nome dell'attivazione dell'intervallo di gruppi multicast
    • ZONE: la zona di attivazione dell'intervallo di gruppi multicast
    • --[no-]enable-logging: determina se il logging degli eventi di abbonamento è abilitato.
      • Per attivare il logging, utilizza --enable-logging.
      • Per disattivare la registrazione, utilizza --no-enable-logging.

API

  • Per attivare o disattivare la registrazione per un intervallo di gruppi multicast, utilizza il metodo multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto
    • GROUP_RANGE_NAME: il nome dell'intervallo di gruppi multicast
    • LOGGING_ENABLED: specifica se il logging degli eventi di abbonamento è abilitato.
      • Per attivare il logging, imposta il valore su true.
      • Per disattivare il logging, imposta il valore su false.

  • Per attivare o disattivare la registrazione per l'attivazione di un intervallo di gruppi multicast, utilizza il metodo multicastGroupRangeActivations.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto
    • GROUP_RANGE_ACTIVATION_NAME: il nome dell'attivazione dell'intervallo di gruppi multicast
    • ZONE: la zona di attivazione dell'intervallo di gruppi multicast
    • LOGGING_ENABLED: specifica se il logging degli eventi di abbonamento è abilitato.
      • Per attivare il logging, imposta il valore su true.
      • Per disattivare il logging, imposta il valore su false.

Abilitare la registrazione per l'attivazione di un consumer del gruppo multicast

Questa sezione descrive come un amministratore di rete consumer multicast può configurare il logging degli eventi di appartenenza 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 del consumer del gruppo di multicast, consulta Abilitare una rete VPC a utilizzare il traffico multicast. La registrazione degli eventi relativi all'iscrizione non è abilitata per impostazione predefinita.

gcloud

Per attivare o disattivare la registrazione per l'attivazione del consumer di un gruppo multicast, utilizza il comando network-services multicast-group-consumer-activations update.

  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 del consumer del gruppo multicast
  • ZONE: la zona dell'attivazione consumer del gruppo multicast
  • --[no-]enable-logging: determina se il logging degli eventi di abbonamento è abilitato.
    • Per attivare il logging, utilizza --enable-logging.
    • Per disattivare la registrazione, utilizza --no-enable-logging.

API

Per attivare o disattivare la registrazione per l'attivazione di un consumer del gruppo multicast, utilizza il metodo multicastGroupConsumerActivations.patch.

  PATCH https://networkservices.googleapis.com/v1beta1/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 del consumer del gruppo multicast
  • ZONE: la zona dell'attivazione consumer del gruppo multicast
  • LOGGING_ENABLED: specifica se il logging degli eventi di abbonamento è abilitato.
    • Per attivare il logging, imposta il valore su true.
    • Per disattivare il logging, imposta il valore su false.

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.

Console

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

    Vai a Esplora log

  2. Per visualizzare i log degli eventi di appartenenza al gruppo multicast, seleziona uno dei seguenti tipi di risorsa monitorata dall'elenco Tutte le risorse:

    • Se sei un amministratore multicast e vuoi visualizzare i log degli eventi di appartenenza al gruppo per tutti i consumer multicast di un gruppo, seleziona Intervallo gruppi multicast.
    • Se sei un amministratore di una rete VPC consumer multicast e vuoi visualizzare i log eventi di appartenenza al gruppo per la tua rete, seleziona Attivazione consumer gruppo multicast.

Passaggi successivi