Insights

L'outil de recommandation fait appel au machine learning pour fournir des insights détaillés et de haute qualité. Les insights sont des résultats qui peuvent vous servir à examiner de manière proactive les tendances importantes dans l'utilisation des ressources. Vous pouvez utiliser les insights indépendamment des recommandations. Certains insights sont renvoient à des recommandations et fournissent des informations pertinentes sur les recommandations associées.

Cette page décrit les concepts clés permettant d'interpréter et d'utiliser des insights.

Types d'insights

Chaque insight est associé à un type d'insight spécifique. Les types d'insights sont propres à un seul type de ressource et produit Google Cloud. Un même produit peut avoir plusieurs types d'insights, chacun fournissant un type d'insight différent pour une ressource différente.

Chaque type d'insight possède un ID de type d'insight unique qui identifie le service en interne. Vous utilisez l'ID du type d'insight lorsque vous interagissez avec les insights à l'aide des commandes gcloud de l'outil de recommandation ou des API REST ou RPC.

Pour plus d'informations, consultez la section Types d'insights.

Insights

Un insight est un résultat généré par une machine qui peut être associé à une ou plusieurs recommandations. Un insight comporte les attributs principaux suivants :

Nom

Le nom de l'insight est stocké dans le champ name de l'entité Insight. Son format est le suivant :

projects/TARGET_PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights/INSIGHT_ID

où :

  • TARGET_PROJECT_ID correspond à l'ID du projet dans lequel l'insight a été généré.
  • LOCATION correspond à l'emplacement Google Cloud dans lequel se trouvent les ressources associées à l'insight (par exemple, global ou us-central1-a).
  • INSIGHT_TYPE_ID correspond à l'ID du type d'insight complet (par exemple, google.compute.firewall.Insight).
  • INSIGHT_ID correspond à l'identifiant unique de l'insight.

Description

Il s'agit d'un résumé lisible de l'insight. Il n'est disponible qu'en anglais.

Sous-type d'insight

Chaque type d'insight peut accepter plusieurs sous-types. Le schéma du contenu est stable pour un sous-type donné.

Contenu

Champs structurés qui incluent des informations sur l'insight. Le schéma du contenu est déterminé par le type d'insight et le sous-type. Par exemple : "grantedPermissionsCount": "1000"

Catégorie

Comme pour les impacts des recommandations, il existe des catégories pour les insights :

  • COST
  • SECURITY
  • PERFORMANCE

Ressources cibles

Noms complets des ressources Google Cloud ciblées par l'insight.

Informations sur l'état

État

Les insights passent par différents états après leur création :

  • ACTIVE, ce qui signifie que l'insight a été généré, mais aucune action n'a été effectuée en conséquence. Le contenu des insights actifs est mis à jour lorsque les données sous-jacentes sont modifiées. Les insights actifs peuvent être marqués DISMISSED OU ACCEPTED.
  • ACCEPTED, ce qui signifie qu'une action a été effectuée en fonction de l'insight. Les insights passent à l'état "accepté" lorsqu'une recommandation associée est marquée comme CLAIMED, SUCCEEDED ou FAILED. Vous pouvez aussi accepter des insights directement. Le contenu des insights acceptés est immuable. Les insights acceptés sont conservées pendant 90 jours à compter de la date de changement de leur état.
  • DISMISSED, ce qui signifie que l'insight a été ignoré et qu'aucune action n'a été effectuée en conséquence. Le contenu des insights ignorés est mis à jour lorsque les données sous-jacentes sont modifiées.

Métadonnées d'état

Lorsque vous marquez directement un insight comme accepté (ACCEPTED), vous pouvez ajouter des métadonnées supplémentaires sur l'opération aux métadonnées d'état. Les métadonnées sont spécifiées sous forme de paires key:value. Les mises à jour apportées au champ des métadonnées d'état remplacent toutes les métadonnées d'état existantes.

ETag

Un eTag est une empreinte unique qui identifie l'état actuel d'un insight. Chaque fois que les insights changent, une nouvelle valeur eTag est attribuée.
Pour modifier l'état des insights, vous devez indiquer la valeur de l'eTag de l'insight existant. Ainsi, les opérations ne sont effectuées que si les insights n'ont pas été modifiés depuis leur dernière récupération.

Gravité

La gravité d'un insight indique la probabilité de l'un des impacts suivants :

  • Panne (impact sur les performances)
  • Piratage (impact sur la sécurité)
  • Dépassement de budget (impact sur les coûts)
  • Mauvaise gestion (impact sur la gestion)

Ce champ contient les valeurs CRITICAL, HIGH, MEDIUM et LOW, avec la valeur LOW définie comme gravité par défaut. Chaque type d'insight peut avoir sa propre stratégie de sévérité définie.

Dernière actualisation

La dernière actualisation indique l'actualisation des données utilisées pour générer l'insight.

Période d'observation

La période d'observation est la période qui mène jusqu'à la génération de l'insight. L'analyse des données sources permettant de générer l'insight se termine à la dernière actualisation (last_refresh_time) et commencent à la dernière actualisation (last_refresh_time) moins la période d'observation (observation_period).

Documentation de référence

Référence à une recommandation associée. Les références relient des insights à leurs recommandations associées. Ce champ est vide lorsqu'aucune recommandation n'est dérivée de l'insight.