Ver registros de eventos de associação a grupos multicast

Nesta página, você encontra informações sobre os registros disponíveis para monitorar eventos de associação a grupos multicast, como junções IGMP, e descreve como ativá-los e visualizá-los.

É possível usar esses registros para entender a atividade em um grupo multicast, como quando um consumidor multicast entrou e saiu ou quantos consumidores multicast estão em um grupo.

Sobre os registros de eventos de associação a grupos

OGoogle Cloud grava registros de eventos de associação a grupos para multicast no Cloud Logging.

Esta tabela fornece um resumo dos registros disponíveis para cada tipo de recurso, incluindo o projeto que recebe registros. Para mais informações sobre os eventos registrados e o formato do registro, consulte as seções a seguir.

Recurso Descrição dos registros
Intervalo do grupo multicast

Registros de eventos de associação a grupos para todos os consumidores multicast de um intervalo de grupos.

Esses registros estão disponíveis apenas em projetos de administrador de multicast.

É possível configurar o registro em um intervalo global de grupos multicast e em uma ativação de intervalo de grupos multicast zonais. Consulte Ativar o registro em um intervalo de grupo multicast.
Ativação do consumidor do grupo multicast

Registros de eventos de associação a grupos para consumidores de multicast em uma rede VPC de consumidor de multicast específica ativada para um intervalo de grupo e uma zona.

Esses registros estão disponíveis em projetos que contêm recursos de consumidor de multicast, que podem ser o projeto de administrador de multicast ou um projeto de consumidor de multicast separado, dependendo da topologia do domínio de multicast.

Consulte Ativar o registro em log para uma ativação de consumidor de grupo multicast.

Eventos registrados

Esta seção descreve os eventos de associação a grupos registrados para multicast no Cloud Logging.

Quando um consumidor de multicast envia um relatório de associação IGMP para entrar em um grupo, as mensagens de registro resultantes são as seguintes:

  • Uma junção IGMP bem-sucedida resulta em duas mensagens de registro: uma mensagem IGMP join request received seguida por IGMP consumer joined.
  • Uma junção de IGMP com falha resulta em duas mensagens de registro: uma mensagem IGMP join request received seguida por IGMP join request rejected due to *.
  • Para um consumidor de multicast que já participou de um grupo, uma solicitação de participação de IGMP keepalive resulta em uma única mensagem IGMP join request received.

Para conferir uma lista completa dos eventos registrados e suas descrições, consulte a tabela a seguir.

Evento Descrição
IGMP join request received

O plano de controle Google Cloud recebeu a solicitação de junção. Essa mensagem não confirma que a junção foi concluída.

Cada solicitação de junção é registrada, incluindo as solicitações de manutenção de atividade que os consumidores de multicast enviam periodicamente como parte do protocolo IGMP.
IGMP consumer joined

O plano de controle Google Cloud adicionou o consumidor multicast ao grupo. Depois que esse evento é propagado para a infraestrutura multicast do domínio, o consumidor multicast começa a receber tráfego multicast.

Esse evento é sempre precedido por um evento IGMP join request received.
IGMP consumer left

O plano de controle do Google Cloud recebeu uma solicitação explícita de saída do IGMP do consumidor de multicast e aplicou a solicitação.
IGMP consumer timed out

O plano de controle Google Cloud removeu o consumidor de multicast do grupo porque ele parou de responder com solicitações de manutenção de atividade.
Consumer removed due to configuration change

O plano de controle Google Cloud removeu o consumidor de multicast do grupo porque o endpoint do consumidor foi excluído. Por exemplo, a instância ou o projeto do consumidor pode ter sido excluído.
IGMP join request rejected due to full tree

O plano de controle Google Cloud recebeu a solicitação de participação, mas a rejeitou porque o grupo multicast já está na capacidade máxima.
IGMP join request rejected due to missing quota

O plano de controle Google Cloud recebeu a solicitação de junção, mas a rejeitou porque a rede VPC de consumidor multicast já está usando toda a cota de VMs de consumidor multicast por rede VPC.
IGMP join request rejected due to unknown reason

O plano de controle Google Cloud recebeu a solicitação de junção, mas a rejeitou devido a uma falha que não tem um motivo específico.
IGMP entitlement rejected

