Ver registros de eventos de participação em grupos para multicast ULL

GA com lista de permissões: a solução ULL está disponível apenas para operadores de câmbio aprovados e participantes de câmbio. Se você for um participante de câmbio aprovado, entre em contato com [e-mail] para solicitar acesso.

Esta página fornece informações sobre os registros disponíveis para monitorar eventos de participação em grupos multicast, como associaçõ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 de multicast entrou e saiu ou quantos consumidores de multicast estão em um grupo.

Sobre os logs de eventos de associação ao grupo

Google Cloud grava logs de eventos de associação ao grupo 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 de registro, consulte as seções a seguir.

Recurso

Descrição dos registros

Ativação do consumidor do grupo multicast

Logs de eventos de associação ao grupo para consumidores de multicast em uma rede VPC de consumidor de multicast específica ativada para um intervalo e zona de grupo. Esses registros estão disponíveis em projetos que contêm configurações de consumidor de multicast e a rede de consumidor de multicast correspondente. Se você estiver usando a VPC compartilhada, esse será o projeto host. Consulte Ativar a geração de registros para um consumidor de grupo multicast ativação.

Eventos registrados

Esta seção descreve os eventos de associação ao grupo que são registrados para multicast no Cloud Logging.

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

• Uma associação IGMP bem-sucedida resulta em duas mensagens de registro: uma mensagem IGMP join request received seguida de IGMP consumer joined.
• Para um consumidor de multicast que já se associou a um grupo, uma solicitação de associação IGMP keepalive em uma única IGMP join request received mensagem.

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

Evento	Descrição
IGMP join request received	O Google Cloud plano de controle recebeu a solicitação de associação. Essa mensagem não confirma se a associação foi concluída. Cada solicitação de associação é registrada, incluindo solicitações keepalive que os consumidores de multicast enviam periodicamente como parte do protocolo IGMP.
IGMP consumer joined	O Google Cloud plano de controle adicionou o consumidor de multicast ao grupo. Depois que esse evento for propagado para a infraestrutura de multicast do domínio, o consumidor de multicast começará a receber tráfego de multicast. Esse evento é sempre precedido por um evento IGMP join request received.
IGMP consumer left	O Google Cloud plano de controle recebeu uma solicitação de saída IGMP explícita do consumidor de multicast e aplicou a solicitação.
IGMP consumer timed out	O Google Cloud plano de controle removeu o consumidor de multicast do grupo porque ele parou de responder com solicitações keepalive.
IGMP entitlement rejected	O Google Cloud plano de controle recebeu a solicitação de associação, mas a rejeitou porque a configuração necessária do consumidor de multicast não está concluída, como nos casos a seguir: 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.

Formato de registro para ativações do consumidor do grupo multicast

Esta seção descreve o formato dos logs de eventos de associação ao grupo que estão disponíveis em projetos que contêm configurações de consumidor de multicast.

Esses registros são gravados para eventos de participação de consumidores de multicast em uma determinada rede VPC ativada para um intervalo e zona de grupo multicast. É possível 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 do consumidor de 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 de VM do consumidor de 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 do consumidor de multicast entre a rede VPC do consumidor 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 de 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 só estão disponíveis para o projeto que contém as configurações do consumidor de 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 do recurso. Exemplo: my-instance.

Ativar a geração de registros de eventos de associação ao grupo

As seções a seguir descrevem como ativar a geração de registros de eventos de associação ao grupo.

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

Esta seção descreve como um administrador de rede de consumidor de multicast pode configurar a geração de registros de eventos de associação ao grupo para a rede VPC.

Para uma determinada rede VPC ativada para consumir tráfego de multicast, é possível configurar a geração de registros de eventos de participaçã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 do consumidor do grupo multicast, consulte Ativar uma rede VPC para consumir tráfego de multicast. A geração de registros de eventos de participação não é ativada por padrão.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as permissões ou um dos papéis de IAM a seguir.

Permissões

• networkservices.multicastGroupConsumerActivations.update

Papéis

• Administrador de multicast (roles/compute.multicastAdmin)

gcloud

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

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 participação está ativada.
  • Para ativar a geração de registros, use --enable-logging.
  • Para desativar a geração de registros, use --no-enable-logging.

API

Para ativar ou desativar a geração de registros para uma ativação do consumidor do grupo multicast, use o multicastGroupConsumerActivations.patch método.

  PATCH https://networkservices.googleapis.com/v1/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 participação está ativada.
  • Para ativar a geração de registros, defina como true.
  • Para desativar a geração de registros, defina como false.

Ver registros de eventos de participação em grupos

Esta seção descreve como visualizar registros de eventos de participação em grupos para multicast.

Para mais informações, consulte a Visão geral da Análise 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 conferir os registros de eventos de participação em grupos multicast, selecione um dos seguintes tipos de recursos monitorados na lista Todos os recursos :
   • Se você for um administrador da rede VPC de consumidor de multicast e quiser conferir os logs de eventos de associação ao grupo da sua rede, selecione Ativação do consumidor do grupo multicast.