Visualize e entenda os insights da instância de VM

Os insights de instâncias de máquinas virtuais (VMs) ajudam você 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 coletadas pelo Cloud Monitoring. Você pode usar insights para apoiar decisões sobre o redimensionamento dos tipos de máquinas para usar os recursos da VM com mais eficiência.

Para obter mais informações sobre insights, consulte Insights .

Antes de começar

  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Ver insights para recomendações de VM

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

Ao visualizar insights associados a uma VM específica, você pode saber mais sobre a CPU, a memória e o uso da rede da sua VM.

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

gcloud

Para visualizar detalhadamente todos os insights disponíveis para 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 o seguinte:

  • PROJECT_ID : o ID do seu projeto.
  • LOCATION : a zona que contém os recursos dos quais você deseja visualizar insights.
  • INSIGHT_TYPE_ID : o ID do tipo de insight . Para obter uma lista dos insights de VM disponíveis, consulte Tipos de insights de instância de VM .
  • FORMAT : seu 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 à seguinte.

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

DESCANSAR

Para visualizar detalhadamente todos os insights disponíveis para 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 o seguinte:

  • PROJECT_ID : o ID do seu projeto.
  • LOCATION : a zona que contém os recursos dos quais você deseja visualizar insights.
  • INSIGHT_TYPE_ID : o ID do tipo de insight . Para obter uma lista dos insights de VM disponíveis, consulte Tipos de insights de instância de VM .

Uma saída típica do método insights.list 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"
    ]
  }
]

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

Tipos de insights de instância de VM

Você pode usar insights diferentes para recuperar informações sobre o desempenho de suas VMs. Cada tipo de insight possui atributos de conteúdo específicos.

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

Informações sobre o uso da CPU

O Compute Engine cria insights de uso da CPU quando o uso da CPU das suas VMs foi maior ou menor do 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 estão associados 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 VARIEDADE Matriz de objetos. Cada objeto contém as seguintes propriedades:
  • sampleProbability : (DOUBLE) Quantidade relativa de amostras de uso de CPU abaixo do valor da função quantil.
  • quantileFunctionValue : (DOUBLE) Limite superior para uso de CPU que contém pelo menos parte (probabilidade de amostra) das amostras.
    O valor representa a proporção da quantidade total de vCPUs e está no intervalo [0, 1].

Insight de previsão de uso da CPU

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

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

Uma descrição típica que você pode encontrar 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 DOBRO Quantidade prevista de núcleos de CPU.

Insight de tendência de uso da CPU

O Compute Engine cria insights sobre tendências de uso da CPU quando o uso da 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

Geralmente estã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 DOBRO Média diária medida de 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 DOBRO Média diária medida 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 DOBRO Alteração 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 mudança no uso diário da CPU.

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

Informações sobre uso de memória

O Compute Engine cria insights de uso de 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

Geralmente estã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 de memória.

Atributo Tipo Descrição
points VARIEDADE Matriz de objetos. Cada objeto contém as seguintes propriedades:
  • sampleProbability : (DOUBLE) 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) das amostras.
    O valor representa a proporção da quantidade total de memória e está no intervalo [0, 1].

Insight de previsão de uso de 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 do 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 de uso de memória.

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

Visão da taxa de transferência da rede

O Compute Engine cria insights de capacidade de rede quando a capacidade da rede durante o período de observação é excepcionalmente baixa para o tráfego de entrada ou 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

Geralmente estã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 de taxa de transferência de rede.

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

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

quantile_function_value_in_bytes_per_second DOBRO Limite superior para a taxa de transferência da rede que contém pelo menos parte (probabilidade amostral) das amostras. O valor é expresso em bytes por segundo.

O que vem a seguir