Afficher et comprendre les insights sur les instances de VM

Les insights sur les instances de machines virtuelles (VM) vous aident à comprendre comment vos VM Compute Engine utilisent le processeur, la mémoire et le réseau. Les insights sont générés automatiquement, à partir des métriques système ou des métriques collectées par Cloud Monitoring. Vous pouvez utiliser les insights pour prendre des décisions concernant le redimensionnement des types de machines, afin d'utiliser plus efficacement les ressources de la VM.

Pour en savoir plus sur les insights, consultez la page Insights.

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Trusted Cloud by S3NS . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante : 

      gcloud init
    2. Set a default region and zone.

    REST

    Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

      Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante : 

      gcloud init

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .

Afficher les insights pour obtenir des recommandations de VM

Compute Engine génère des recommandations basées sur les insights liés aux ressources. Les recommandations incluent les recommandations concernant le type de machine et les recommandations concernant les VM inactives.

En affichant les insights associés à une VM spécifique, vous pouvez en savoir plus sur l'utilisation du processeur, de la mémoire et du réseau par votre VM.

Pour afficher les insights ayant généré une recommandation spécifique, utilisez la gcloud CLI ou l'API.

gcloud

Pour afficher le détail de tous les insights disponibles pour une zone spécifique, utilisez la commande insights list et spécifiez l'option --format.

gcloud recommender insights list --project=PROJECT_ID \
  --location=LOCATION \
  --insight-type=INSIGHT_TYPE_ID \
  --format=FORMAT

Remplacez les éléments suivants :

  • PROJECT_ID : par l'ID du projet.
  • LOCATION : la zone contenant les ressources pour lesquelles vous souhaitez afficher les insights.
  • INSIGHT_TYPE_ID : l'ID du type d'insight. Pour obtenir la liste des insights disponibles sur les VM, consultez la section Types d'insights sur les instances de VM.
  • FORMAT : le format de sortie souhaité (par exemple, json).

Une sortie type de la commande insights list utilisant le format de sortie json peut ressembler à ceci :

[
  {
    "associatedRecommendations": [
      {
        "recommendation": "projects/PROJECT_ID/locations/us-central1-a/recommenders/google.compute.instance.MachineTypeRecommender/recommendations/7618763b-fee2-42e5-8b9b-e6eee0b2077f"
      }
    ],
    "category": "PERFORMANCE",
    "content": {
      "predictedCpuCores": 0.15
    },
    "description": "Predicted CPU usage is 0.1 vCPUs.",
    "etag": "\"fdb51460cac758a0\"",
    "insightSubtype": "CPU_USAGE_PREDICTION",
    "lastRefreshTime": "2021-09-15T06:50:45Z",
    "name": "projects/PROJECT_ID/locations/us-central1-a/insightTypes/google.compute.instance.CpuUsagePredictionInsight/insights/cb2ab4e6-2c5e-4f0e-8cbe-1487e8bae8c0",
    "observationPeriod": "604800s",
    "severity": "LOW",
    "stateInfo": {
      "state": "ACTIVE"
    },
    "targetResources": [
      "//compute.googleapis.com/projects/PROJECT_ID/zones/us-central1-a/instances/instance-name-1"
    ]
  }
]

REST

Pour afficher le détail de tous les insights disponibles pour une zone spécifique, utilisez la méthode insights.list.

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE_ID/insights

Remplacez les éléments suivants :

  • PROJECT_ID : par l'ID du projet.
  • LOCATION : la zone contenant les ressources pour lesquelles vous souhaitez afficher les insights.
  • INSIGHT_TYPE_ID : l'ID du type d'insight. Pour obtenir la liste des insights disponibles sur les VM, consultez la section Types d'insights sur les instances de VM.

Une sortie type de la méthode insights.list peut se présenter comme suit :

