Visualiza los registros de eventos de membresía de grupos de transmisión por multidifusión

En esta página, se proporciona información sobre los registros disponibles para supervisar los eventos de membresía de grupos de multidifusión, como las uniones de IGMP, y se describe cómo habilitarlos y verlos.

Puedes usar estos registros para comprender la actividad en un grupo de transmisión por multidifusión, por ejemplo, cuándo se unió un consumidor de multidifusión y cuándo se fue, o cuántos consumidores de multidifusión hay en un grupo.

Acerca de los registros de eventos de membresía de grupos

Google Cloud escribe registros de eventos de membresía de grupo para la transmisión de multidifusión en Cloud Logging.

En esta tabla, se proporciona un resumen de los registros disponibles para cada tipo de recurso, incluido el proyecto que recibe los 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
Rango de grupos multicast

Registros de eventos de membresía de grupo para todos los consumidores de multicast de un rango de grupos.

Estos registros solo están disponibles en los proyectos de administrador de transmisión multidifusión.

Puedes configurar el registro en un rango de grupos de multicast global y en una activación de rango de grupos de multicast zonal. Consulta Habilita el registro para un rango de grupos de transmisión simultánea.
Activación del consumidor del grupo de multicast

Registros de eventos de membresía de grupos para consumidores de multicast en una red de VPC de consumidor de multicast específica que está activada para un rango de grupos y una zona.

Estos registros están disponibles en los proyectos que contienen recursos de consumidor de multidifusión, que pueden ser el proyecto de administrador de multidifusión o un proyecto de consumidor de multidifusión independiente, según la topología del dominio de multidifusión.

Consulta Cómo habilitar el registro para una activación del consumidor de grupos multicast.

Eventos registrados

En esta sección, se describen los eventos de membresía de grupo que se registran para la transmisión por multidifusión en Cloud Logging.

Cuando un consumidor de transmisión por multidifusión 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 IGMP exitosa genera dos mensajes de registro: un mensaje IGMP join request received seguido de IGMP consumer joined.
  • Una unión a IGMP fallida genera dos mensajes de registro: un mensaje IGMP join request received seguido de IGMP join request rejected due to *.
  • En el caso de un consumidor de transmisión a varios destinos que ya se unió a un grupo correctamente, una solicitud de unión IGMP de keepalive genera un solo mensaje IGMP join request received.

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

Evento Descripción
IGMP join request received

El plano de control Google Cloud recibió la solicitud de unión. Este mensaje no confirma que la unión se haya completado correctamente.

Se registra cada solicitud de unión, incluidas las solicitudes de keepalive que los consumidores de multidifusión envían periódicamente como parte del protocolo IGMP.
IGMP consumer joined

El plano de control de Google Cloud agregó correctamente el consumidor de multidifusión al grupo. Después de que este evento se propaga a la infraestructura de multicast del 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 plano de control de Google Cloud recibió una solicitud explícita de IGMP leave del consumidor de multidifusión y la aplicó.
IGMP consumer timed out

El plano de control Google Cloud quitó el consumidor de multicast del grupo porque dejó de responder con solicitudes de keepalive.
Consumer removed due to configuration change

El plano de control Google Cloud quitó el consumidor de multicast del grupo porque se borró el extremo del consumidor. Por ejemplo, es posible que se haya borrado la instancia o el proyecto del consumidor.
IGMP join request rejected due to full tree

El plano de control de Google Cloud recibió la solicitud de unión, pero la rechazó porque el grupo de multidifusión ya está al máximo de su capacidad.
IGMP join request rejected due to missing quota

El plano de control Google Cloud recibió la solicitud de unión, pero la rechazó porque la red de VPC del consumidor de multicast ya está usando toda su cuota para las VMs del consumidor de multicast por red de VPC.
IGMP join request rejected due to unknown reason

El plano de control de Google Cloud recibió la solicitud de unión, pero la rechazó debido a una falla que no tiene un motivo específico.
IGMP entitlement rejected

El plano de control de Google Cloud recibió la solicitud de unión, pero la rechazó porque no se completó la configuración del consumidor de multidifusión requerida, 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 del dominio.
  • El consumidor de multicast no está configurado para IGMP.

Este evento solo está disponible en los registros del recurso de activación del consumidor del grupo de multicast.
Consumer network activated

Se activó una red de VPC del consumidor de multicast para un rango de grupos de multicast. Esto corresponde a la creación de un recurso de activación del consumidor de grupos de multicast.

Este evento solo está disponible para los administradores de transmisiones simultáneas en los registros de los recursos de rangos de grupos de transmisiones simultáneas.
Consumer network deactivated

Se desactivó una red de VPC del consumidor de multicast para un rango de grupos de multicast. Esto significa que se borró un recurso de activación del consumidor del grupo de multicast o que su estado cambió a INACTIVE.