O plano de controle do Google Cloud recebeu a solicitação de junção, mas a rejeitou porque a configuração necessária do consumidor de multicast não está completa, como nos seguintes casos:

  • A configuração da rede VPC do consumidor de multicast não está concluída.
  • A configuração da rede VPC do consumidor de multicast não foi propagada para a infraestrutura de multicast do domínio.
  • O consumidor de multicast não está configurado para IGMP.

Esse evento só está disponível nos registros do recurso de ativação do consumidor do grupo multicast.
Consumer network activated

Uma rede VPC de consumidor multicast foi ativada para um intervalo de grupo multicast. Isso corresponde à criação de um recurso de ativação do consumidor do grupo multicast.

Esse evento está disponível apenas para administradores de multicast nos registros de recursos de intervalo de grupos multicast.
Consumer network deactivated

Uma rede VPC de consumidor multicast foi desativada para um intervalo de grupo multicast. Isso significa que um recurso de ativação do consumidor do grupo multicast foi excluído ou que o status dele mudou para INACTIVE.

Esse evento está disponível apenas para administradores de multicast nos registros de recursos de intervalo de grupos multicast.

Formato de registro para intervalos de grupos multicast

Nesta seção, descrevemos o formato dos registros de eventos de associação a grupos disponíveis no projeto de administrador de multicast que contém recursos de domínio de multicast e intervalo de grupos.

Esses registros são gravados para eventos de associação de todos os consumidores multicast de um determinado intervalo de grupo multicast. É possível configurar o registro em recursos de ativação de intervalo de grupo multicast global e zonal, conforme descrito em Ativar o registro em um intervalo de grupo multicast.

O tipo de recurso monitorado e o nome do registro do Cloud Logging são os seguintes:

  • Tipo de recurso: networkservices.googleapis.com/MulticastGroupRange
  • Nome do registro: networkservices.googleapis.com%2Fmulticast_memberships

O formato do registro varia de acordo com o tipo de evento registrado. Consulte as tabelas em cada uma das guias a seguir para mais detalhes.

Evento do IGMP

Se o evento registrado for do IGMP, o registro vai incluir os seguintes campos:

Campo Tipo Descrição
consumerIp string O endereço IPv4 interno principal do consumidor de multicast. Exemplo: 10.0.0.1.
consumerLocation string A zona da VPC do consumidor multicast. Exemplo: us-east5-a.
consumerNetwork Recurso A rede VPC do consumidor de multicast. Apenas o ID inteiro é preenchido. Exemplo: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projeto O projeto que contém a rede VPC do consumidor de multicast. Apenas o número do projeto é preenchido. Exemplo: 
      consumerProject {
       number: "5678"
      }
consumerResource Recurso A instância de VM do consumidor de multicast. Apenas o ID inteiro é preenchido. Exemplo: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Projeto O projeto que contém a instância da VM do consumidor multicast. Isso pode ser diferente do projeto que contém a rede VPC do consumidor de multicast, como ao usar a VPC compartilhada. Apenas o número do projeto é preenchido. Exemplo: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription string Um dos eventos descritos em Eventos registrados. Exemplo: IGMP consumer joined.
eventTime string O carimbo de data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain string O nome do domínio multicast. Exemplo: my-domain-name.
multicastGroupRange string O nome do intervalo de grupos multicast. Exemplo: my-group-range-name.
multicastIp string O endereço IP do grupo multicast. Exemplo: 224.0.0.1.

Ativação/desativação

Se o evento registrado for uma ativação ou desativação de rede VPC de consumidor multicast, o registro vai incluir os seguintes campos:

Campo Tipo Descrição
consumerLocation string A zona em que a rede VPC do consumidor multicast foi ativada. Exemplo: us-east5-a.
consumerNetwork Recurso A rede VPC do consumidor de multicast. Apenas o ID inteiro é preenchido. Exemplo: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projeto O projeto que contém a rede VPC do consumidor de multicast. Apenas o número do projeto é preenchido. Exemplo: 
      consumerProject {
       number: "5678"
      }
eventDescription string Um dos eventos descritos em Eventos registrados. Exemplo: Consumer network activated.
eventTime string O carimbo de data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain string O nome do domínio multicast. Exemplo: my-domain-name.
multicastGroupRange string O nome do intervalo de grupos multicast. Exemplo: my-group-range-name

