Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Concepts de Personalized Service Health

Ce document décrit les concepts et termes clés utilisés dans Personalized Service Health (PSH). La compréhension de ces concepts vous aide à interpréter efficacement les événements et à configurer les alertes.

Événement Personalized Service Health

Un événement Service Health (v1, v1beta) est un événement perturbateur qui affecte un produit Google Cloud pertinent pour vos projets ou vos ressources. Exemples : pannes de réseau, erreurs de configuration et problèmes de performances.

Chaque événement contient des détails sur l'impact global de l'événement, des mises à jour de Google et des informations spécifiques à votre projet Google Cloud .

Incident

Les incidents sont des interruptions ou des dégradations de service Google Cloud émergentes et actives qui concernent vos projets. Un incident est également une catégorie d'événement Service Health.

Un incident comprend les éléments suivants :

Impact de l'incident : détails de la portée de l'événement, tels que les produits et les emplacementsGoogle Cloud concernés.
Mises à jour de Google Cloud : mises à jour périodiques de l'assistanceGoogle Cloud .
Pertinence personnalisée : pertinence de l'incident pour votre projet Google Cloud.
Symptômes, solutions de contournement et heures d'arrivée prévues : informations permettant d'évaluer l'impact, d'appliquer une solution de contournement ou d'en savoir plus sur la cause principale.

Les incidents peuvent faire l'objet d'un rapport d'incident, qui inclut les facteurs ayant contribué à l'incident et les mesures que Google Cloud prévoit de prendre pour éviter que des incidents similaires ne se reproduisent. Les signalements d'incident sont disponibles pour les incidents qui remplissent les conditions suivantes :

L'incident a un impact mondial ou affecte un pourcentage important de projets client dans une ou plusieurs régions.
Un ou plusieurs produits sont indisponibles ou fortement dégradés.

États des événements et états détaillés

Un événement comporte deux champs indiquant son état. Les valeurs de ces champs changent à mesure que l'événement évolue.

État de l'événement : indique l'état global de l'événement. Il peut s'agir de l'un des suivants :
- Actif : l'événement affecte activement Google Cloud et continuera de recevoir des mises à jour.
- Fermé : l'événement n'affecte plus aucun produit Google Cloud ou a été fusionné avec un autre événement.
État détaillé : fournit plus d'informations sur l'état de l'événement. Il ne s'applique qu'aux incidents et peut prendre l'une des valeurs suivantes en fonction de l'état de l'événement :
- Émergent : les ingénieurs Google enquêtent activement sur l'incident pour en déterminer l'impact. Un incident émergent devient un incident confirmé ou résolu une fois l'évaluation de l'impact terminée. Un incident actif peut être un incident émergent.
  
  L'assistance pour les incidents émergents n'est disponible que pour les produits de mise en réseau Google Cloud.
- Confirmé : l'incident est confirmé par les ingénieurs Google et affecte au moins un produit Google Cloud . Des informations sur l'état du problème seront fournies jusqu'à ce qu'il soit résolu.
  
  Un incident actif peut être un incident confirmé.
- Fusionné : l'incident a été fusionné avec un incident parent. Toutes les mises à jour ultérieures ne seront publiées que sur le parent.
- Résolu : l'incident n'affecte plus aucun produit Google Cloudaprès l'intervention. Aucune autre mise à jour ne sera publiée.
  
  Un incident fermé est généralement un incident résolu.
- Faux positif : après examen, les ingénieurs Google ont conclu que l'incident n'affectait pas un produit Google Cloud . Cet état peut changer si l'incident est réexaminé.
- Fermeture automatique : l'incident a été automatiquement fermé pour les raisons suivantes :
  - Impossible de confirmer l'impact de l'incident.
  - L'incident était intermittent ou s'est résolu de lui-même.
  L'incident n'a pas de résolution, car aucune action ni investigation n'a eu lieu. S'il est intermittent, l'incident peut être rouvert.

