Обзор метрик телеметрии

1. Типы метрик

StarVault предоставляет три типа метрик телеметрии:

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

Измерители с высокой кардинальностью, например vault.kv.secret.count, обновляются с интервалом, заданным в строке телеметрии с параметром use_gauge_period. По умолчанию интервал отчетов для метрик датчиков составляет 10 минут.

2. Метки метрик

Некоторые метрики телеметрии поставляются с дополнительными метаданными, которые обеспечивают контекст измерения. Например, метрика токена может включать пространство имен, к которому она принадлежит, или метод аутентификации, использованный для ее создания.

Метаданные метрики маркируются и включаются в имя метрики для телеметрии in-memory и любого другого механизма телеметрии, который не поддерживает пользовательские метки.

За именем метрики в таблице ниже следует список поддерживаемых меток в том порядке, в котором они появляются, если они представлены в плоском формате.

Метрика Пример Описание

Метрика	Пример	Описание
`auth_method`	`userpass`	Тип механизма авторизации
`cluster`	`starvault-cluster-d54ad07`	Имя кластера, откуда поступила метрика
`creation_ttl`	`7d`	Время жизни (TTL), назначенное при создании, округляется в большую сторону: 1m, 10m, 20m, 1h, 2h, 1d, 2d, 7d, 30d или +Inf
`mount_point`	`auth/userpass/`	Путь, по которому смонтирован метод аутентификации или хранилище секретов
`name`	`memoryLimit`	Имя агрегируемого объекта (например, квота или правило квоты)
`namespace`	`root`	Путь к пространству имен или корень для корневого пространства имен
`policy`	`default`	Имя связанной политики
`token_type`	`service`	Тип связанного токена: batch или service
`peer_id`	`node-1`	Уникальный идентификатор узла в raft-кластере
`node_id`	`node-42`	Уникальный идентификатор узла в raft-кластере (дублирует peer_id)
`snapshot_config_name`	`config1`	Имя конфигурации, используемой для автоматических снимков

auth_method

userpass

Тип механизма авторизации

cluster

starvault-cluster-d54ad07

Имя кластера, откуда поступила метрика

creation_ttl

7d

Время жизни (TTL), назначенное при создании, округляется в большую сторону: 1m, 10m, 20m, 1h, 2h, 1d, 2d, 7d, 30d или +Inf

mount_point

auth/userpass/

Путь, по которому смонтирован метод аутентификации или хранилище секретов

name

memoryLimit

Имя агрегируемого объекта (например, квота или правило квоты)

namespace

root

Путь к пространству имен или корень для корневого пространства имен

policy

default

Имя связанной политики

token_type

service

Тип связанного токена: batch или service

peer_id

node-1

Уникальный идентификатор узла в raft-кластере

node_id

node-42

Уникальный идентификатор узла в raft-кластере (дублирует peer_id)

snapshot_config_name

config1

Имя конфигурации, используемой для автоматических снимков