Ver los registros de eventos de pertenencia a grupos de multidifusión

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

Puede usar estos registros para comprender la actividad de un grupo de multidifusión, como cuándo se ha unido y cuándo se ha ido un consumidor de multidifusión, o cuántos consumidores de multidifusión hay en un grupo.

Acerca de los registros de eventos de pertenencia a grupos

Google Cloud escribe registros de eventos de pertenencia a grupos para la multidifusión en Cloud Logging.

En esta tabla se ofrece 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
Intervalo de grupos de multidifusión

Registros de eventos de pertenencia a grupos de todos los consumidores de multidifusión de un intervalo de grupos.

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

Puede configurar el registro en un intervalo de grupos de multidifusión global y en un intervalo de grupos de multidifusión zonal. Consulta Habilitar el registro de un intervalo de grupos de multidifusión.
Activación de consumidores de grupos de multidifusión

Registros de eventos de pertenencia a grupos de consumidores de multidifusión en una red de VPC de consumidores de multidifusión específica que se ha activado para un intervalo y una zona de grupos.

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, en función de la topología del dominio de multidifusión.

Consulta Habilitar el registro de la activación de un consumidor de un grupo de multidifusión.

Eventos registrados

En esta sección se describen los eventos de pertenencia a grupos que se registran para la multidifusión en Cloud Logging.

Cuando un consumidor de multidifusión envía un informe de pertenencia a IGMP para unirse a un grupo, los mensajes de registro resultantes son los siguientes:

  • Si la unión a IGMP se realiza correctamente, se generan dos mensajes de registro: un mensaje IGMP join request received seguido de IGMP consumer joined.
  • Si falla una unión IGMP, se generarán 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 multidifusión que ya se haya unido a un grupo correctamente, una solicitud de unión IGMP keepalive da como resultado un solo mensaje IGMP join request received.

Para ver 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 ha recibido la solicitud de unión. Este mensaje no confirma que la unión se haya completado correctamente.

Cada solicitud de unión se registra, incluidas las solicitudes de mantenimiento activas que los consumidores de multidifusión envían periódicamente como parte del protocolo IGMP.
IGMP consumer joined

El plano de control ha añadido correctamente el consumidor de multidifusión al grupo. Google Cloud Una vez que este evento se haya propagado a la infraestructura de multidifusión del dominio, el consumidor de multidifusión empezará a recibir tráfico de multidifusión.

Este evento siempre va precedido de un evento IGMP join request received.
IGMP consumer left

El plano de control Google Cloud ha recibido una solicitud de salida IGMP explícita del consumidor de multicast y ha aplicado la solicitud.
IGMP consumer timed out

El plano de control ha quitado el consumidor de multidifusión del grupo porque ha dejado de responder a las solicitudes de mantenimiento activo. Google Cloud

Consumer removed due to configuration change

El plano de control de Google Cloud ha quitado el consumidor de multidifusión del grupo porque se ha eliminado el endpoint del consumidor. Por ejemplo, es posible que se haya eliminado la instancia o el proyecto de consumidor.
IGMP join request rejected due to full tree

El plano de control ha recibido la solicitud de unión, pero la ha rechazado porque el grupo de multidifusión ya está al máximo de su capacidad. Google Cloud

IGMP join request rejected due to missing quota

El Google Cloud plano de control ha recibido la solicitud de unión, pero la ha rechazado porque la red de VPC del consumidor de multidifusión ya está utilizando toda su cuota de VMs de consumidor de multidifusión por red de VPC.
IGMP join request rejected due to unknown reason

El Google Cloud plano de control ha recibido la solicitud de unión, pero la ha rechazado debido a un error que no tiene un motivo específico.
IGMP entitlement rejected

El Google Cloud plano de control ha recibido la solicitud de unión, pero la ha rechazado porque no se ha completado la configuración del consumidor de multidifusión necesaria, como en los siguientes casos:

  • La configuración de la red de VPC del consumidor de multidifusión no está completa.
  • La configuración de la red de VPC del consumidor de multidifusión no se ha propagado a la infraestructura de multidifusión del dominio.
  • El consumidor de multidifusión no está configurado para IGMP.

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

Se ha activado una red de VPC de consumidor de multidifusión para un intervalo de grupos de multidifusión. Esto corresponde a la creación de un recurso de activación de consumidor de grupo de multidifusión.

Este evento solo está disponible para los administradores de multidifusión en los registros de los recursos del intervalo de grupos de multidifusión.
Consumer network deactivated

Se ha desactivado una red de VPC de consumidor de multidifusión para un intervalo de grupos de multidifusión. Esto significa que se ha eliminado un recurso de activación de consumidor de grupo de multidifusión o que su estado ha cambiado a INACTIVE.

