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 da seguinte maneira.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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
.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.HIGH_CPU_USAGE
LOW_CPU_USAGE
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%.
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].Predicted CPU usage is 0.1 vCPUs.
CPU_USAGE_INCREASE
CPU_USAGE_DECREASE
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%.
HIGH_MEMORY_USAGE
LOW_MEMORY_USAGE
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%.
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].Predicted memory usage is 1536 MB.
LOW_RECEIVED_NETWORK_THROUGHPUT
LOW_SENT_NETWORK_THROGHPUT
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.
- Saiba mais sobre as recomendações de tipo de máquina que o Compute Engine cria com base nos insights.
- Saiba mais sobre recomendações de VM inativas.
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:
Uma saída típica do comando
insights list
usando o formato de saídajson
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:
Eles são associadas a descrições de insights como as seguintes:
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:
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:
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:
Eles geralmente são associados a descrições de insights, como as seguintes:
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:
Eles geralmente são associados a descrições de insights, como as seguintes:
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: 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:
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:
Eles geralmente são associados a descrições de insights, como as seguintes:
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
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-24 UTC.
-