[
  {
    "associatedRecommendations": [
      {
        "recommendation": "projects/PROJECT_ID/locations/us-central1-a/recommenders/google.compute.instance.MachineTypeRecommender/recommendations/7618763b-fee2-42e5-8b9b-e6eee0b2077f"
      }
    ],
    "category": "PERFORMANCE",
    "content": {
      "predictedCpuCores": 0.15
    },
    "description": "Predicted CPU usage is 0.1 vCPUs.",
    "etag": "\"fdb51460cac758a0\"",
    "insightSubtype": "CPU_USAGE_PREDICTION",
    "lastRefreshTime": "2021-09-15T06:50:45Z",
    "name": "projects/PROJECT_ID/locations/us-central1-a/insightTypes/google.compute.instance.CpuUsagePredictionInsight/insights/cb2ab4e6-2c5e-4f0e-8cbe-1487e8bae8c0",
    "observationPeriod": "604800s",
    "severity": "LOW",
    "stateInfo": {
      "state": "ACTIVE"
    },
    "targetResources": [
      "//compute.googleapis.com/projects/PROJECT_ID/zones/us-central1-a/instances/instance-name-1"
    ]
  }
]

Pour plus d'informations sur les insights, consultez la documentation de référence.

Types d'insights sur les instances de VM

Vous pouvez utiliser différents insights pour récupérer des informations sur les performances de vos VM. Chaque type d'insight possède des attributs de contenu spécifiques.

Les sections suivantes référencent les différents insights disponibles sur les VM.

Insights sur l'utilisation du processeur

Compute Engine génère des insights sur l'utilisation du processeur lorsque sur vos VM, celle-ci s'est révélée supérieure ou inférieure à la normale au cours de la dernière période d'observation.

L'ID de ce type d'insight est google.compute.instance.CpuUsageInsight.

Les sous-types disponibles sont les suivants :

  • HIGH_CPU_USAGE
  • LOW_CPU_USAGE

Ils sont associés à des descriptions d'insights telles que les suivantes :

  • In the last 12 days for 90% of the time, CPU usage was greater than or equal to 83%.
  • In the last 10 days for 70% of the time, CPU usage was lower than or equal to 20%.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur l'utilisation du processeur.

Attribut Type Description
points ARRAY Tableau d'objets. Chaque objet contient les propriétés suivantes :
  • sampleProbability : (DOUBLE) quantité relative d'échantillons d'utilisation du processeur inférieurs à la valeur de la fonction quantile.
  • quantileFunctionValue : (DOUBLE) limite supérieure de l'utilisation du processeur qui contient au moins une partie des échantillons (probabilité d'échantillonnage).
    La valeur représente le ratio du nombre total de processeurs virtuels et se situe dans la plage [0, 1].

Insights sur la prédiction d'utilisation du processeur

Compute Engine crée des insights sur la prédiction d'utilisation du processeur pour indiquer l'utilisation prédite du processeur pour le jour suivant.

L'ID de ce type d'insight est google.compute.instance.CpuUsagePredictionInsight.

Voici une description que ce type d'insight est susceptible de renvoyer :

  • Predicted CPU usage is 0.1 vCPUs.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur la prédiction d'utilisation du processeur.

Attribut Type Description
predicted_cpu_cores DOUBLE Quantité prédite de cœurs de processeur.

Insights sur les tendances d'utilisation du processeur

Compute Engine crée des insights sur les tendances d'utilisation du processeur lorsque l'utilisation du processeur indique une tendance à la hausse ou à la baisse au cours de la dernière période d'observation.

L'ID de ce type d'insight est google.compute.instance.CpuUsageTrendInsight.

Les sous-types disponibles sont les suivants :

  • CPU_USAGE_INCREASE
  • CPU_USAGE_DECREASE

Ils sont généralement associés à des descriptions d'insights telles que les suivantes :

  • In the last 7 days, average daily CPU usage has increased by 8% from 65% to 73%.
  • In the last 7 days, average daily CPU usage has decreased by 10% from 55% to 45%.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur les tendances d'utilisation du processeur.

