Ver e entender os insights da instância de VM

Os insights de instâncias de máquina virtual (VM) ajudam a entender o uso de CPU, memória e rede das VMs do Compute Engine. Os insights são gerados automaticamente com base nas métricas do sistema ou métricas coletadas pelo Cloud Monitoring. É possível usar insights para embasar decisões sobre o redimensionamento dos tipos de máquina para usar os recursos da VM com mais eficiência.

Para mais informações, consulte Insights.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

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

    Console

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

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Ver insights de recomendações de VM

O Compute Engine gera recomendações com base nos insights de recursos. As recomendações incluem recomendações de tipo de máquina e recomendações de VM inativas.

Ao ver insights associados a uma VM específica, é possível saber mais sobre o uso de CPU, memória e rede da sua VM.

Para visualizar os insights que geraram uma recomendação específica, use a CLI do gcloud ou a API.

gcloud

Para visualizar todos os insights disponíveis em detalhes sobre uma zona específica, use o comando insights list e forneça a opção --format.

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

Substitua:

  • PROJECT_ID: ID do projeto.
  • LOCATION: a zona que contém os recursos com os insights que você quer ver.
  • INSIGHT_TYPE_ID: o código do tipo de insight. Para uma lista dos insights de VM disponíveis, consulte Tipos de insights de instância de VM.
  • FORMAT: o formato de saída preferido, por exemplo, json.

Uma saída típica do comando insights list usando o formato de saída json pode ser semelhante a esta:

[
  {
    "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

Para ver todos os insights disponíveis em detalhes sobre uma zona específica, use o método insights.list.

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

Substitua:

Uma saída típica do método insights.list pode ser assim:

[
  {
    "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"
    ]
  }
]

Para mais informações sobre insights, consulte os documentos de referência.

Tipos de insights de instância de VM

É possível usar diferentes insights para recuperar informações sobre o desempenho de suas VMs. Cada tipo de insight tem atributos de conteúdo específicos.

As seções a seguir mostram uma referência para os insights de VM disponíveis.

Insight sobre o uso da CPU

O Compute Engine cria insights de uso da CPU quando o uso das VMs é maior ou menor que o normal no último período de observação.

O ID do tipo de insight é google.compute.instance.CpuUsageInsight.

Os subtipos disponíveis são:

  • HIGH_CPU_USAGE
  • LOW_CPU_USAGE

Eles são associadas a descrições de insights como as seguintes:

  • 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%.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights de uso da CPU.

Atributo Tipo Descrição
points ARRAY Matriz de objetos. Cada objeto contém as seguintes propriedades:
  • sampleProbability: (DUPLO) Valor relativo de amostras de uso de CPU abaixo do valor da função quantil.
  • quantileFunctionValue: (DOUBLE) limite superior para uso da CPU que contém pelo menos parte (probabilidade de amostra) de amostras.
    O valor representa a proporção do valor total de vCPUs e está no intervalo [0, 1].

Insight da previsão de uso da CPU

O Compute Engine cria insights de previsão de uso da CPU para indicar o uso previsto para o dia seguinte.

O ID do tipo de insight é google.compute.instance.CpuUsagePredictionInsight.

Uma descrição típica que você encontra neste insight é semelhante a esta:

  • Predicted CPU usage is 0.1 vCPUs.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights de previsão de uso da CPU.

Atributo Tipo Descrição
predicted_cpu_cores DOUBLE Quantidade prevista de núcleos de CPU.

Insight de tendências de uso da CPU

O Compute Engine cria insights de tendência de uso da CPU quando o uso de CPU mostra uma tendência crescente ou decrescente no último período de observação.

O ID do tipo de insight é google.compute.instance.CpuUsageTrendInsight.

Os subtipos disponíveis são:

  • CPU_USAGE_INCREASE
  • CPU_USAGE_DECREASE

Eles geralmente são associados a descrições de insights, como as seguintes:

  • 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%.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights de tendências de uso da CPU.

Atributo Tipo Descrição
cpu_usage_percentage_at_start DOUBLE Média diária medida do uso da CPU no início do período de observação.

O valor representa a porcentagem do número total de vCPUs e está no intervalo [0, 100].

cpu_usage_percentage_at_end DOUBLE Média diária de uso da CPU no final do período de observação.

O valor representa a porcentagem do número total de vCPUs e está no intervalo [0, 100].

cpu_usage_percentage_change DOUBLE Mudança prevista da média diária de uso da CPU durante o período de observação.

A previsão usa regressão linear para modelar a alteração do uso diário da CPU.

O valor representa a porcentagem do número total de vCPUs e está no intervalo [0, 100].

Insight sobre o uso da memória

O Compute Engine cria insights de uso da memória se o uso de memória for excepcionalmente alto ou baixo durante o período de observação.

O ID do tipo de insight é google.compute.instance.MemoryUsageInsight.

Os subtipos disponíveis são:

  • HIGH_MEMORY_USAGE
  • LOW_MEMORY_USAGE

Eles geralmente são associados a descrições de insights, como as seguintes:

  • 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%.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights de uso da memória.

Atributo Tipo Descrição
points ARRAY Matriz de objetos. Cada objeto contém as seguintes propriedades:
  • sampleProbability: (DUPLO) Quantidade relativa de amostras de uso de memória abaixo do valor da função quantil.
  • quantileFunctionValue: (DOUBLE) limite superior para uso de memória que contém pelo menos parte (probabilidade de amostra) de amostras.
    O valor representa a proporção da quantidade total de memória e está no intervalo [0, 1].

Insight da previsão de uso da memória

O Compute Engine cria insights de previsão de uso de memória para indicar o uso de memória previsto para o dia seguinte.

O ID do tipo de insight é google.compute.instance.MemoryUsagePredictionInsight.

Uma descrição típica de insight é a seguinte:

  • Predicted memory usage is 1536 MB.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights de previsão do uso da memória.

Atributo Tipo Descrição
predicted_memory_mb DOUBLE Quantidade prevista de memória expressa em MB.

Insight sobre a capacidade da rede

O Compute Engine cria insights de capacidade da rede quando a capacidade da rede durante o período de observação é excepcionalmente baixa para o tráfego de entrada ou de saída.

O ID do tipo de insight é google.compute.instance.NetworkThroughputInsight.

Os subtipos disponíveis são:

  • LOW_RECEIVED_NETWORK_THROUGHPUT
  • LOW_SENT_NETWORK_THROGHPUT

Eles geralmente são associados a descrições de insights, como as seguintes:

  • 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.

A tabela a seguir fornece alguns detalhes sobre o conteúdo associado aos insights da capacidade de rede.

Atributo Tipo Descrição
sample_probability DOUBLE Quantidade relativa de amostras de capacidade de rede abaixo do valor da função quantil.

O valor está no intervalo [0, 1].

quantile_function_value_in_bytes_per_second DOUBLE Limite superior para capacidade de rede que contém pelo menos parte (probabilidade de amostra) de amostras. O valor é expresso em bytes por segundo.

A seguir