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 Trusted Cloud by S3NS . 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init
    2. Set a default region and zone.

    REST

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

      Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

    Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Trusted 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