Este evento solo está disponible para los administradores de transmisiones simultáneas en los registros de los recursos de rangos de grupos de transmisiones simultáneas.

Formato de registro para rangos de grupos de transmisión a múltiples destinos

En esta sección, se describe el formato de los registros de eventos de membresía de grupos que están disponibles en el proyecto del administrador de multicast que contiene recursos de dominio y rango de grupos multicast.

Estos registros se escriben para los eventos de membresía de todos los consumidores de multicast de un rango de grupos de multicast determinado. Puedes configurar el registro en los recursos de activación del rango de grupos multicast global y del rango de grupos multicast zonales, como se describe en Habilita el registro para un rango de grupos multicast.

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

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

El formato del registro varía según el tipo de evento registrado. Consulta las tablas en cada una de las siguientes pestañas para obtener más detalles.

Evento de IGMP

Si el evento registrado es un evento de IGMP, el registro incluye los siguientes campos:

Campo Tipo Descripción
consumerIp cadena Es la dirección IPv4 interna principal del consumidor de multidifusión. Ejemplo: 10.0.0.1.
consumerLocation cadena Es la zona de la VPC del consumidor de multicast. Ejemplo: us-east5-a.
consumerNetwork Recurso Es la red de VPC del consumidor de multicast. Solo se propaga el ID de número entero. Ejemplo: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Proyecto Es el proyecto que contiene la red de VPC del consumidor de multicast. Solo se completa el número de proyecto. Ejemplo: 
      consumerProject {
       number: "5678"
      }
consumerResource Recurso Es la instancia de VM del consumidor de multicast. Solo se propaga el ID de número entero. Ejemplo: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Proyecto Es el proyecto que contiene la instancia de VM del consumidor de transmisión por multidifusión. Puede ser diferente del proyecto que contiene la red de VPC del consumidor de multidifusión, como cuando se usa la VPC compartida. Solo se completa el número de proyecto. Ejemplo: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription cadena Es uno de los eventos que se describen en Eventos registrados. Ejemplo: IGMP consumer joined.
eventTime cadena Es la marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain cadena Es el nombre del dominio de transmisión por multidifusión. Ejemplo: my-domain-name.
multicastGroupRange cadena Es el nombre del rango del grupo de multicast. Ejemplo: my-group-range-name.
multicastIp cadena Es la dirección IP del grupo de transmisión por multidifusión. Ejemplo: 224.0.0.1.

Activación o desactivación

Si el evento registrado es la activación o desactivación de una red de VPC del consumidor de multicast, el registro incluye los siguientes campos:

Campo Tipo Descripción
consumerLocation cadena Es la zona en la que se activó la red de VPC del consumidor de multicast. Ejemplo: us-east5-a.
consumerNetwork Recurso Es la red de VPC del consumidor de multicast. Solo se propaga el ID de número entero. Ejemplo: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Proyecto Es el proyecto que contiene la red de VPC del consumidor de multicast. Solo se propaga el número de proyecto. Ejemplo: 
      consumerProject {
       number: "5678"
      }
eventDescription cadena Es uno de los eventos que se describen en Eventos registrados. Ejemplo: Consumer network activated.
eventTime cadena Es la marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain cadena Es el nombre del dominio de transmisión por multidifusión. Ejemplo: my-domain-name.
multicastGroupRange cadena Es el nombre del rango del grupo de multicast. Ejemplo: my-group-range-name

Los IDs de números enteros se usan para los recursos de los consumidores de multicast, como proyectos, redes e instancias, para mantener la privacidad.

Formato de registro para las activaciones de consumidores de grupos multicast

En esta sección, se describe el formato de los registros de eventos de membresía de grupos que están disponibles en los proyectos que contienen recursos de consumidores de transmisiones de multicast. El proyecto puede ser el proyecto de administrador de multidifusión o un proyecto de consumidor de multidifusión independiente, según la topología del dominio de multidifusión.

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

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

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

El registro incluye los siguientes campos:

Campo Tipo Descripción
consumerIp cadena Es la dirección IPv4 interna principal del consumidor de multidifusión. Ejemplo: 10.0.0.1.
consumerLocation cadena Es la zona del consumidor de multicast. Ejemplo: us-east5-a.
consumerNetwork Recurso Es la red de VPC del consumidor de multicast. Ejemplo: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Proyecto Es el proyecto que contiene la red de VPC del consumidor de multicast. Ejemplo: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Recurso Es la instancia de VM del consumidor de multicast. Ejemplo: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Proyecto Es el proyecto que contiene la instancia de VM del consumidor de transmisión por multidifusión. Puede ser diferente del proyecto que contiene la red de VPC del consumidor de multidifusión, como cuando se usa la VPC compartida. Ejemplo: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription cadena Es uno de los eventos que se describen en Eventos registrados. Ejemplo: IGMP consumer joined.
eventTime cadena Es la marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation cadena Es 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 cadena Es el nombre de la activación del consumidor del grupo de multicast. Ejemplo: my-group-consumer-activation-name.
multicastIp cadena Es la dirección IP del grupo de transmisión por multidifusión. Ejemplo: 224.0.0.1.