Attribut Type Description
cpu_usage_percentage_at_start DOUBLE Mesure de la moyenne quotidienne de l'utilisation du processeur, au début de la période d'observation.

La valeur représente le pourcentage du nombre total de processeurs virtuels et se situe dans la plage [0, 100].

cpu_usage_percentage_at_end DOUBLE Mesure de la moyenne quotidienne de l'utilisation du processeur, à la fin de la période d'observation.

La valeur représente le pourcentage du nombre total de processeurs virtuels et se situe dans la plage [0, 100].

cpu_usage_percentage_change DOUBLE Prédiction de l'évolution de la moyenne quotidienne d'utilisation du processeur au cours de la période d'observation.

La prédiction utilise la régression linéaire pour modéliser l'évolution de l'utilisation quotidienne du processeur.

La valeur représente le pourcentage du nombre total de processeurs virtuels et se situe dans la plage [0, 100].

Insights sur l'utilisation de mémoire

Compute Engine génère des insights sur l'utilisation de la mémoire si celle-ci est particulièrement élevée ou faible au cours de la période d'observation.

L'ID de ce type d'insight est google.compute.instance.MemoryUsageInsight.

Les sous-types disponibles sont les suivants :

  • HIGH_MEMORY_USAGE
  • LOW_MEMORY_USAGE

Ils sont généralement associés à des descriptions d'insights telles que les suivantes :

  • In the last 12 days for 80% of the time, memory usage was greater than or equal to 64%.
  • In the last 7 days for 50% of the time, memory usage was lower than or equal to 10%.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur l'utilisation de mémoire.

Attribut Type Description
points ARRAY Tableau d'objets. Chaque objet contient les propriétés suivantes :
  • sampleProbability : (DOUBLE) quantité relative d'échantillons d'utilisation de mémoire sous la valeur de la fonction quantile.
  • quantileFunctionValue : (DOUBLE) limite supérieure de l'utilisation de mémoire qui contient au moins une partie des échantillons (probabilité d'échantillonnage).
    La valeur représente le ratio de la quantité totale de mémoire et se situe dans la plage [0, 1].

Insights sur la prédiction d'utilisation de mémoire

Compute Engine crée des insights sur la prédiction d'utilisation de mémoire pour indiquer l'utilisation de mémoire prédite le jour suivant.

L'ID de ce type d'insight est google.compute.instance.MemoryUsagePredictionInsight.

Voici une description que ce type d'insight est susceptible de renvoyer :

  • Predicted memory usage is 1536 MB.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur la prédiction d'utilisation de mémoire.

Attribut Type Description
predicted_memory_mb DOUBLE Quantité de mémoire prédite, exprimée en Mo.

Insights sur le débit du réseau

Compute Engine crée des insights sur le débit du réseau lorsque celui-ci est exceptionnellement faible pendant la période d'observation, pour le trafic entrant ou sortant.

L'ID de ce type d'insight est google.compute.instance.NetworkThroughputInsight.

Les sous-types disponibles sont les suivants :

  • LOW_RECEIVED_NETWORK_THROUGHPUT
  • LOW_SENT_NETWORK_THROGHPUT

Ils sont généralement associés à des descriptions d'insights telles que les suivantes :

  • In the last 7 days for 80% of the time, received network throughput was lower than or equal to 500 B/s.
  • In the last 7 days for 80% of the time, sent network throughput was lower than or equal to 200 B/s.

Le tableau suivant fournit des détails sur le contenu associé aux insights sur le débit du réseau.

Attribut Type Description
sample_probability DOUBLE Quantité relative d'échantillons de débit réseau sous la valeur de la fonction quantile.

La valeur se situe dans la plage [0, 1].

quantile_function_value_in_bytes_per_second DOUBLE Limite supérieure du débit réseau contenant au moins une partie des échantillons (probabilité d'échantillonnage). La valeur est exprimée en octets par seconde.

Étape suivante