Veja registos de eventos de registo de membro do grupo de multicast

Esta página fornece informações sobre os registos disponíveis para monitorizar eventos de associação a grupos de multicast, como associações IGMP, e descreve como ativá-los e vê-los.

Pode usar estes registos para ajudar a compreender a atividade num grupo de multicast, como quando um consumidor de multicast aderiu e quando saiu, ou quantos consumidores de multicast estão num grupo.

Acerca dos registos de eventos de subscrição de grupos

Google Cloud Escreve registos de eventos de subscrição de grupos para multicast para o Cloud Logging.

Esta tabela fornece um resumo dos registos disponíveis para cada tipo de recurso, incluindo o projeto que recebe os registos. Para mais informações acerca dos eventos registados e do formato do registo, consulte as secções seguintes.

Recurso Descrição dos registos
Intervalo de grupos multicast

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

Estes registos só estão disponíveis em projetos de administrador de multicast.

Pode configurar o registo num intervalo de grupos de multicast global e numa ativação de intervalo de grupos de multicast zonal. Consulte o artigo Ative o registo para um intervalo de grupos de multicast.
Ativação de consumidores de grupos de multicast

Registos de eventos de associação a grupos para consumidores de multicast numa rede VPC de consumidores de multicast específica ativada para um intervalo de grupos e uma zona.

Estes registos 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, consoante a topologia do domínio de multicast.

Consulte o artigo Ative o registo para uma ativação de consumidor de grupo de multicast.

Eventos registados

Esta secção descreve os eventos de associação a grupos que são registados para multicast no Cloud Logging.

Quando um consumidor de multicast envia um relatório de associação IGMP para aderir a um grupo, as mensagens de registo resultantes são as seguintes:

  • Uma associação IGMP bem-sucedida resulta em duas mensagens de registo: uma mensagem IGMP join request received seguida de IGMP consumer joined.
  • Uma associação IGMP com falha resulta em duas mensagens de registo: uma mensagem IGMP join request received seguida de IGMP join request rejected due to *.
  • Para um consumidor de multicast que já tenha aderido a um grupo com êxito, um pedido de adesão IGMP de keepalive resulta numa única mensagem IGMP join request received.

Para ver uma lista completa dos eventos registados e as respetivas descrições, consulte a tabela seguinte.

Evento Descrição
IGMP join request received

O Google Cloud plano de controlo recebeu o pedido de adesão. Esta mensagem não confirma que a associação foi concluída com êxito.

Cada pedido de associação é registado, incluindo os pedidos de manutenção em funcionamento que os consumidores de multicast enviam periodicamente como parte do protocolo IGMP.
IGMP consumer joined

O Google Cloud plano de controlo adicionou com êxito o consumidor de multicast ao grupo. Depois de este evento ser propagado para a infraestrutura de multicast do domínio, o consumidor de multicast começa a receber tráfego de multicast.

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

O plano de controlo Google Cloud recebeu um pedido de saída de IGMP explícito do consumidor de multicast e aplicou o pedido.
IGMP consumer timed out

O Google Cloud plano de controlo removeu o consumidor de multicast do grupo porque o consumidor de multicast deixou de responder com pedidos de manutenção.
Consumer removed due to configuration change

O plano de controlo Google Cloud removeu o consumidor de multicast do grupo porque o ponto final do consumidor foi eliminado. Por exemplo, a instância ou o projeto do consumidor podem ter sido eliminados.
IGMP join request rejected due to full tree

O Google Cloud plano de controlo recebeu o pedido de adesão, mas rejeitou-o porque o grupo de multicast já está na capacidade máxima.
IGMP join request rejected due to missing quota

O Google Cloud plano de controlo recebeu o pedido de associação, mas rejeitou o pedido porque a rede VPC do consumidor de multicast já está a usar toda a sua quota de VMs do consumidor de multicast por rede VPC.
IGMP join request rejected due to unknown reason

O Google Cloud plano de controlo recebeu o pedido de associação, mas rejeitou o pedido devido a uma falha que não tem um motivo dedicado.
IGMP entitlement rejected

O Google Cloud plano de controlo recebeu o pedido de associação, mas rejeitou o pedido porque a configuração do consumidor de multicast necessária não está concluída, 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.

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

