Afficher les journaux d'événements d'appartenance à un groupe multicast

Cette page fournit des informations sur les journaux disponibles pour surveiller les événements d'appartenance à un groupe multicast, tels que les jointures IGMP. Elle explique également comment les activer et les afficher.

Vous pouvez utiliser ces journaux pour comprendre l'activité d'un groupe de multidiffusion, par exemple quand un consommateur de multidiffusion a rejoint le groupe et quand il l'a quitté, ou le nombre de consommateurs de multidiffusion dans un groupe.

À propos des journaux d'événements d'appartenance à un groupe

Google Cloud écrit des journaux d'événements d'appartenance à un groupe pour le multicast dans Cloud Logging.

Ce tableau récapitule les journaux disponibles pour chaque type de ressource, y compris le projet qui reçoit les journaux. Pour en savoir plus sur les événements consignés et le format des journaux, consultez les sections suivantes.

Ressource Description des journaux
Plage de groupes multicast

Journaux des événements d'appartenance à un groupe pour tous les consommateurs multicast d'une plage de groupes.

Ces journaux ne sont disponibles que dans les projets d'administrateur multicast.

Vous pouvez configurer la journalisation pour une plage de groupes multicast globale et pour une activation de plage de groupes multicast zonale. Consultez Activer la journalisation pour une plage de groupes multicast.
Activation client du groupe multicast

Journaux d'événements d'appartenance à un groupe pour les clients multicast dans un réseau VPC de client multicast spécifique activé pour une plage de groupes et une zone.

Ces journaux sont disponibles dans les projets qui contiennent des ressources de clients multicast. Il peut s'agir du projet d'administrateur multicast ou d'un projet client multicast distinct, en fonction de la topologie du domaine multicast.

Consultez Activer la journalisation pour une activation client d'un groupe multicast.

Événements enregistrés

Cette section décrit les événements d'appartenance à un groupe qui sont consignés pour le multicast dans Cloud Logging.

Lorsqu'un consommateur de multidiffusion envoie un rapport d'appartenance IGMP pour rejoindre un groupe, les messages de journaux obtenus sont les suivants :

  • Une jointure IGMP réussie génère deux messages de journal : un message IGMP join request received suivi de IGMP consumer joined.
  • Un échec de l'association IGMP génère deux messages de journal : un message IGMP join request received suivi de IGMP join request rejected due to *.
  • Pour un consommateur multicast qui a déjà rejoint un groupe avec succès, une requête IGMP de maintien en vie entraîne un seul message IGMP join request received.

Pour obtenir la liste complète des événements enregistrés et leur description, consultez le tableau suivant.

Événement Description
IGMP join request received

Le plan de contrôle Google Cloud a reçu la demande de participation. Ce message ne confirme pas que l'association a bien été effectuée.

Chaque demande de participation est enregistrée, y compris les demandes de maintien en vie que les consommateurs multicast envoient régulièrement dans le cadre du protocole IGMP.
IGMP consumer joined

Le plan de contrôle Google Cloud a bien ajouté le consommateur multicast au groupe. Une fois cet événement propagé à l'infrastructure multicast du domaine, le consommateur multicast commence à recevoir du trafic multicast.

Cet événement est toujours précédé d'un événement IGMP join request received.
IGMP consumer left

Le plan de contrôle Google Cloud a reçu une demande de sortie IGMP explicite du consommateur multicast et l'a appliquée.
IGMP consumer timed out

Le plan de contrôle Google Cloud a supprimé le client multicast du groupe, car il a cessé de répondre aux demandes de maintien en vie.
Consumer removed due to configuration change

Le plan de contrôle Google Cloud a supprimé le client multicast du groupe, car le point de terminaison du client a été supprimé. Par exemple, l'instance ou le projet client ont peut-être été supprimés.
IGMP join request rejected due to full tree

Le plan de contrôle Google Cloud a reçu la demande d'adhésion, mais l'a refusée, car le groupe multicast est déjà complet.
IGMP join request rejected due to missing quota

Le plan de contrôle Google Cloud a reçu la demande de joindre le réseau, mais l'a refusée, car le réseau VPC du client multicast utilise déjà tout son quota de VM clientes multicast par réseau VPC.
IGMP join request rejected due to unknown reason

Le plan de contrôle Google Cloud a reçu la demande de participation, mais l'a refusée en raison d'un échec qui n'a pas de raison spécifique.
IGMP entitlement rejected

