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 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. (par exemple, 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. Il s'agit d'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.
Un incident peut 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 examinent activement 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.
La prise en charge des 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 régulièrement jusqu'à sa résolution.
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 :
- L'impact de l'incident n'a pas pu être confirmé.
- 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 au niveau du produit et de l'emplacement pour refléter la récupération partielle lorsqu'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 de chaque produit ou emplacement :
- É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 l'état détaillé Résolu) uniquement lorsque 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 décrit l'impact d'un incident sur votre projet. La pertinence peut changer à mesure que l'incident évolue.
La pertinence peut avoir les valeurs suivantes :
- Impacté : l'impact de l'incident sur votre projet est confirmé. Disponible uniquement pour certains produits Google Cloud .
- 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.
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énement 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) : tagOUTPUT_ONLYexposant des titres de produits lisibles par l'humain et adaptés aux lectures des clients (tels que"Google Cloud SQL").previous_display_names(chaîne répétée) : tableauOUTPUT_ONLYdé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 zones géographiques 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
impactdans 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.