Foi ativada uma rede VPC de consumidor de multicast para um intervalo de grupos de multicast. Isto corresponde à criação de um recurso de ativação de consumidor de grupo de multicast.

Este evento só está disponível para administradores de multicast nos registos para recursos de intervalo de grupos de multicast.
Consumer network deactivated

Uma rede VPC de consumidor de multicast foi desativada para um intervalo de grupos de multicast. Isto significa que um recurso de ativação do consumidor do grupo de multicast foi eliminado ou o respetivo estado foi alterado para INACTIVE.

Este evento só está disponível para administradores de multicast nos registos para recursos de intervalo de grupos de multicast.

Formato de registo para intervalos de grupos multicast

Esta secção descreve o formato dos registos de eventos de associação a grupos que estão disponíveis no projeto de administrador de multicast que contém recursos de domínio e intervalo de grupos de multicast.

Estes registos são escritos para eventos de associação para todos os consumidores de multicast de um determinado intervalo de grupos de multicast. Pode configurar o registo em recursos de ativação do intervalo de grupos de multicast global e do intervalo de grupos de multicast zonal, conforme descrito em Ative o registo para um intervalo de grupos de multicast.

O tipo de recurso monitorizado e o nome do registo do Cloud Logging são os seguintes:

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

O formato do registo é diferente consoante o tipo de evento registado. Consulte as tabelas em cada um dos seguintes separadores para ver detalhes.

Evento IGMP

Se o evento registado for um evento IGMP, o registo inclui os seguintes campos:

Campo Tipo Descrição
consumerIp de string O endereço IPv4 interno principal do consumidor de multicast. Exemplo: 10.0.0.1.
consumerLocation de string A zona da VPC do consumidor de 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 de VM do consumidor de multicast. Este pode ser diferente do projeto que contém a rede VPC do consumidor de multicast, como quando usa a VPC partilhada. Apenas o número do projeto é preenchido. Exemplo: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription de string Um dos eventos descritos em Eventos registados. Exemplo: IGMP consumer joined.
eventTime de string A data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain de string O nome do domínio multicast. Exemplo: my-domain-name.
multicastGroupRange de string O nome do intervalo de grupos multicast. Exemplo: my-group-range-name.
multicastIp de string O endereço IP do grupo de multicast. Exemplo: 224.0.0.1.

Ativação/desativação

Se o evento registado for uma ativação ou uma desativação da rede VPC do consumidor de multicast, o registo inclui os seguintes campos:

Campo Tipo Descrição
consumerLocation de string A zona na qual a rede VPC do consumidor de 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 de string Um dos eventos descritos em Eventos registados. Exemplo: Consumer network activated.
eventTime de string A data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain de string O nome do domínio multicast. Exemplo: my-domain-name.
multicastGroupRange de string O nome do intervalo de grupos multicast. Exemplo: my-group-range-name

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

Formato do registo para ativações de consumidores de grupos de multicast

Esta secção descreve o formato dos registos de eventos de inscrição em grupos que estão disponíveis em projetos que contêm recursos de consumidor de multicast. O projeto pode ser o projeto de administrador de multicast ou um projeto de consumidor de multicast separado, consoante a topologia do domínio de multicast.

Estes registos são escritos para eventos de associação para consumidores de multicast numa determinada rede VPC que está ativada para um intervalo de grupos de multicast e uma zona. Pode configurar o registo no recurso de ativação do consumidor do grupo de multicasto zonal, conforme descrito em Ative o registo para uma ativação do consumidor do grupo de multicasto.

O tipo de recurso monitorizado e o nome do registo do Cloud Logging são os seguintes:

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

O registo inclui os seguintes campos:

Campo Tipo Descrição
consumerIp de string O endereço IPv4 interno principal do consumidor de multicast. Exemplo: 10.0.0.1.
consumerLocation de 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. Este pode ser diferente do projeto que contém a rede VPC do consumidor de multicast, como quando usa a VPC partilhada. Exemplo: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription de string Um dos eventos descritos em Eventos registados. Exemplo: IGMP consumer joined.
eventTime de string A data/hora do evento no formato de texto RFC 3339. Exemplo: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation de string O nome da associação de consumidor multicast entre a rede VPC do consumidor multicast e o domínio. Exemplo: my-consumer-association-name.
multicastGroupConsumerActivation de string O nome da ativação do consumidor do grupo de multicast. Exemplo: my-group-consumer-activation-name.
multicastIp de string O endereço IP do grupo de multicast. Exemplo: 224.0.0.1.

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

