Документация / API / Json / Метрики / SendMetrics

---

Отправка набора метрик

АдресВашегоСервисаApi/SendMetrics

Для оптимизации работы можно передавать сразу множество метрик с помощью этого метода.
Для каждой переданной записи метод ищет у компонента метрику с указанным названием.
Если её нет, то метрика будет создана. При необходимости будет также создан тип метрики.
После этого записывается новое значение метрики.
Если новое значение совпадает со старым, то запись в истории не добавляется, а текущее значение метрики продляется.

{
    "Token": {
        "SecretKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    },
    "Data": [
        {
            "ComponentId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "Name": "MetricName",
            "Value": 100.5,
            "ActualIntervalSecs": 600
        },
        ...
    ]
}

Здесь:

• Token — раздел с токеном авторизации. В нём:
  • SecretKey (string) — ключ доступа к Api, посмотрите в Личном кабинете в разделе Управление — Ключи доступа к Api
• ComponentId (guid) — Уникальный Id компонента, для которого отправляется метрика.
• Name (string) — Название метрики. Используется для создания метрики и типа метрики, если их не удастся найти.
• Value (double) — Новое значение метрики. Может быть null.
• ActualIntervalSecs (double) — Интервал актуальности в секундах. Необязательный. Если не указан, то будет равен 1 часу. Итоговый интервал актуальности может быть перекрыт настройками в личном кабинете.

{
    "Data": "",
    "Code": 10
}

В ответе возвращается только код результата.

Метрики с некорректными данными будут проигнорированы, остальные обработаются успешно.
Метод не возвращает ошибки индивидуально для каждой метрики.