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

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

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

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

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

Ce tableau fournit un récapitulatif des 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
Activation client du groupe multicast

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

Ces journaux sont disponibles dans les projets qui contiennent des configurations de consommateurs multicast et leur réseau de consommateurs multicast correspondant. Si vous utilisez un VPC partagé, il s'agit du projet hôte.

Consultez Activer la journalisation pour une activation client du groupe multicast.

Événements consigné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 multicast envoie un rapport d'appartenance IGMP pour rejoindre un groupe, les messages de journalisation obtenus sont les suivants :

  • Une adhésion IGMP réussie génère deux messages de journalisation : un message IGMP join request received suivi de IGMP consumer joined.
  • Pour un consommateur multicast qui a déjà rejoint un groupe, une requête d'adhésion IGMP keep-alive dans un seul IGMP join request received message.

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

Événement Description
IGMP join request received

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

Chaque demande d'adhésion est consignée, y compris les requêtes keep-alive que les consommateurs multicast envoient régulièrement dans le cadre du protocole IGMP.
IGMP consumer joined

Le Google Cloud plan de contrôle 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 Google Cloud plan de contrôle a reçu une demande de sortie IGMP explicite du consommateur multicast et l'a appliquée.
IGMP consumer timed out

Le Google Cloud plan de contrôle a supprimé le consommateur multicast du groupe, car il a cessé de répondre aux requêtes keep-alive.
IGMP entitlement rejected

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

  • La configuration du réseau VPC du consommateur multicast n'est pas terminée.
  • La configuration du réseau VPC du consommateur multicast n'a pas été propagée à l'infrastructure multicast du domaine.
  • Le consommateur 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

Format des journaux 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 qui contiennent des configurations de consommateurs multicast.

Ces journaux sont écrits pour les événements d'appartenance des consommateurs 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 Cloud Logging et le nom du journal 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 chaîne Adresse IPv4 interne principale du consommateur multicast. Exemple : 10.0.0.1.
consumerLocation chaîne Zone du consommateur multicast. Exemple : us-east5-a.
consumerNetwork Ressource Réseau VPC du consommateur multicast. Exemple : 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Projet Projet contenant le réseau VPC du consommateur multicast. Exemple : 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Ressource Instance de VM du consommateur multicast. Exemple : 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Projet Projet contenant l'instance de VM du consommateur 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 chaîne L'un des événements décrits dans Événements consignés. Exemple : IGMP consumer joined.
eventTime chaîne Timestamp de l'événement au format texte RFC 3339. Exemple : 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation chaîne Nom de l'association de consommateurs multicast entre le réseau VPC du consommateur multicast et le domaine. Exemple : my-consumer-association-name.
multicastGroupConsumerActivation chaîne Nom de l'activation client du groupe multicast. Exemple : my-group-consumer-activation-name.
multicastIp chaîne Adresse IP du groupe multicast. Exemple : 224.0.0.1.

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

Référence du format des champs

Projet

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

Ressource

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

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

Les sections suivantes décrivent comment activer la journalisation des événements d'appartenance à un groupe.

Activer la journalisation pour une activation client du groupe multicast

Cette section explique comment un administrateur de réseau de consommateurs 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 du 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 client du groupe multicast, consultez Activer un réseau VPC pour consommer du trafic multicast. La journalisation des événements d'appartenance n'est pas activée par défaut.

gcloud

Pour activer ou désactiver la journalisation pour une activation client du groupe multicast, utilisez la network-services multicast-group-consumer-activations update commande.

  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 client du groupe multicast
  • ZONE : zone de l'activation client du groupe multicast
  • --[no-]enable-logging : détermine si la journalisation des événements d'appartenance 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 du groupe multicast, utilisez la multicastGroupConsumerActivations.patch méthode.

  PATCH https://networkservices.googleapis.com/v1/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 client du groupe multicast
  • ZONE : zone de l'activation client du groupe multicast
  • LOGGING_ENABLED : indique si la journalisation des événements d'appartenance est activée.
    • Pour activer la journalisation, définissez la valeur 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 Google Cloud console, 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 multicast, sélectionnez l'un des types de ressources surveillées suivants dans la liste Toutes les ressources :
    • Si vous êtes un administrateur de réseau VPC de consommateurs 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.