Referência do formato dos campos

Projeto

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

Recurso

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

Ative o registo de eventos de associação a grupos

As secções seguintes descrevem como ativar o registo de eventos de associação a grupos para um intervalo de grupos de multicast ou uma rede VPC de consumidor de multicast específica.

Ative o registo para um intervalo de grupos de multicast

Esta secção descreve como um administrador de multicast pode configurar o registo de eventos de associação a grupos para um intervalo de grupos de multicast existente.

Para mais informações sobre a configuração do registo quando cria um novo intervalo de grupos de multicast, consulte o artigo Crie intervalos de grupos de multicast. O registo de eventos de associação não está ativado por predefinição.

Pode configurar o registo de eventos de subscrição nos seguintes recursos:

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

gcloud

  • Para ativar ou desativar o registo para um intervalo de grupos de 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 o seguinte:

    • GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
    • --[no-]enable-logging: determina se o registo de eventos de subscrição está ativado.
      • Para ativar o registo, use --enable-logging.
      • Para desativar o registo, use --no-enable-logging.

  • Para ativar ou desativar o registo para uma ativação de intervalo de grupo de 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 o seguinte:

    • GROUP_RANGE_ACTIVATION_NAME: o nome do grupo de multicast ativação do intervalo
    • ZONE: a zona de ativação do intervalo do grupo de multicast
    • --[no-]enable-logging: determina se o registo de eventos de subscrição está ativado.
      • Para ativar o registo, use --enable-logging.
      • Para desativar o registo, use --no-enable-logging.

API

  • Para ativar ou desativar o registo para um intervalo de grupos de 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 o seguinte:

    • PROJECT_ID: o ID do projeto
    • GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
    • LOGGING_ENABLED: especifica se o registo de eventos de apoio está ativado.
      • Para ativar o registo, defina como true.
      • Para desativar o registo, defina como false.

  • Para ativar ou desativar o registo para uma ativação de intervalo de grupo de 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 o seguinte:

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

Ative o registo para uma ativação de consumidor de grupo de multicast

Esta secção descreve como um administrador de rede de consumidor de multicast pode configurar o registo de eventos de associação a grupos para a respetiva rede VPC.

Para uma determinada rede VPC que ativou para consumir tráfego de multicast, pode configurar o registo de eventos de associação na ativação do consumidor do grupo de multicast correspondente.

Para mais informações sobre a configuração do registo quando cria uma nova ativação do consumidor do grupo de multicast, consulte o artigo Ative uma rede VPC para consumir tráfego de multicast. O registo de eventos de associação não está ativado por predefinição.

gcloud

Para ativar ou desativar o registo para uma ativação de consumidor de grupo de 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 o seguinte:

  • GROUP_CONSUMER_ACTIVATION_NAME: o nome do grupo de multicast ativação do consumidor
  • ZONE: a zona de ativação do consumidor do grupo de multicast
  • --[no-]enable-logging: determina se o registo de eventos de subscrição está ativado.
    • Para ativar o registo, use --enable-logging.
    • Para desativar o registo, use --no-enable-logging.

API

Para ativar ou desativar o registo para uma ativação de consumidor de grupo de 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 o seguinte:

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

Veja os registos de eventos de membro em grupos

Esta secção descreve como ver os registos de eventos de membros do grupo para multicast.

Para mais informações, consulte a Vista geral do Logs Explorer.

Consola

  1. Na Google Cloud consola, aceda à página Explorador de registos.

    Aceda ao Explorador de registos

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

    • Se for um administrador de multicast e quiser ver os registos de eventos de registo de membro do grupo para todos os consumidores de multicast num grupo, selecione Intervalo de grupos de multicast.
    • Se for um administrador de rede VPC de consumidor de multicast e quiser ver registos de eventos de registo de membro do grupo para a sua rede, selecione Ativação de consumidor de grupo de multicast.

O que se segue?