Este evento solo está disponible para los administradores de multidifusión en los registros de los recursos del intervalo de grupos de multidifusión.

Formato de registro de intervalos de grupos multicast

En esta sección se describe el formato de los registros de eventos de pertenencia a grupos que están disponibles en el proyecto de administrador de multidifusión que contiene recursos de dominio y de intervalo de grupos de multidifusión.

Estos registros se escriben para los eventos de pertenencia de todos los consumidores de multidifusión de un intervalo de grupos de multidifusión determinado. Puede configurar el registro en los recursos de activación del intervalo de grupos de multidifusión global y del intervalo de grupos de multidifusión zonal como se describe en Habilitar el registro de un intervalo de grupos de multidifusión.

El tipo de recurso monitorizado 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 en función del tipo de evento registrado. Para obtener más información, consulta las tablas de cada una de las siguientes pestañas.

Evento IGMP

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

Campo Tipo Descripción
consumerIp cadena La dirección IPv4 interna principal del consumidor de multicast. Ejemplo: 10.0.0.1
consumerLocation cadena La zona de la VPC de consumidor de multicast. Ejemplo: us-east5-a
consumerNetwork Recurso La red VPC del consumidor de multidifusión. Solo se rellena el ID entero. . Ejemplo: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Proyecto El proyecto que contiene la red de VPC del consumidor de multidifusión. Solo se rellena el número de proyecto. Ejemplo: 
      consumerProject {
       number: "5678"
      }
consumerResource Recurso La instancia de VM de consumidor de multidifusión. Solo se rellena el ID entero. Ejemplo: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Proyecto El proyecto que contiene la instancia de VM de consumidor de multidifusión. Puede ser diferente del proyecto que contiene la red de VPC del consumidor de multidifusión, como cuando se usa una VPC compartida. Solo se rellena el número de proyecto. Ejemplo: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription cadena Uno de los eventos descritos en Eventos registrados. Ejemplo: IGMP consumer joined.
eventTime cadena Marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastDomain cadena Nombre del dominio multicast. Ejemplo: my-domain-name
multicastGroupRange cadena El nombre del intervalo de grupos de multidifusión. Ejemplo: my-group-range-name
multicastIp cadena La dirección IP del grupo de 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 de consumidor de multidifusión, el registro incluye los siguientes campos:

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

Se usan IDs de números enteros para los recursos de los consumidores de multidifusión, como proyectos, redes e instancias, para mantener la privacidad.

Formato de registro de las activaciones de consumidores de grupos de multidifusión

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

Estos registros se escriben para los eventos de pertenencia de los consumidores de multidifusión en una red de VPC determinada que se activa para un intervalo y una zona de grupo de multidifusión. Puedes configurar el registro en el recurso de activación del consumidor del grupo de multidifusión zonal tal como se describe en Habilitar el registro de la activación de un consumidor de un grupo de multidifusión.

El tipo de recurso monitorizado 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 La dirección IPv4 interna principal del consumidor de multicast. Ejemplo: 10.0.0.1
consumerLocation cadena La zona del consumidor de multidifusión. Ejemplo: us-east5-a
consumerNetwork Recurso La red VPC del consumidor de multidifusión. Ejemplo: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Proyecto El proyecto que contiene la red de VPC del consumidor de multidifusión. Ejemplo: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Recurso La instancia de VM de consumidor de multidifusión. Ejemplo: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Proyecto El proyecto que contiene la instancia de VM de consumidor de multidifusión. Puede ser diferente del proyecto que contiene la red de VPC del consumidor de multidifusión, como cuando se usa una VPC compartida. Ejemplo: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription cadena Uno de los eventos descritos en Eventos registrados. Ejemplo: IGMP consumer joined.
eventTime cadena Marca de tiempo del evento en formato de texto RFC 3339. Ejemplo: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation cadena Nombre de la asociación de consumidor multicast entre la red de VPC del consumidor multicast y el dominio. Ejemplo: my-consumer-association-name
multicastGroupConsumerActivation cadena El nombre de la activación del consumidor del grupo de multidifusión. Ejemplo: my-group-consumer-activation-name
multicastIp cadena La dirección IP del grupo de multidifusión. Ejemplo: 224.0.0.1

A diferencia de los registros del intervalo de grupos de multidifusión, los registros de activación de consumidores de grupos de multidifusión 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 consumidor de multidifusión.

Referencia de formato de campo

Proyecto

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

Recurso

Campo Tipo Descripción
id string (uint64) ID entero generado automáticamente del recurso. Ejemplo: 1111
name cadena Nombre asignado por el usuario al recurso. Ejemplo: my-instance