Le plan de contrôle Google Cloud a reçu la demande de participation, mais l'a refusée, car la configuration requise du consommateur multicast n'est pas terminée, par exemple dans les cas suivants :

  • La configuration du réseau VPC du client multicast n'est pas terminée.
  • La configuration du réseau VPC du client multicast ne s'est pas propagée à l'infrastructure multicast pour le domaine.
  • Le client multicast n'est pas configuré pour IGMP.

Cet événement n'est disponible que dans les journaux de la ressource d'activation client du groupe multicast.
Consumer network activated

Un réseau VPC client multicast a été activé pour une plage de groupes multicast. Cela correspond à la création d'une ressource d'activation client du groupe multicast.

Cet événement n'est disponible que pour les administrateurs multicast dans les journaux des ressources de plage de groupes multicast.
Consumer network deactivated

Un réseau VPC client multicast a été désactivé pour une plage de groupes multicast. Cela signifie qu'une ressource d'activation client du groupe multicast a été supprimée ou que son état est passé à INACTIVE.

Cet événement n'est disponible que pour les administrateurs multicast dans les journaux des ressources de plage de groupes multicast.

Format du journal pour les plages de groupes multicast

Cette section décrit le format des journaux d'événements d'appartenance à un groupe disponibles dans le projet administrateur multicast qui contient les ressources de domaine et de plage de groupes multicast.

Ces journaux sont écrits pour les événements d'appartenance pour tous les consommateurs multicast d'une plage de groupes multicast donnée. Vous pouvez configurer la journalisation sur les ressources d'activation de la plage de groupes multicast globale et zonale, comme décrit dans Activer la journalisation pour une plage de groupes multicast.

Le type de ressource surveillée et le nom du journal Cloud Logging sont les suivants :

  • Type de ressource : networkservices.googleapis.com/MulticastGroupRange
  • Nom du journal : networkservices.googleapis.com%2Fmulticast_memberships

Le format du journal varie en fonction du type d'événement consigné. Pour en savoir plus, consultez les tableaux de chacun des onglets suivants.

Événement IGMP

Si l'événement consigné est un événement IGMP, le journal inclut les champs suivants :

Champ Type Description
consumerIp string Adresse IPv4 interne principale du consommateur de multidiffusion. Exemple : 10.0.0.1.
consumerLocation string Zone du VPC du client multicast. Exemple : us-east5-a.
consumerNetwork Ressource Réseau VPC du client multicast. Seul l'ID entier est renseigné. Exemple : 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projet Projet contenant le réseau VPC du client multicast. Seul le numéro de projet est renseigné. Exemple : 
      consumerProject {
       number: "5678"
      }
consumerResource Ressource Instance de VM du client multicast. Seul l'ID entier est renseigné. Exemple : 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Projet Projet contenant l'instance de VM cliente multicast. Il peut être différent du projet contenant le réseau VPC du consommateur multicast, par exemple lorsque vous utilisez un VPC partagé. Seul le numéro de projet est renseigné. Exemple : 
      consumerResourceProject {
       number: "4321"
      }
eventDescription string L'un des événements décrits dans Événements enregistrés. Exemple : IGMP consumer joined.
eventTime string Code temporel de l'événement au format texte RFC 3339. Exemple : 2024-10-21T06:46:42.990162973Z.
multicastDomain string Nom du domaine multicast. Exemple : my-domain-name.
multicastGroupRange string Nom de la plage de groupes multicast. Exemple : my-group-range-name.
multicastIp string Adresse IP du groupe multicast. Exemple : 224.0.0.1.

Activation/Désactivation

Si l'événement enregistré est une activation ou une désactivation du réseau VPC du client multicast, le journal inclut les champs suivants :

Champ Type Description
consumerLocation string Zone dans laquelle le réseau VPC du client multicast a été activé. Exemple : us-east5-a.
consumerNetwork Ressource Réseau VPC du client multicast. Seul l'ID entier est renseigné. Exemple : 
      consumerNetwork {
       id: "1234"
      }
consumerProject Projet Projet contenant le réseau VPC du client multicast. Seul le numéro de projet est renseigné. Exemple : 
      consumerProject {
       number: "5678"
      }
eventDescription string L'un des événements décrits dans Événements enregistrés. Exemple : Consumer network activated.
eventTime string Code temporel de l'événement au format texte RFC 3339. Exemple : 2024-10-21T06:46:42.990162973Z.
multicastDomain string Nom du domaine multicast. Exemple : my-domain-name.
multicastGroupRange string Nom de la plage de groupes multicast. Exemple : my-group-range-name

