Surveiller l'état composite

Cette page explique comment surveiller l'état des services publiés qui utilisent l'état composite. Vous pouvez procéder comme suit :

  • Surveiller les états actuels : vérifiez l'état en temps réel d' un service publié ou d'un service de backend individuel.
  • Afficher les journaux des transitions d'état : utilisez Cloud Logging pour afficher les entrées de journal qui enregistrent les modifications d'état des ressources surveillées.

Vous surveillez les services publiés via les vérifications d'état composites associées, et les services de backend individuels via les sources d'état associées. Les clients de services peuvent afficher les journaux des NEG Private Service Connect qui se connectent aux services publiés utilisant l'état composite.

L'état composite utilise les états suivants pour représenter l'état des services publiés et des services de backend.

État de fonctionnement Ressource surveillée Description
HEALTHY Source des données d'état Le service de backend associé est opérationnel, comme défini par sa règle d'agrégation des données d'état.
Vérification de l'état composite Le service publié est opérationnel, car chacune de ses sources d'état associées est opérationnelle.
NEG Private Service Connect Le service publié associé est opérationnel, comme défini par la vérification de l'état composite du producteur.
UNHEALTHY Source des données d'état Le service de backend ne répond pas aux critères définis par sa règle d'agrégation des données d'état.
Vérification de l'état composite Le service publié n'est pas opérationnel, car une ou plusieurs des sources d'état associées ne sont pas opérationnelles.
NEG Private Service Connect Le service publié associé n'est pas opérationnel, comme défini par la vérification de l'état composite du producteur. Cet état peut déclencher un basculement interrégional.
UNKNOWN Source des données d'état L'état de fonctionnement n'est pas encore disponible. Il s'agit d'un état transitoire qui se produit lorsque des ressources sont créées ou configurées.
Vérification de l'état composite Aucune source d'état associée n'est non opérationnelle, mais une ou plusieurs sources d'état sont inconnues.
NEG Private Service Connect L'état de fonctionnement du service publié associé n'est pas encore disponible.

Avant de commencer

Vous devez configurer l'état composite avant de pouvoir l'utiliser pour surveiller l'état des services publiés.

Rôles requis

Pour obtenir les autorisations nécessaires pour surveiller l'état composite, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Vérifier l'état des sources d'état ou des vérifications d'état composites : lecteur Compute (roles/compute.viewer)
  • Afficher la journalisation de l'état composite: Lecteur de journaux (roles/logging.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Vérifier l'état d'une seule source d'état

Cette section explique comment récupérer les informations suivantes sur une source d'état :

  • L'état général
  • Le nombre de points de terminaison opérationnels par rapport au nombre total de points de terminaison dans chaque groupe d'instances ou NEG associé au service de backend de la source d'état

Si la source d'état est associée au service de backend d'un équilibreur de charge réseau à transfert interne comportant plusieurs règles de transfert, l'état est calculé indépendamment pour chacune des règles de transfert de l'équilibreur de charge. Dans ce cas, les détails de l'état incluent un champ forwardingRule pour identifier la règle de transfert en cours d'évaluation.

Console

  1. Dans la Google Cloud console, accédez à la page État composite :

    Accéder à État composite

  2. Cliquez sur Sources d'état.

  3. Cliquez sur le nom de la source d'état que vous souhaitez afficher.

  4. Pour afficher plus de détails, dans la section État, cliquez sur la flèche expander à côté du service de backend que vous souhaitez afficher. Si des règles de transfert s'affichent, cliquez sur la flèche de développement à côté d'une règle de transfert pour afficher l'état des backends associés.

gcloud

Exécutez la commande gcloud compute health-sources get-health.

gcloud compute health-sources get-health HEALTH_SOURCE \
    --region=REGION

Remplacez les éléments suivants :

  • HEALTH_SOURCE : nom de la source d'état
  • REGION : région de la source d'état

API

Envoyez une requête à la regionHealthSources.getHealth méthode.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE/getHealth

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet
  • REGION : région de la source d'état
  • HEALTH_SOURCE : nom de la source d'état

Vérifier l'état d'une vérification de l'état composite

Cette section explique comment vérifier l'état d'une vérification de l'état composite, y compris les informations suivantes :

  • L'état général du service régional publié surveillé

  • L'état individuel de chaque source d'état associée à la vérification de l'état composite

Console

  1. Dans la Google Cloud console, accédez à la page État composite :

    Accéder à État composite

  2. Cliquez sur le nom de la vérification de l'état composite que vous souhaitez afficher.

  3. Pour afficher plus de détails, dans la section État, cliquez sur la flèche d'expansion à côté de la vérification de l'état composite que vous souhaitez afficher.

gcloud

Exécutez la commande gcloud compute composite-health-checks get-health.

gcloud compute composite-health-checks get-health COMPOSITE_CHECK_NAME \
    --region=REGION

Remplacez les éléments suivants :

  • COMPOSITE_CHECK_NAME: nom de la vérification de l'état composite
  • REGION : région de la vérification de l'état composite

API

Envoyez une requête à la regionCompositeHealthChecks.getHealth méthode.

Méthode HTTP et URL :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_CHECK_NAME/getHealth

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet
  • REGION : région de la vérification de l'état composite
  • COMPOSITE_CHECK_NAME: nom de la vérification de l'état composite

Afficher les journaux d'état composite

Vous pouvez utiliser Cloud Logging pour suivre les modifications d'état. Ces journaux sont générés chaque fois qu'un état change (par exemple, de HEALTHY à UNHEALTHY).

La journalisation est activée par défaut pour les sources d'état, les vérifications d'état composites et les NEG Private Service Connect qui se connectent aux services publiés configurés pour utiliser l'état composite.

Pour en savoir plus sur l'interrogation et l'analyse des données de journal, consultez Analyser les journaux à l'aide de l'explorateur de journaux et d'Observability Analytics.

Console

Pour afficher les journaux d'état composite, procédez comme suit.

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

    Accéder à l'explorateur de journaux

  2. Si le champ de l'éditeur de requête n'apparaît pas dans le volet Requête, cliquez sur le bouton Afficher la requête.

  3. Dans le champ de l'éditeur de requête :

    • Pour afficher les journaux des ressources du producteur (sources d'état et vérifications d'état composites), saisissez la requête suivante :

      logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fcompositehealth"

    • Pour afficher les journaux des ressources du consommateur (NEG Private Service Connect connectés aux services publiés qui utilisent des vérifications d'état composites), saisissez la requête suivante :

      logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Fservicehealthchecks"

    Remplacez PROJECT_ID par l'ID de votre projet.

  4. Cliquez sur Exécuter la requête.