État de perturbation précis

Lors d'un incident multiproduit ou multisite, des produits ou des sites individuels peuvent être rétablis avant que l'incident global ne soit résolu. Personalized Service Health fournit un état d'interruption précis par produit et par emplacement pour refléter la récupération partielle pendant qu'un incident est actif. L'état de perturbation précis est disponible pour les événements au niveau du projet et de l'organisation.

Un produit ou un emplacement peut présenter l'un des états de perturbation précis suivants :

Affecté : le produit ou l'emplacement subit des perturbations en raison de l'incident.
Résolu : le produit ou l'emplacement spécifique ne subit plus de perturbation et a été rétabli.

Distinction entre les états d'événement et l'état précis

Il est important de faire la distinction entre l'état global de l'événement, l'état détaillé et l'état de perturbation précis des produits ou des emplacements individuels :

État global et état détaillé de l'événement : s'appliquent à l'incident dans son ensemble. Un incident reste Actif (avec un état détaillé tel que Confirmé) tant qu'au moins un produit ou un emplacement reste Affecté. Un incident passe à l'état Fermé (avec un état détaillé Résolu) uniquement après que tous les produits et emplacements associés ont atteint l'état Résolu.
État de perturbation précis : s'applique indépendamment à chaque produit ou emplacement concerné. Un produit ou un emplacement individuel peut passer à l'état Résolu, tandis que l'état global de l'événement reste Actif.

Lorsqu'un incident est fusionné avec un incident parent, les états de perturbation précis de l'incident enfant sont effacés, et l'incident enfant délègue l'état précis à l'incident parent en tant que source unique de vérité.

Pertinence

Personalized Service Health évalue l'impact de tous les incidents sur votre projet. Si l'impact de l'incident sur votre projet est possible ou confirmé, il devient disponible dans le tableau de bord et l'API Service Health.

La pertinence indique si votre projet est affecté, lié ou partiellement lié à un événement. Pour les produits compatibles en version preview, la pertinence identifie également les ressources spécifiques de votre projet qui sont concernées.

La pertinence peut avoir les valeurs suivantes :

Impacté : l'impact de l'incident sur votre projet est confirmé. Pour les produits compatibles (preview), vous pouvez également voir quelles ressources spécifiques de votre projet sont concernées.
Associé : l'incident a un lien direct avec votre projet et a un impact sur un produit Google Cloud situé dans un emplacement utilisé par votre projet.
Partiellement lié : l'incident est associé à un produit Google Cloudutilisé par votre projet, mais il ne devrait pas affecter ce projet. Par exemple, il se peut que l'incident ait un impact sur un produit Google Cloudutilisé par votre projet, mais dans un emplacement que celui-ci n'utilise pas.
Non affecté : l'incident n'affecte pas votre projet.
Inconnu : l'impact sur votre projet n'est pas connu à ce stade.

Ressources concernées

Lorsqu'un événement a une pertinence de IMPACTED pour votre projet, Personalized Service Health peut identifier les ressources Google Cloud spécifiques de votre projet qui sont affectées par l'interruption (par exemple, une instance Cloud SQL ou un cluster Google Kubernetes Engine spécifique).

Dans l'API Service Health v1beta, chaque ressource concernée est représentée par une ressource Impact (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}). Une ressource Impact contient les éléments suivants :