Des ID entiers sont utilisés pour les ressources des clients multicast, telles que les projets, les réseaux et les instances, afin de préserver la confidentialité.

Format du journal pour les activations client du groupe multicast

Cette section décrit le format des journaux d'événements d'appartenance à un groupe disponibles dans les projets contenant des ressources de clients multicast. Le projet peut être le projet d'administrateur multicast ou un projet de consommateur multicast distinct, selon la topologie du domaine multicast.

Ces journaux sont écrits pour les événements liés aux membres des clients multicast dans un réseau VPC donné, activé pour une plage et une zone de groupe multicast. Vous pouvez configurer la journalisation sur la ressource d'activation client du groupe multicast zonal, comme décrit dans Activer la journalisation pour une activation client du groupe multicast.

Le type de ressource surveillée et le nom du journal Cloud Logging sont les suivants :

  • Type de ressource : networkservices.googleapis.com/MulticastGroupConsumerActivation
  • Nom du journal : networkservices.googleapis.com%2Fmulticast_memberships

Le journal inclut les champs suivants :

Champ Type Description
consumerIp string Adresse IPv4 interne principale du consommateur de multidiffusion. Exemple : 10.0.0.1.
consumerLocation string Zone du client multicast. Exemple : us-east5-a.
consumerNetwork Ressource Réseau VPC du client multicast. Exemple : 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Projet Projet contenant le réseau VPC du client multicast. Exemple : 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Ressource Instance de VM du client multicast. Exemple : 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Projet Projet contenant l'instance de VM cliente multicast. Il peut être différent du projet contenant le réseau VPC du consommateur multicast, par exemple lorsque vous utilisez un VPC partagé. Exemple : 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription string L'un des événements décrits dans Événements enregistrés. Exemple : IGMP consumer joined.
eventTime string Code temporel de l'événement au format texte RFC 3339. Exemple : 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation string Nom de l'association de clients multicast entre le réseau VPC du client multicast et le domaine. Exemple : my-consumer-association-name.
multicastGroupConsumerActivation string Nom de l'activation client du groupe multicast. Exemple : my-group-consumer-activation-name.
multicastIp string Adresse IP du groupe multicast. Exemple : 224.0.0.1.

Contrairement aux journaux de plage de groupes multicast, les journaux d'activation de consommateur de groupe multicast utilisent des ID de chaîne pour le projet et le réseau, car ils ne sont disponibles que pour le projet contenant les ressources de consommateur multicast.

Documentation de référence sur le format des champs

Projet

Champ Type Description
number chaîne (uint64) ID entier du projet généré automatiquement. Exemple : 5678.
id string ID du projet attribué par l'utilisateur. Exemple : my-project.

Ressource

Champ Type Description
id chaîne (uint64) ID entier de la ressource, généré automatiquement. Exemple : 1111.
name string Nom attribué par l'utilisateur à la ressource. Exemple : my-instance.

Activer la journalisation des événements d'appartenance à un groupe

Les sections suivantes expliquent comment activer la journalisation des événements d'appartenance à un groupe pour une plage de groupes multicast ou un réseau VPC consommateur multicast spécifique.

Activer la journalisation pour une plage de groupes multicast

Cette section explique comment un administrateur multicast peut configurer la journalisation des événements d'appartenance à un groupe pour une plage de groupes multicast existante.

Pour en savoir plus sur la configuration de la journalisation lors de la création d'une plage de groupes multidiffusion, consultez Créer des plages de groupes multidiffusion. La journalisation des événements liés aux abonnements n'est pas activée par défaut.

Vous pouvez configurer la journalisation des événements liés aux membres sur les ressources suivantes :

  • Plage de groupes multicast : la configuration de journalisation d'une plage de groupes globale s'applique à toutes les activations de la plage de groupes.
  • Activation de la plage de groupes multicast : la configuration de journalisation d'une activation de plage de groupes zonaux remplace la configuration de plage de groupes globale.

