Visualiza los registros de eventos de pertenencia a un grupo para ULL Multicast

GA con lista de entidades permitidas: La solución ULL solo está disponible para los operadores de intercambio aprobados y sus participantes de intercambio. Si eres un participante de intercambio aprobado, comunícate con [e-mail] para solicitar acceso.

En esta página, se proporciona información sobre los registros que están disponibles para supervisar los eventos de pertenencia a un grupo multicast, como las uniones de IGMP, y se describe cómo habilitarlos y visualizarlos.

Puedes usar estos registros para comprender la actividad en un grupo multicast, como cuándo se unió y cuándo se fue un consumidor de multicast, o cuántos consumidores de multicast hay en un grupo.

Acerca de los registros de eventos de pertenencia a un grupo

Google Cloud escribe registros de eventos de pertenencia a un grupo para multicast en Cloud Logging.

En esta tabla, se proporciona un resumen de los registros que están disponibles para cada tipo de recurso, incluido el proyecto que recibe registros. Para obtener más información sobre los eventos que se registran y el formato de registro, consulta las siguientes secciones.

Recurso

Descripción de los registros

Activación de consumidores de grupos multicast

Registros de eventos de pertenencia a un grupo para consumidores de multicast en una red de VPC de consumidor de multicast específica que se activa para un rango y una zona de grupos. Estos registros están disponibles en proyectos que contienen configuraciones de consumidores de multicast y su red de consumidores de multicast correspondiente. Si usas una VPC compartida, este es el proyecto host. Consulta Habilita el registro para una activación de consumidor de grupos multicast activación.

Eventos registrados

En esta sección, se describen los eventos de pertenencia a un grupo que se registran para multicast en Cloud Logging.

Cuando un consumidor de multicast envía un informe de membresía de IGMP para unirse a un grupo, los mensajes de registro resultantes son los siguientes:

• Una unión de IGMP exitosa genera dos mensajes de registro: un mensaje IGMP join request received seguido de IGMP consumer joined.
• Para un consumidor de multicast que ya se unió a un grupo de forma correcta, una solicitud de unión de IGMP de keepalive en un solo IGMP join request received mensaje.

Para obtener una lista completa de los eventos registrados y sus descripciones, consulta la siguiente tabla.

Evento	Descripción
IGMP join request received	El Google Cloud plano de control recibió la solicitud de unión. Este mensaje no confirma que la unión se completó correctamente. Se registra cada solicitud de unión, incluidas las solicitudes de keepalive que los consumidores de multicast envían de forma periódica como parte del protocolo IGMP.
IGMP consumer joined	El Google Cloud plano de control agregó correctamente el consumidor de multicast al grupo. Después de que este evento se propaga a la infraestructura de multicast para el dominio, el consumidor de multicast comienza a recibir tráfico de multicast. Este evento siempre está precedido por un evento IGMP join request received.
IGMP consumer left	El Google Cloud plano de control recibió una solicitud de salida de IGMP explícita del consumidor de multicast y aplicó la solicitud.
IGMP consumer timed out	El Google Cloud plano de control quitó el consumidor de multicast de l grupo porque dejó de responder con solicitudes de keepalive.
IGMP entitlement rejected	El Google Cloud plano de control recibió la solicitud de unión, pero la rechazó porque no se completó la configuración requerida del consumidor de multicast como en los siguientes casos: No se completó la configuración de la red de VPC del consumidor de multicast. La configuración de la red de VPC del consumidor de multicast no se propagó a la infraestructura de multicast para el dominio. El consumidor de multicast no está configurado para IGMP. Este evento solo está disponible en los registros del recurso de activación de consumidor de grupos multicast

Formato de registro para activaciones de consumidores de grupos multicast

En esta sección, se describe el formato de los registros de eventos de pertenencia a un grupo que están disponibles en proyectos que contienen configuraciones de consumidores de multicast.

Estos registros se escriben para eventos de membresía de consumidores de multicast en una red de VPC determinada que se activa para un rango y una zona de grupos multicast. Puedes configurar el registro en el recurso de activación de consumidor de grupos multicast zonal como se describe en Habilita el registro para una activación de consumidor de grupos multicast.

El tipo de recurso supervisado y el nombre de registro de Cloud Logging son los siguientes:

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

El registro incluye los siguientes campos:

Campo	Tipo	Descripción
consumerIp	string	La dirección IPv4 interna principal del consumidor de multicast. Ejemplo: 10.0.0.1.
consumerLocation	string	La zona del consumidor de multicast. Ejemplo: us-east5-a.
consumerNetwork	Recurso	La red de VPC del consumidor de multicast. Ejemplo: consumerNetwork { name: "my-network" id: "1234" }
consumerProject	Proyecto	El proyecto que contiene la red de VPC del consumidor de multicast. Ejemplo: consumerProject { id: "my-project" number: "5678" }
consumerResource	Recurso	La instancia de VM del consumidor de multicast. Ejemplo: consumerResource { name: "my-instance" id: "1111" }
consumerResourceProject	Proyecto	El proyecto que contiene la instancia de VM del consumidor de multicast. Esto puede ser diferente del proyecto que contiene la red de VPC del consumidor de multicast como cuando se usa una VPC compartida. Ejemplo: consumerResourceProject { id: "my-instance-project" number: "4321" }
eventDescription	string	Uno de los eventos descritos en Eventos registrados. Ejemplo: IGMP consumer joined.
eventTime	string	La marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation	string	El nombre de la asociación del consumidor de multicast entre la red de VPC del consumidor de multicast y el dominio. Ejemplo: my-consumer-association-name.
multicastGroupConsumerActivation	string	El nombre de la activación de consumidor de grupos multicast. Ejemplo: my-group-consumer-activation-name.
multicastIp	string	La dirección IP del grupo multicast. Ejemplo: 224.0.0.1.

A diferencia de los registros de rango de grupos multicast, los registros de activación de consumidor de grupos multicast usan IDs de cadena para el proyecto y la red porque los registros solo están disponibles para el proyecto que contiene las configuraciones de consumidores de multicast.

Referencia del formato de campo

Proyecto

Campo	Tipo	Descripción
number	string (uint64)	El ID de número entero generado automáticamente del proyecto. Ejemplo: 5678.
id	string	El ID asignado por el usuario del proyecto. Ejemplo: my-project.

Recurso

Campo	Tipo	Descripción
id	string (uint64)	El ID de número entero generado automáticamente del recurso. Ejemplo: 1111.
name	string	El nombre asignado por el usuario del recurso. Ejemplo: my-instance.

Habilita el registro de eventos de pertenencia a un grupo

En las siguientes secciones, se describe cómo habilitar el registro de eventos de pertenencia a un grupo.

Habilita el registro para una activación de consumidor de grupos multicast

En esta sección, se describe cómo un administrador de red de consumidor de multicast puede configurar el registro de eventos de pertenencia a un grupo para su red de VPC.

Para una red de VPC determinada que habilitaste para consumir tráfico de multicast, puedes configurar el registro de eventos de membresía en la activación de consumidor de grupos multicast correspondiente.

Para obtener más información sobre cómo configurar el registro cuando creas una nueva activación de consumidor de grupos multicast, consulta Habilita una red de VPC para consumir tráfico de multicast. El registro de eventos de membresía no está habilitado de forma predeterminada.

Permisos necesarios para esta tarea

Para realizar esta tarea, debes tener los siguientes permisos o una de las siguientes funciones de IAM.

Permisos

• networkservices.multicastGroupConsumerActivations.update

Funciones

• Administrador de Multicast (roles/compute.multicastAdmin)

gcloud

Para habilitar o inhabilitar el registro para una activación de consumidor de grupos multicast, usa el 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]

Reemplaza lo siguiente:

• GROUP_CONSUMER_ACTIVATION_NAME: el nombre de la activación de consumidor de grupos multicast
• ZONE: la zona de la activación de consumidor de grupos multicast
• --[no-]enable-logging: determina si está habilitado el registro de eventos de membresía.
  • Para habilitar el registro, usa --enable-logging.
  • Para inhabilitar el registro, usa --no-enable-logging.

API

Para habilitar o inhabilitar el registro para una activación de consumidor de grupos multicast, usa el 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"}
  }

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto
• GROUP_CONSUMER_ACTIVATION_NAME: el nombre de la activación de consumidor de grupos multicast
• ZONE: la zona de la activación de consumidor de grupos multicast
• LOGGING_ENABLED: especifica si está habilitado el registro de eventos de membresía.
  • Para habilitar el registro, establece el valor en true.
  • Para inhabilitar el registro, establece el valor en false.

Visualiza los registros de eventos de pertenencia a un grupo

En esta sección, se describe cómo visualizar los registros de eventos de pertenencia a un grupo para multicast.

Para obtener más información, consulta la descripción general del Explorador de registros.

Console

1. En la Google Cloud consola de, ve a la página Explorador de registros.

   Ir al Explorador de registros

2. Para ver los registros de eventos de pertenencia a un grupo multicast, selecciona uno de los siguientes tipos de recurso supervisado de la lista Todos los recursos :
   • Si eres administrador de la red de VPC del consumidor de multicast y quieres ver los registros de eventos de pertenencia a un grupo de tu red, selecciona Activación de consumidor de grupos multicast.