Custom sessions monitor

Расширение custom-sessions-monitor для Ключ-АСТРОМ

Расширение custom-sessions-monitor предназначено для сбора статистики активных пользователей кластера Ключ-АСТРОМ. Оно подключается к Cluster API и передаёт метрики, позволяющие анализировать вовлечённость пользователей.

Возможности

• Сбор метрик MAU (Monthly Active Users) и DAU (Daily Active Users).
• Настраиваемое расписание запуска: ежедневно или еженедельно с указанием дня недели и времени.
• Поддержка проверки или отключения проверки TLS/SSL-сертификата.
• Аутентификация через API-токен кластера.
• Автоматическая отправка собранных метрик в Ключ-АСТРОМ.

Конфигурация

Для настройки расширения используются следующие поля:

Поле	Описание
cluster_url	URL кластера, например https://ka.example.local.
cluster_token	API-токен для доступа к Cluster API.
ssl_verify	Проверка TLS/SSL-сертификата: true — проверять, false — не проверять.
use_weekly_schedule	Включает фиксированное расписание запуска. Если false, сбор выполняется не чаще одного раза в сутки по внутреннему интервалу.
schedule_frequency	Частота запуска: daily или weekly.
schedule_day_of_week	День недели для weekly: MON..SUN или 0..6.
schedule_time	Время запуска в формате HH:MM, например 12:00.
schedule_timezone_offset	Часовой пояс расписания, например +03:00.

Требования к токену кластера

Scope токена кластера должен включать:

• Управление токенами кластера
• API поставщика сервисов

Метрики

Расширение отправляет следующие метрики:

Метрика	Описание
custom.sessions_monitor.mau	Количество уникальных пользователей за последние 30 дней (Monthly Active Users).
custom.sessions_monitor.dau	Количество уникальных пользователей за последние 1 день (Daily Active Users).

Работа расширения

• Если use_weekly_schedule установлен в false, расширение выполняет сбор данных не чаще одного раза в сутки, руководствуясь внутренним интервалом.
• Если включено фиксированное расписание, сбор происходит в указанное время с учётом дня недели и часового пояса.

См. также

• Мониторинг кластера Ключ-АСТРОМ
• API поставщика сервисов