gcloud

  • Pour activer ou désactiver la journalisation pour une plage de groupes multicast, utilisez la commande network-services multicast-group-ranges update.

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

    Remplacez les éléments suivants :

    • GROUP_RANGE_NAME : nom de la plage de groupes multicast
    • --[no-]enable-logging : détermine si la journalisation des événements liés aux membres est activée.
      • Pour activer la journalisation, utilisez --enable-logging.
      • Pour désactiver la journalisation, utilisez --no-enable-logging.

  • Pour activer ou désactiver la journalisation pour l'activation d'une plage de groupes multicast, utilisez la commande 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]

    Remplacez les éléments suivants :

    • GROUP_RANGE_ACTIVATION_NAME : nom de l'activation de la plage de groupes multicast.
    • ZONE : zone d'activation de la plage de groupes multicast
    • --[no-]enable-logging : détermine si la journalisation des événements liés aux membres est activée.
      • Pour activer la journalisation, utilisez --enable-logging.
      • Pour désactiver la journalisation, utilisez --no-enable-logging.

API

  • Pour activer ou désactiver la journalisation pour une plage de groupes multicast, utilisez la méthode multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet
    • GROUP_RANGE_NAME : nom de la plage de groupes multicast
    • LOGGING_ENABLED : indique si la journalisation des événements liés aux abonnements est activée.
      • Pour activer la journalisation, définissez ce paramètre sur true.
      • Pour désactiver la journalisation, définissez la valeur sur false.

  • Pour activer ou désactiver la journalisation pour l'activation d'une plage de groupes multicast, utilisez la méthode multicastGroupRangeActivations.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet
    • GROUP_RANGE_ACTIVATION_NAME : nom de l'activation de la plage de groupes multicast.
    • ZONE : zone d'activation de la plage de groupes multicast
    • LOGGING_ENABLED : indique si la journalisation des événements liés aux abonnements est activée.
      • Pour activer la journalisation, définissez ce paramètre sur true.
      • Pour désactiver la journalisation, définissez la valeur sur false.

Activer la journalisation pour une activation client du groupe multicast

Cette section explique comment un administrateur de réseau client multicast peut configurer la journalisation des événements d'appartenance à un groupe pour son réseau VPC.

Pour un réseau VPC donné que vous avez activé pour consommer le trafic multicast, vous pouvez configurer la journalisation des événements d'appartenance sur l'activation client du groupe multicast correspondant.

Pour en savoir plus sur la configuration de la journalisation lors de la création d'une activation de consommateur de groupe multicast, consultez Autoriser un réseau VPC à consommer du trafic multicast. La journalisation des événements liés aux abonnements n'est pas activée par défaut.

gcloud

Pour activer ou désactiver la journalisation pour une activation consommateur de groupe multicast, utilisez la commande 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]

Remplacez les éléments suivants :

  • GROUP_CONSUMER_ACTIVATION_NAME : nom de l'activation du consommateur du groupe multicast
  • ZONE : zone de l'activation client du groupe multicast
  • --[no-]enable-logging : détermine si la journalisation des événements liés aux membres est activée.
    • Pour activer la journalisation, utilisez --enable-logging.
    • Pour désactiver la journalisation, utilisez --no-enable-logging.

API

Pour activer ou désactiver la journalisation pour une activation client de groupe multicast, utilisez la méthode multicastGroupConsumerActivations.patch.

  PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME?updateMask=logConfig
  {
    "logConfig": {"enabled": "LOGGING_ENABLED"}
  }

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet
  • GROUP_CONSUMER_ACTIVATION_NAME : nom de l'activation du consommateur du groupe multicast
  • ZONE : zone de l'activation client du groupe multicast
  • LOGGING_ENABLED : indique si la journalisation des événements liés aux abonnements est activée.
    • Pour activer la journalisation, définissez ce paramètre sur true.
    • Pour désactiver la journalisation, définissez la valeur sur false.

Afficher les journaux d'événements d'appartenance à un groupe

Cette section explique comment afficher les journaux d'événements d'appartenance à un groupe pour le multicast.

Pour en savoir plus, consultez la présentation de l'explorateur de journaux.

Console

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Pour afficher les journaux d'événements d'appartenance à un groupe multidiffusion, sélectionnez l'un des types de ressources surveillées suivants dans la liste Toutes les ressources :

    • Si vous êtes un administrateur multicast et que vous souhaitez afficher les journaux d'événements d'appartenance à un groupe pour tous les consommateurs multicast d'un groupe, sélectionnez Plage de groupes multicast.
    • Si vous êtes administrateur de réseau VPC consommateur de multicast et que vous souhaitez afficher les journaux d'événements d'appartenance à un groupe pour votre réseau, sélectionnez Activation client du groupe multicast.

Étapes suivantes