Метод write

Статья создана

Обновлена 15 октября 2025 г.

HTTP-запрос
Query-параметры
Параметры в теле запроса
Ответ

Записывает данные метрик.

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. Например: `2025-05-15T15:30:00Z`. Где: `2025-05-15` — дата (год, месяц, день); `T` — разделитель между датой и временем; `15:30:00` — время (часы, минуты, секунды); `Z` — временная зона UTC.
labels	object Список меток общих для всех передаваемых метрик в формате `ключ:значение`.
metrics[]	object Список метрик.
metrics[]. name	string Обязательное поле. Имя метрики.
metrics[]. labels	object Список меток метрики в формате `ключ:значение`.
metrics[]. type	string Тип метрики. Значение по умолчанию — `DGAUGE`. DGAUGE: Числовой показатель. Задается дробным числом. IGAUGE: Числовой показатель. Задается целым числом. COUNTER: Счетчик.
metrics[]. ts	string (date-time) Временная метка в формате RFC3339. Если не указано, будет использовано текущее время.
metrics[]. value	number (double) Обязательное поле. Значение метрики в указанной точке.
metrics[]. timeseries[]	object Список из нескольких точек.
metrics[]. timeseries[]. ts	string (date-time) Временная точка в формате RFC3339. Например: `2025-05-15T15:30:00Z`. Где: `2025-05-15` — дата (год, месяц, день); `T` — разделитель между датой и временем; `15:30:00` — время (часы, минуты, секунды); `Z` — временная зона UTC.
metrics[]. timeseries[]. value	number (double) Значение метрики в указанной точке.

Ответ

HTTP Code: 200 - OK

{
  "writtenMetricsCount": "string",
  "errorMessage": "string"
}

Поле	Описание
writtenMetricsCount	string (int64) Количество успешно записанных метрик.
errorMessage	string Сообщение об ошибке, если запись завершилась неуспешно.

Метод write

HTTP-запросHTTP-запрос

Query-параметрыQuery-параметры

Параметры в теле запросаПараметры в теле запроса

ОтветОтвет

Была ли статья полезна?

HTTP-запрос

Query-параметры

Параметры в теле запроса

Ответ