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 spécifiques à un seul produit et type de ressource 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 GCP 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"

Category

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

  • COST
  • SECURITY
  • PERFORMANCE

Ressources cibles

Noms complets des ressources GCP 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.

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.