A diferencia de los registros de rangos de grupos de multicast, los registros de activación de consumidores de grupos de multicast usan IDs de cadena para el proyecto y la red, ya que los registros solo están disponibles para el proyecto que contiene los recursos de consumidores de multicast.

Referencia del formato de campo

Proyecto

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

Recurso

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

Habilita el registro de eventos de membresía de grupo

En las siguientes secciones, se describe cómo habilitar el registro de eventos de membresía de grupos para un rango de grupos de multidifusión o una red de VPC de consumidor de multidifusión específica.

Habilita el registro para un rango de grupos de multidifusión

En esta sección, se describe cómo un administrador de transmisión multidifusión puede configurar el registro de eventos de membresía de grupo para un rango de grupos de transmisión multidifusión existente.

Para obtener más información sobre cómo configurar el registro cuando creas un rango de grupos de multidifusión nuevo, consulta Crea rangos de grupos de multidifusión. El registro de eventos de membresía no está habilitado de forma predeterminada.

Puedes configurar el registro de eventos de membresía en los siguientes recursos:

  • Rango de grupos de multicast: La configuración de registro de un rango de grupos global se aplica a todas las activaciones del rango de grupos.
  • Activación de rango de grupos de multicast: La configuración de registro de una activación de rango de grupos zonales anula la configuración global de rango de grupos.

gcloud

  • Para habilitar o inhabilitar el registro de un rango de grupos de multidifusión, usa el comando network-services multicast-group-ranges update.

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

    Reemplaza lo siguiente:

    • GROUP_RANGE_NAME: Es el nombre del rango del grupo de multidifusión.
    • --[no-]enable-logging: Determina si el registro de eventos de membresía está habilitado.
      • Para habilitar el registro, usa --enable-logging.
      • Para inhabilitar el registro, usa --no-enable-logging.

  • Para habilitar o inhabilitar el registro de una activación de rango del grupo de multicast, usa el 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]

    Reemplaza lo siguiente:

    • GROUP_RANGE_ACTIVATION_NAME: Es el nombre de la activación del rango del grupo de multidifusión.
    • ZONE: Es la zona de la activación del rango de grupos de transmisión simultánea.
    • --[no-]enable-logging: Determina si el registro de eventos de membresía está habilitado.
      • Para habilitar el registro, usa --enable-logging.
      • Para inhabilitar el registro, usa --no-enable-logging.

API

  • Para habilitar o inhabilitar el registro de un rango de grupos de transmisión simultánea, usa el 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"}
}

    Reemplaza lo siguiente:

    • PROJECT_ID: ID del proyecto
    • GROUP_RANGE_NAME: Es el nombre del rango del grupo de multidifusión.
    • LOGGING_ENABLED: Especifica si el registro de eventos de membresía está habilitado.
      • Para habilitar el registro, establece el valor en true.
      • Para inhabilitar el registro, establece el valor en false.

  • Para habilitar o inhabilitar el registro de una activación de rango del grupo de multicast, usa el 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"}
}

    Reemplaza lo siguiente:

    • PROJECT_ID: ID del proyecto
    • GROUP_RANGE_ACTIVATION_NAME: Es el nombre de la activación del rango del grupo de multidifusión.
    • ZONE: Es la zona de la activación del rango de grupos de transmisión simultánea.
    • LOGGING_ENABLED: Especifica si el registro de eventos de membresía está habilitado.
      • Para habilitar el registro, establece el valor en true.
      • Para inhabilitar el registro, establece el valor en false.

Habilita el registro para una activación del 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 membresía de 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 del consumidor del grupo de multicast correspondiente.

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

gcloud

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

Reemplaza lo siguiente:

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

API

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

Reemplaza lo siguiente:

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

Cómo ver los registros de eventos de membresía de grupos

En esta sección, se describe cómo ver los registros de eventos de membresía de grupos para la transmisión de multidifusión.

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

Console

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

    Ve al Explorador de registros

  2. Para ver los registros de eventos de membresía de grupos de multidifusión, selecciona uno de los siguientes tipos de recurso supervisado en la lista Todos los recursos:

    • Si eres administrador de multicast y quieres ver los registros de eventos de membresía del grupo para todos los consumidores de multicast en un grupo, selecciona Rango de grupos de multicast.
    • Si eres administrador de una red de VPC de consumidor de multicast y deseas ver los registros de eventos de membresía de grupo de tu red, selecciona Activación del consumidor del grupo de multicast.

¿Qué sigue?