Метаданные агента

При сборе метрик агент также собирает метаданные. Эти метаданные включают в себя информацию о собранных данных и об агенте, который их собрал.

Они не отображаются в таблице Данные веб интерфейса. Их можно получить запросами Получить метаданные для объекта и Получить метаданные для связи.

Поля метаданных

В агенте версии 5.0.0 было добавлено новое поле – headers, в котором хранится служебная информация.

timestamp

Время когда агент начал выполнять выбранный мониторинговый процесс.

Агент версии 5.0.0 и выше также включает эту информация в поле headers.sendTime.

entityId

ID объекта, чьи метаданные были получены.

entityType

Тип сущности, чьи метаданные были получены. Для объекта это 1; для связи – 2.

taskType

Тип сенсора. Подробную информацию можно найти на странице Встроенные сенсоры.

period

Период между выполнением процессом мониторинга (в миллисекундах).

agentId

ID агента.

Агент версии 5.0.0 и выше также включает эту информация в поле headers.agentId.

agentVersion

Версия агента.

Агент версии 5.0.0 и выше также включает эту информация в поле headers.version.

agentBuild

Номер сборки агента.

Агент версии 5.0.0 и выше также включает эту информация в поле headers.version.

payload

В объекте payload хранится мета-информация о каждом поле в собранных агентом данных.

Пример поля payload в метаданных сенсора Ping
{
...
    "payload": {
        "roundTripMaximum": {
            "changeRate": "ALWAYS"
        },
        "packetsReceived": {
            "changeRate": "SOMETIMES"
        },
        "packetLossPercentile": {
            "type": "PERCENTILE",
            "changeRate": "SOMETIMES"
        },
        ...
    },
...
}

payload.changeRate

Частота изменения данных.

Возможные значения:

  • ALWAYS — дата изменяется после каждого измерения.

  • SOMETIMES — данные изменяются периодично и будут игнорировать одинаковые значения.

  • NEVER — данные никогда не обновляются или возможность изменения очень мала.

payload.type

Тип данных, полученных от агента.

Возможные значения:

  • STRING

  • BOOLEAN

  • BYTE_QUANTITY

  • TIMESTAMP

  • PERCENTILE

  • ID

  • BINARY

  • LIST

headers

В объекте headers хранятся служебные заголовки для трассировки сообщений.

Поле headers записывается агентами только начиная с версии 5.0.0.

headers.agentId

ID агента.

Эта информация дублируется в поле agentId.

headers.version

Версия агента. Включает в себя как версию агента, так и номер сборки. Эта информацию дублируется в полях agentVersion и agentBuild.

headers.scheduleTime

Время получения задачи из брокера Kafka.

headers.traceId

Идентификатор выполненной проверки.

headers.startTime

Время начала выполнения проверки.

headers.completeTime

Время завершения выполнения проверки.

headers.sendTime

Время отправки результата в брокер Kafka.

Эта информация дублируется в поле timestamp.