Метод write
Статья создана
Обновлена 15 октября 2025 г.
Записывает данные метрик.
HTTP-запрос
POST https://monitoring.api.cloud.yandex.net/monitoring/v2/data/write
Query-параметры
| Параметр | Описание |
|---|---|
| folderId | Обязательное поле. Идентификатор каталога, которому принадлежит метрика. Максимальная длина строки в символах — 50. |
| service | Обязательное поле. Идентификатор сервиса, которому принадлежит метрика. Используйте service=custom для пользовательских метрик. Максимальная длина строки в символах — 50. |
Параметры в теле запроса
{
"ts": "string",
"labels": "object",
"metrics": [
{
"name": "string",
"labels": "object",
"type": "string",
"ts": "string",
"value": "number",
"timeseries": [
{
"ts": "string",
"value": "number"
}
]
}
]
}
| Поле | Описание |
|---|---|
| ts | string (date-time) Общая временная метка для всех метрик в формате RFC3339. Например: Где:
|
| labels | object Список меток общих для всех передаваемых метрик в формате |
| metrics[] | object Список метрик. |
| metrics[]. name |
string Обязательное поле. Имя метрики. |
| metrics[]. labels |
object Список меток метрики в формате |
| metrics[]. type |
string Тип метрики. Значение по умолчанию —
|
| metrics[]. ts |
string (date-time) Временная метка в формате RFC3339. Если не указано, будет использовано текущее время. |
| metrics[]. value |
number (double) Обязательное поле. Значение метрики в указанной точке. |
| metrics[]. timeseries[] |
object Список из нескольких точек. |
| metrics[]. timeseries[]. ts |
string (date-time) Временная точка в формате RFC3339. Например: Где:
|
| metrics[]. timeseries[]. value |
number (double) Значение метрики в указанной точке. |
Ответ
HTTP Code: 200 - OK
{
"writtenMetricsCount": "string",
"errorMessage": "string"
}
| Поле | Описание |
|---|---|
| writtenMetricsCount | string (int64) Количество успешно записанных метрик. |
| errorMessage | string Сообщение об ошибке, если запись завершилась неуспешно. |