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
- Description
- Sous-type d'insight
- Contenu
- Catégorie
- Ressources cibles
- Informations sur l'état
- Etag
- Gravité
- Dernière actualisation
- Période d'observation
- Documentation de référence
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
ouus-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ésDISMISSED
OUACCEPTED
.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 commeCLAIMED
,SUCCEEDED
ouFAILED
. 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.