Как работает плагин
Плагин PanDev Metrics работает внутри вашей IDE и собирает данные об активности автоматически. На этой странице описано, что отслеживает плагин, что считается активностью и откуда берутся данные.
Что считается активностью
Плагин использует евентную архитектуру — никаких таймеров и фонового опроса. Событие генерируется только тогда, когда вы совершаете реальное действие:
- Клик мышкой — нажатие кнопки мыши в редакторе или на элементах интерфейса.
- Печать — любой ввод с клавиатуры: написание кода, редактирование, переименование и т.д.
- Перемещение каретки — навигация стрелками, Home/End, Page Up/Down или любое другое перемещение текстового курсора.
:::danger Что НЕ является активностью
- Перемещение курсора мышки — простое движение указателя мыши по экрану не генерирует событий и не записывается.
- Открытая IDE без действий — если IDE просто открыта, но вы не взаимодействуете с ней, активность не фиксируется. Простаивающее окно не создаёт ни одного события. :::
Источники активности
В плагине отображается активность из трёх источников:
| Источник | Описание |
|---|---|
| IDE | Активность из плагинов IDE (IntelliJ IDEA, VS Code и др.) — написание кода, навигация, рефакторинг. |
| BROWSER | Активность из расширения Chrome на разрешённых корпоративных доменах — чтение документации, Jira, Confluence и т.д. |
| CLI | Активность из командной строки и терминальных сессий — выполнение команд, работа с git, запуск скриптов. |
Все три источника видны в панели активности плагина внутри IDE, что даёт полную картину вашей рабочей сессии.
Как обрабатываются события
- Захват события — плагин регистрирует каждое действие и создаёт JSON-событие с метаданными (проект, файл, ветка, позиция курсора, время).
- Расчёт активности — математические модели анализируют интервалы между событиями и определяют активное рабочее время. Если промежуток слишком большой, система считает его временем бездействия.
- Привязка к задаче — плагин считывает название текущей Git-ветки и автоматически связывает активность с соответствующей задачей в трекере (Jira, GitLab и др.).
- Доставка данных — события отправляются на сервер PanDev Metrics. Если сервер недоступен, события сохраняются в локальном кэше и автоматически синхронизируются при восстановлении соединения.
Что вы видите в IDE
После установки плагина и авторизации он работает незаметно в фоновом режиме. Вы можете проверить:
- Статус синхронизации — доставлены ли ваши данные на сервер.
- Разбивку по активности — время, разделённое на IDE, BROWSER и CLI.
- Текущую сессию — активность в реальном времени за текущую рабочую сессию.
После первоначальной настройки никаких дополнительных действий не требуется — плагин делает всё автоматически.