IDs de números inteiros são usados para recursos de consumidores de multicast, como projetos, redes e instâncias, para manter a privacidade.

Formato de registro para ativações de consumidores de grupos multicast

Nesta seção, descrevemos o formato dos registros de eventos de associação a grupos disponíveis em projetos que contêm recursos de consumidor multicast. O projeto pode ser o administrador de multicast ou um projeto consumidor de multicast separado, dependendo da topologia do domínio de multicast.

Esses registros são gravados para eventos de associação de consumidores de multicast em uma determinada rede VPC ativada para um intervalo e uma zona de grupo multicast. Você pode configurar a geração de registros no recurso de ativação do consumidor do grupo multicast zonal, conforme descrito em Ativar a geração de registros para uma ativação do consumidor do grupo multicast.

O tipo de recurso monitorado e o nome do registro do Cloud Logging são os seguintes:

  • Tipo de recurso: networkservices.googleapis.com/MulticastGroupConsumerActivation
  • Nome do registro: networkservices.googleapis.com%2Fmulticast_memberships

O registro inclui os seguintes campos:

Campo Tipo Descrição
consumerIp string O endereço IPv4 interno principal do consumidor de multicast. Exemplo: 10.0.0.1.
consumerLocation string A zona do consumidor de multicast. Exemplo: us-east5-a.
consumerNetwork Recurso A rede VPC de consumidor multicast. Exemplo: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Projeto O projeto que contém a rede VPC do consumidor de multicast. Exemplo: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Recurso A instância de VM do consumidor de multicast. Exemplo: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Projeto O projeto que contém a instância da VM do consumidor multicast. Isso pode ser diferente do projeto que contém a rede VPC do consumidor de multicast, como ao usar a VPC compartilhada. Exemplo: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription string Um dos eventos descritos em Eventos registrados. Exemplo: IGMP consumer joined.
eventTime string O carimbo de data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation string O nome da associação de consumidor multicast entre a rede VPC consumidora de multicast e o domínio. Exemplo: my-consumer-association-name.
multicastGroupConsumerActivation string O nome da ativação do consumidor do grupo multicast. Exemplo: my-group-consumer-activation-name.
multicastIp string O endereço IP do grupo multicast. Exemplo: 224.0.0.1.

Ao contrário dos registros de intervalo do grupo multicast, os registros de ativação do consumidor do grupo multicast usam IDs de string para o projeto e a rede porque os registros estão disponíveis apenas para o projeto que contém os recursos do consumidor multicast.

Referência de formato de campo

Projeto

Campo Tipo Descrição
number string (uint64) O ID inteiro gerado automaticamente do projeto. Exemplo: 5678.
id string O ID atribuído pelo usuário do projeto. Exemplo: my-project.

Recurso

Campo Tipo Descrição
id string (uint64) O ID inteiro gerado automaticamente do recurso. Exemplo: 1111.
name string O nome atribuído pelo usuário ao recurso. Exemplo: my-instance.

Ativar o registro de eventos de associação a grupos

As seções a seguir descrevem como ativar o registro de eventos de associação a grupos para um intervalo de grupos multicast ou uma rede VPC específica de consumidores multicast.

Ativar o registro em um intervalo de grupo multicast

Nesta seção, descrevemos como um administrador de multicast pode configurar o registro de eventos de associação a grupos para um intervalo de grupos de multicast atual.

Para mais informações sobre como configurar a geração de registros ao criar um novo intervalo de grupos de multicast, consulte Criar intervalos de grupos de multicast. O registro de eventos de associação não está ativado por padrão.

É possível configurar o registro de eventos de associação nos seguintes recursos:

  • Intervalo de grupo multicast:a configuração de geração de registros de um intervalo de grupo global se aplica a todas as ativações do intervalo.
  • Ativação do intervalo do grupo multicast:a configuração de geração de registros de uma ativação de intervalo de grupo zonal substitui a configuração global de intervalo de grupo.

