Obter métricas de uso da Máquina Virtual usando a API REST

Artigo
10/15/2024

Aplica-se a: ✔️ VMs do Linux ✔️ Conjuntos de dimensionamento flexíveis

Este exemplo mostra como recuperar o uso da CPU para uma Máquina Virtual do Linux usando a API REST do Azure.

A documentação de referência completa e os exemplos da API REST estão disponíveis no Artigo de referência REST do Azure Monitor.

Criar a solicitação

Use a solicitação GET a seguir para coletar a Métrica de CPU de porcentagem de uma máquina virtual.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

Cabeçalhos da solicitação

Os cabeçalhos a seguir são necessários:

Cabeçalho da solicitação	Descrição
Tipo de Conteúdo:	Obrigatórios. Defina como `application/json`.
Autorização:	Obrigatórios. Defina como um token de acesso `Bearer` válido.

Parâmetros do URI

Nome	Descrição
subscriptionId	A ID de assinatura que identifica uma assinatura do Azure. Se você tiver várias assinaturas, consulte Trabalhando com várias assinaturas.
resourceGroupName	O nome do grupo de recursos do Azure associado ao recurso. É possível obter esse valor na API do Azure Resource Manager, na CLI ou no portal.
vmname	O nome da Máquina Virtual do Azure.
metricnames	Lista separada por vírgulas de métricas válidas do Load Balancer.
api-version	A versão da API a ser usada para a solicitação. Este documento abrange a versão da API `2018-01-01`, incluída na URL acima.
TimeSpan	Cadeia de caracteres com o seguinte formato `startDateTime_ISO/endDateTime_ISO` que define o intervalo de tempo das métricas retornadas. Este parâmetro opcional está configurado para retornar dados de um dia no exemplo.

Corpo da solicitação

Nenhum corpo de solicitação é necessário para esta operação.

Tratar da resposta

O código de status 200 é retornado quando a lista de valores da métrica é retornada com êxito. Uma lista completa de códigos de erro está disponível na documentação de referência.

Exemplo de resposta

{
    "cost": 0,
    "timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}

Compartilhar via