Habilitar el registro de eventos de pertenencia a grupos

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

Habilitar el registro de un intervalo de grupos de multidifusión

En esta sección se describe cómo puede configurar un administrador de multidifusión el registro de eventos de pertenencia a grupos para un intervalo de grupos de multidifusión.

Para obtener más información sobre cómo configurar el registro al crear un intervalo de grupos de multidifusión, consulta Crear intervalos de grupos de multidifusión. El registro de eventos de pertenencia no está habilitado de forma predeterminada.

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

  • Intervalo de grupos de multidifusión: la configuración de registro de un intervalo de grupos global se aplica a todas las activaciones del intervalo de grupos.
  • Activación del intervalo de grupos de multidifusión: la configuración de registro de la activación de un intervalo de grupos zonales anula la configuración del intervalo de grupos global.

gcloud

  • Para habilitar o inhabilitar el registro de un intervalo 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]

    Haz los cambios siguientes:

    • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
    • --[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.

  • Para habilitar o inhabilitar el registro de la activación de un intervalo de grupos de multidifusión, 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]

    Haz los cambios siguientes:

    • GROUP_RANGE_ACTIVATION_NAME: el nombre del grupo de multidifusión activación del intervalo
    • ZONE: la zona de activación del intervalo 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.

API

  • Para habilitar o inhabilitar el registro de un intervalo de grupos de multidifusión, 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"}
}

    Haz los cambios siguientes:

    • PROJECT_ID: ID del proyecto
    • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
    • LOGGING_ENABLED: especifica si el registro de eventos de miembros del canal está habilitado.
      • Para habilitar el registro, asigna el valor true.
      • Para inhabilitar el registro, asigna el valor false.

  • Para habilitar o inhabilitar el registro de la activación de un intervalo de grupos de multidifusión, 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"}
}

    Haz los cambios siguientes:

    • PROJECT_ID: ID del proyecto
    • GROUP_RANGE_ACTIVATION_NAME: el nombre del grupo de multidifusión activación del intervalo
    • ZONE: la zona de activación del intervalo del grupo de multidifusión
    • LOGGING_ENABLED: especifica si el registro de eventos de miembros del canal está habilitado.
      • Para habilitar el registro, asigna el valor true.
      • Para inhabilitar el registro, asigna el valor false.

Habilitar el registro de la activación de un consumidor de un grupo de multidifusión

En esta sección se describe cómo puede configurar un administrador de una red de consumidor de multidifusión el registro de eventos de pertenencia a grupos en su red de VPC.

En una red de VPC determinada en la que hayas habilitado el consumo de tráfico multicast, puedes configurar el registro de eventos de pertenencia en la activación del consumidor del grupo multicast correspondiente.

Para obtener más información sobre cómo configurar el registro al crear una activación de consumidor de un grupo de multidifusión, consulta Habilitar una red VPC para consumir tráfico de multidifusión. El registro de eventos de pertenencia no está habilitado de forma predeterminada.

gcloud

Para habilitar o inhabilitar el registro de la activación de un consumidor de un grupo de multidifusión, 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]

Haz los cambios siguientes:

  • GROUP_CONSUMER_ACTIVATION_NAME: el nombre del grupo de multidifusión activación del consumidor
  • ZONE: la zona de activación del consumidor 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.

API

Para habilitar o inhabilitar el registro de la activación de un consumidor de un grupo de multidifusión, 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"}
  }

Haz los cambios siguientes:

  • PROJECT_ID: ID del proyecto
  • GROUP_CONSUMER_ACTIVATION_NAME: el nombre del grupo de multidifusión activación del consumidor
  • ZONE: la zona de activación del consumidor del grupo de multidifusión
  • LOGGING_ENABLED: especifica si el registro de eventos de miembros del canal está habilitado.
    • Para habilitar el registro, asigna el valor true.
    • Para inhabilitar el registro, asigna el valor false.

Ver los registros de eventos de pertenencia a grupos

En esta sección se describe cómo ver los registros de eventos de pertenencia a grupos de multidifusión.

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

Consola

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

    Ir a Explorador de registros

  2. Para ver los registros de eventos de pertenencia a grupos de multidifusión, seleccione uno de los siguientes tipos de recursos monitorizados en la lista Todos los recursos:

    • Si eres administrador de multidifusión y quieres ver los registros de eventos de pertenencia a grupos de todos los consumidores de multidifusión de un grupo, selecciona Intervalo de grupos de multidifusión.
    • Si eres administrador de una red de VPC de consumidor de multidifusión y quieres ver los registros de eventos de pertenencia a grupos de tu red, selecciona Activación de consumidor de grupo de multidifusión.

Siguientes pasos