gcloud

  • Para ativar ou desativar a geração de registros para um intervalo de grupo multicast, use o comando network-services multicast-group-ranges update.

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

    Substitua:

    • GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast.
    • --[no-]enable-logging: determina se a geração de registros de eventos de associação está ativada.
      • Para ativar o registro, use --enable-logging.
      • Para desativar a geração de registros, use --no-enable-logging.

  • Para ativar ou desativar a geração de registros para uma ativação de intervalo de grupo multicast, use o 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]

    Substitua:

    • GROUP_RANGE_ACTIVATION_NAME: o nome da ativação do intervalo do grupo de multicast.
    • ZONE: a zona da ativação do intervalo do grupo multicast.
    • --[no-]enable-logging: determina se a geração de registros de eventos de associação está ativada.
      • Para ativar o registro, use --enable-logging.
      • Para desativar a geração de registros, use --no-enable-logging.

API

  • Para ativar ou desativar o registro em um intervalo de grupo multicast, use o método multicastGroupRanges.patch.

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

    Substitua:

    • PROJECT_ID: o ID do projeto
    • GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast.
    • LOGGING_ENABLED: especifica se a geração de registros de eventos de assinatura está ativada.
      • Para ativar a geração de registros, defina como true.
      • Para desativar a geração de registros, defina como false.

  • Para ativar ou desativar a geração de registros para uma ativação de intervalo de grupo multicast, use o método multicastGroupRangeActivations.patch.

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

    Substitua:

    • PROJECT_ID: o ID do projeto
    • GROUP_RANGE_ACTIVATION_NAME: o nome da ativação do intervalo do grupo de multicast.
    • ZONE: a zona da ativação do intervalo do grupo multicast.
    • LOGGING_ENABLED: especifica se a geração de registros de eventos de assinatura está ativada.
      • Para ativar a geração de registros, defina como true.
      • Para desativar a geração de registros, defina como false.

Ativar a geração de registros para uma ativação do consumidor do grupo multicast

Nesta seção, descrevemos como um administrador de rede de consumidor multicast pode configurar o registro de eventos de associação a grupos para a rede VPC.

Para uma determinada rede VPC que você ativou para consumir tráfego multicast, é possível configurar o registro de eventos de associação na ativação do consumidor do grupo multicast correspondente.

Para mais informações sobre como configurar a geração de registros ao criar uma nova ativação de consumidor de grupo multicast, consulte Ativar uma rede VPC para consumir tráfego multicast. O registro de eventos de associação não está ativado por padrão.

gcloud

Para ativar ou desativar a geração de registros para uma ativação do consumidor de grupo multicast, use o 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]

Substitua:

  • GROUP_CONSUMER_ACTIVATION_NAME: o nome da ativação do consumidor do grupo multicast
  • ZONE: a zona da ativação do consumidor do grupo multicast.
  • --[no-]enable-logging: determina se a geração de registros de eventos de associação está ativada.
    • Para ativar o registro, use --enable-logging.
    • Para desativar a geração de registros, use --no-enable-logging.

API

Para ativar ou desativar o registro em uma ativação do consumidor do grupo multicast, use o método multicastGroupConsumerActivations.patch.

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

Substitua:

  • PROJECT_ID: o ID do projeto
  • GROUP_CONSUMER_ACTIVATION_NAME: o nome da ativação do consumidor do grupo multicast
  • ZONE: a zona da ativação do consumidor do grupo multicast.
  • LOGGING_ENABLED: especifica se a geração de registros de eventos de assinatura está ativada.
    • Para ativar a geração de registros, defina como true.
    • Para desativar a geração de registros, defina como false.

Conferir registros de eventos de associação a grupos

Nesta seção, descrevemos como visualizar os registros de eventos de associação a grupos para multicast.

Para mais informações, consulte a visão geral do Explorador de registros.

Console

  1. No console do Google Cloud , acesse a página Análise de registros.

    Acessar a Análise de registros

  2. Para ver os registros de eventos de associação a grupos de multicast, selecione um dos seguintes tipos de recursos monitorados na lista Todos os recursos:

    • Se você for um administrador de multicast e quiser ver os registros de eventos de associação a grupos de todos os consumidores de multicast em um grupo, selecione Intervalo de grupo multicast.
    • Se você for um administrador de rede VPC consumidora de multicast e quiser ver os registros de eventos de associação a grupos da sua rede, selecione Ativação do consumidor do grupo multicast.

A seguir