Посмотреть метрики в Yandex Monitoring
Чтобы выгрузить данные метрики, воспользуйтесь методом read.
Перед началом работы
Чтобы воспользоваться примерами в этом разделе:
- Убедитесь, что у вас установлена утилита cURL
, используемая в примерах. - Получите идентификатор каталога, на который у вас есть роль
monitoring.viewer
или выше. - Получите IAM-токен:
- Инструкция для пользователя с аккаунтом на Яндексе.
- Инструкция для сервисного аккаунта.
- Инструкция для федеративного аккаунта.
Получение метрик CPU
-
Создайте файл с телом запроса, например
body.json
:Например, запрос ниже получает данные метрики с загрузкой CPU виртуальной машины с идентификатором
epdpfhoh1r83********
в период с 00:00 UTC 24 июля до 00:00 UTC 31 июля.body.json:
{ "query": "cpu_usage{service=\"compute\", resource_id=\"epdpfhoh1r83********\"}", "fromTime": "2021-07-24T00:00:00Z", "toTime": "2021-07-31T00:00:00Z", "downsampling": { "maxPoints": 10 } }
Где:
query
— текст запроса:cpu_usage
— загрузка CPU.resource_id
— идентификатор виртуальной машины.
fromTime
— начало периода.toTime
— конец периода.
-
Отправьте запрос и сохраните ответ в файл, например
output.json
:export IAM_TOKEN=CggaATEVAgA... curl \ --request POST \ --header "Content-Type: application/json" \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --data '@body.json' \ 'https://monitoring.api.cloud.yandex.net/monitoring/v2/data/read?folderId=b2ghmo15rmnl********' > output.json
Пример ответа на запрос:
output.json:
{ "metrics": [ { "type": "DGAUGE", "name": "cpu_usage", "labels": { "resource_type": "vm", "cluster": "b2ghmo15rmnl********", "project": "b1gbkpesobgv********", "resource_id": "epdpfhoh1r83********", "service": "compute" }, "timeseries": { "timestamps": [ 1562069440800, 1562405369712, 1562741298624, 1563077227536, 1563413156448, 1563749085360, 1564085014272, 1564420943184 ], "doubleValues": [ 53.6475600118669, 65.5547751323391, 70.7148916473759, 49.4514634827568, 54.3817816479781, 81.9327383032693, 99.3035341016667, 99.982002860023 ] } } ] }
Получение метрик диска
-
Создайте файл с телом запроса, например
body.json
:Например, запрос ниже получает данные метрики с загрузкой диска в период с 00:00 UTC 9 августа до 00:00 UTC 10 августа.
body.json:
{ "query": "disk.read_bytes{service=\"compute\", disk=\"fhmhpdpidgen********\"}", "fromTime": "2025-08-09T00:00:00Z", "toTime": "2025-08-10T00:00:00Z", "downsampling": { "maxPoints": 10 } }
Где:
query
— текст запроса:disk.read_bytes
— количество байт, прочитанных с диска.service="compute"
— сервис, к которому относится метрика.disk="fhmhpdpidgen********"
— идентификатор конкретного диска.
fromTime
— начало периода.toTime
— конец периода.
-
Отправьте запрос и сохраните ответ в файл, например
output.json
:export IAM_TOKEN=... curl \ --request POST \ --header "Content-Type: application/json" \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --data '@body.json' \ 'https://monitoring.api.cloud.yandex.net/monitoring/v2/data/read?folderId=b1gsm0k26v1l********' > output.json
Пример ответа на запрос:
output.json:
{ "metrics": [ { "name": "disk.read_bytes", "labels": { "disk": "fhmhpdpidgen********", "instance": "for-backup", "service": "compute" }, "type": "RATE", "timeseries": { "timestamps": [ 1754697600000, 1754707200000, 1754716800000, 1754726400000, 1754736000000, 1754745600000, 1754755200000, 1754764800000, 1754774400000 ], "doubleValues": [ 457.38666666666666, 525.6533333333333, 122.45333333333333, 442.88, 419.4133333333333, 360.1066666666667, 387.41333333333336, 381.8666666666667, 561.4933333333333 ] } } ] }
Также метрики можно посмотреть в консоли управления