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

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

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

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

NOTE

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

timestamp

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

NOTE

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

entityId

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

entityType

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

taskType

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

period

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

agentId

ID агента.

NOTE

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

agentVersion

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

NOTE

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

agentBuild

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

NOTE

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

payload

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

{
...
    "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.