Événements associés (events) : un ou plusieurs noms de ressources Event Service Health au niveau du projet (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID}) associés à l'impact sur la ressource.
Élément concerné (asset) :
- assetName : nom complet de la ressource de la ressourceGoogle Cloud concernée (par exemple, //cloudsql.googleapis.com/projects/123456789/instances/my-db-instance).
- assetType : type de ressource d'inventaire des éléments cloud de la ressource concernée (par exemple, sqladmin.googleapis.com/Instance ou container.googleapis.com/Cluster).
Description (description) : contexte supplémentaire sur l'impact sur la ressource, le cas échéant.
Horodatages (createTime, updateTime) : date et heure de la première création et de la dernière mise à jour de l'enregistrement d'impact sur les ressources.

Tenez compte des comportements suivants lorsque vous utilisez des ressources concernées en version Preview :

Impacts sur le projet par rapport aux impacts sur l'organisation :
- Impact (projects.locations.impacts) est limité à un seul projet et ne renvoie que les ressources non conteneurisées lorsque l'événement a confirmé la pertinence de IMPACTED pour ce projet, et lorsque l'assistance produit est disponible.
- Impact sur l'organisation (organizations.locations.organizationImpacts) : agrège les données de l'organisation pour renvoyer les éléments de conteneur (projets) dont la pertinence est non nulle (PARTIALLY_RELATED, RELATED ou IMPACTED), où une pertinence non nulle désigne tout projet susceptible d'être affecté par un OrganizationEvent.
Prérequis pour l'activation de l'API : pour recevoir des enregistrements Impact, l'API Service Health (servicehealth.googleapis.com) doit être activée sur le projet au moins 24 heures avant le début de l'événement. L'activation de l'API après le début d'un événement permet de remplir les événements au niveau du projet des 90 derniers jours, mais pas les impacts au niveau des ressources.
Cycle de vie de la durée de l'événement : une fois qu'une ressource est identifiée comme étant affectée par un événement, son enregistrement Impact reste associé à l'événement pendant le cycle de vie de l'incident. Utilisez la ressource Event associée pour suivre l'état global de l'incident (ACTIVE ou COMPLETED) et les mises à jour des communications.
Produits compatibles et champ d'application des incidents : l'impact au niveau des ressources est disponible pour les produits et types de ressources Google Cloud compatibles. Si un événement affecte un produit qui n'est pas compatible avec l'impact au niveau des ressources, ou si l'interruption se produit au niveau du plan de contrôle ou au niveau régional, sans être liée à des instances de ressources individuelles, le projet Event apparaît toujours avec relevance: IMPACTED, tandis que impacts.list renvoie une liste vide.

Pour interroger les ressources concernées, consultez Gérer les événements affectant un projet.

Noms d'identité et noms à afficher des produits (alpha et bêta uniquement)

Pour permettre aux administrateurs d'identifier rapidement les opérations sans nécessiter de mappages locaux des identifiants de produits, les entrées d'événements dans les versions v1alpha et v1beta fournissent des chaînes d'affichage dans les ressources référencées.

Plus précisément, dans les objets Product spécifiés sur les charges utiles standards (situés dans les collections impact sur Event et OrganizationEvent), deux nouvelles propriétés facilitent l'identification :

display_name (chaîne) : tag OUTPUT_ONLY exposant des titres de produits lisibles par l'humain et adaptés aux lectures des clients (par exemple, "Google Cloud SQL").
previous_display_names (chaîne répétée) : tableau OUTPUT_ONLY détaillant tous les titres que cette ressource spécifique acceptait auparavant. Cela permet de maintenir la continuité du traçage des événements lors des changements de marque actifs.

Les champs d'affichage des produits sont différés sur la surface vGA (v1) pour une stabilité maximale du système.

Pour déterminer les identifiants immuables corrects à utiliser dans les filtres et les alertes :

Ouvrez le guide Produits et emplacements compatibles.
Recherchez le produit Google Cloud cible dans le tableau.
Copiez la valeur indiquée sous ID produit.

Vous pouvez également déterminer les identifiants immuables corrects directement à partir des charges utiles de l'API :

Effectuez un appel d'API renvoyant des ressources d'événement (telles que projects.locations.events.list).
Inspectez les mappages de blocs impact dans le tableau JSON obtenu.
Extrayez la chaîne présente dans la propriété product. Cette valeur indique l'identifiant produit stable, indépendamment des différents noms à afficher.