IDE-плагины: как отслеживать активность в VS Code, IntelliJ, Eclipse, Xcode и других
Коммиты и pull requests показывают, что было доставлено. IDE-плагины показывают, что происходило во время разработки — сколько времени было потрачено на кодирование, какие файлы были затронуты и когда разработчики были наиболее активны.
PanDev Metrics предлагает плагины для VS Code, JetBrains (IntelliJ, PhpStorm, WebStorm), Eclipse, Xcode, Visual Studio, PL/SQL Developer, расширение для Chrome и CLI для всего остального. Это руководство охватывает установку и настройку для всех.
Как работает отслеживание в IDE
Каждый IDE-плагин PanDev работает одинаково под капотом:
- Плагин обнаруживает активность кодирования — нажатия клавиш, сохранение файлов, переключение между файлами, сессии отладки
- Он записывает heartbeats — лёгкие события с меткой времени, путём к файлу, именем проекта, языком и типом активности
- Heartbeats пакетно отправляются на API PanDev каждые 2 минуты
- PanDev агрегирует heartbeats в сессии кодирования — непрерывные окна активности с перерывами менее 5 минут
Содержимое кода никогда не отправляется. PanDev отслеживает только метаданные: имена файлов, имена проектов, метки времени и языки.
Что считается «активным» временем
| Активность | Отслеживается? |
|---|---|
| Набор кода | Да |
| Навигация между файлами | Да |
| Использование дебаггера | Да |
| Запуск тестов из IDE | Да |
| Чтение кода (прокрутка, нет нажатий клавиш 5+ мин) | Нет |
| IDE открыта, но свёрнута | Нет |
| Митинги на другом экране | Нет |
Порог неактивности в 5 минут настраивается для каждой организации.
Перед началом: получите API-ключ
Каждому плагину нужен API-ключ для аутентификации в PanDev:
- Войдите в PanDev Metrics
- Перейдите в Profile → API Key
- Нажмите Generate Key (или скопируйте существующий)
Ваш API-ключ: pdm_k_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Вы будете использовать этот ключ при настройке плагина. Он привязан к вашему личному аккаунту — каждый разработчик генерирует свой собственный.
VS Code
Самая популярная IDE среди наших пользователей. Установка занимает 30 секунд.
Установка
- Откройте VS Code
- Перейдите в Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Найдите "PanDev Metrics"
- Нажмите Install
Или установите через командную строку:
code --install-extension pandev.pandev-metrics
Настройка
После установки VS Code запросит ваш API-ключ:
- Появится уведомление: "PanDev Metrics: Enter your API key"
- Вставьте API-ключ и нажмите Enter
Или настройте вручную в settings.json:
{
"pandev.apiKey": "pdm_k_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"pandev.apiUrl": "https://api.pandev-metrics.com"
}
Для on-premise развёртываний измените apiUrl на URL вашего внутреннего инстанса PanDev.
Проверка
- Откройте любой проект и наберите несколько символов
- Проверьте строку состояния VS Code — вы должны увидеть иконку PanDev с зелёной точкой
- В PanDev Metrics перейдите в Dashboard → Activity Feed — ваша сессия кодирования должна появиться в течение 2 минут
Настройки, специфичные для VS Code
{
"pandev.apiKey": "pdm_k_xxxx",
"pandev.apiUrl": "https://api.pandev-metrics.com",
"pandev.excludeFiles": [
"*.log",
"*.lock",
"node_modules/**"
],
"pandev.projectDetection": "git",
"pandev.debug": false
}
| Настройка | Описание |
|---|---|
excludeFiles | Glob-паттерны для игнорируемых файлов |
projectDetection | Как определять имя проекта: git (из remote URL), folder (из имени папки) или custom |
debug | Включить подробное логирование в панели Output |
JetBrains (IntelliJ IDEA, PhpStorm, WebStorm, PyCharm, GoLand, Rider)
Один плагин покрывает всё семейство JetBrains.
Установка
- Откройте вашу JetBrains IDE
- Перейдите в Settings → Plugins → Marketplace
- Найдите "PanDev Metrics"
- Нажмите Install → Restart IDE
Или установите через JetBrains Toolbox CLI:
# Пример для IntelliJ IDEA
idea installPlugins pandev.pandev-metrics
Настройка
После перезапуска появится диалог настройки:
- Вставьте API-ключ
- (Опционально) Укажите API URL для on-premise развёртываний
- Нажмите Save
Конфигурация хранится в:
~/.config/JetBrains/IntelliJIdea2025.3/options/pandev.xml
Проверка
- Откройте проект, внесите правки
- Проверьте строку состояния справа внизу — найдите иконку PanDev
- Нажмите на неё, чтобы увидеть статистику текущей сессии: время кодирования за сегодня, текущий проект, последний отправленный heartbeat
Настройки, специфичные для JetBrains
Settings → Tools → PanDev Metrics
API Key: pdm_k_xxxx
API URL: https://api.pandev-metrics.com
Timeout (sec): 30
Exclude patterns: *.log, *.lock, build/**, .idea/**
Log level: INFO
Eclipse
Пользователи Eclipse не забыты. Плагин PanDev работает с Eclipse 2023-03 и новее.
Установка
- Откройте Eclipse
- Перейдите в Help → Eclipse Marketplace
- Найдите "PanDev Metrics"
- Нажмите Install → следуйте мастеру → Restart Eclipse
Или установите через update site:
Help → Install New Software → Add...
Name: PanDev Metrics
URL: https://plugins.pandev-metrics.com/eclipse/
Настройка
- Перейдите в Window → Preferences → PanDev Metrics
- Введите API-ключ
- Нажмите Apply and Close
Проверка
Проверьте строку состояния Eclipse (внизу) — найдите иконку PanDev. Наведите курсор для проверки статуса подключения.
Xcode
Для разработчиков iOS и macOS.
Установка
Плагин для Xcode распространяется как macOS-приложение, работающее как фоновый сервис:
brew install --cask pandev-metrics
Или скачайте с pandev-metrics.com/downloads.
Настройка
- Запустите PanDev Metrics из Applications
- Приложение появится в меню-баре
- Нажмите на иконку в меню-баре → Settings
- Введите API-ключ
- Предоставьте разрешения accessibility при запросе (необходимо для обнаружения активности Xcode)
System Settings → Privacy & Security → Accessibility
✅ PanDev Metrics
Как это работает
В отличие от традиционных IDE-плагинов, интеграция с Xcode мониторит активный процесс Xcode на уровне ОС. Она обнаруживает:
- События открытия/сохранения файлов
- Смену активного файла
- События сборки и запуска
- Сессии отладки
Проверка
- Откройте проект Xcode и начните кодировать
- Нажмите на иконку PanDev в меню-баре — она покажет информацию о текущей сессии
- Проверьте дашборд PanDev Metrics — активность должна появиться в течение 2 минут
Visual Studio (Windows)
Для .NET, C++ и других разработчиков Visual Studio.
Установка
- Откройте Visual Studio
- Перейдите в Extensions → Manage Extensions
- Найдите "PanDev Metrics"
- Нажмите Download → Перезапустите Visual Studio для завершения установки
Или установите через VSIX-пакет:
# Скачайте с pandev-metrics.com/downloads
code --install-extension pandev-metrics.vsix
Настройка
- Перейдите в Tools → Options → PanDev Metrics
- Введите API-ключ
- Нажмите OK
Особенности Visual Studio
- Поддерживает Visual Studio 2019 и новее
- Отслеживает C#, C++, F#, VB.NET и все остальные языки Visual Studio
- Имя решения используется как имя проекта по умолчанию
PL/SQL Developer
Для разработчиков баз данных Oracle, использующих PL/SQL Developer.
Установка
- Скачайте DLL плагина PanDev с pandev-metrics.com/downloads
- Скопируйте его в директорию плагинов PL/SQL Developer:
C:\Program Files\PLSQL Developer\PlugIns\pandev-metrics.dll
- Перезапустите PL/SQL Developer
- Перейдите в Tools → Configure Plug-Ins → включите PanDev Metrics
Настройка
После включения появится диалог конфигурации:
- Введите API-ключ
- Укажите API URL (по умолчанию или on-premise)
- Нажмите Save
Что отслеживается
- Активное редактирование в SQL-окнах
- Редактирование пакетов, процедур и функций
- Время в SQL beautifier и конструкторе запросов
Расширение Chrome
Расширение Chrome отслеживает время на сайтах, связанных с разработкой:
Установка
- Зайдите в Chrome Web Store и найдите "PanDev Metrics"
- Нажмите Add to Chrome
- Нажмите на иконку расширения → введите API-ключ
Что отслеживается
Расширение отслеживает время только на сайтах, связанных с разработкой:
Отслеживаемые домены (по умолчанию):
✅ github.com
✅ gitlab.com
✅ bitbucket.org
✅ stackoverflow.com
✅ developer.mozilla.org (MDN)
✅ docs.microsoft.com
✅ Ваш инстанс Jira / ClickUp (настраивается)
Не отслеживаются:
❌ Социальные сети
❌ Электронная почта
❌ Интернет-магазины
❌ Всё остальное
Список доменов можно настроить в настройках расширения.
Конфиденциальность
Расширение Chrome отправляет в PanDev только имя домена и заголовок страницы — никогда полный URL, содержимое страницы или какие-либо конфиденциальные данные. Его можно полностью отключить для определённых доменов.
CLI (командная строка)
Для редакторов без поддержки плагинов (Vim, Neovim, Emacs, nano) или пользовательских сред разработки.
Установка
# macOS / Linux
curl -fsSL https://get.pandev-metrics.com/cli | sh
# Или через менеджеры пакетов
brew install pandev-cli # macOS
sudo apt install pandev-cli # Debian/Ubuntu
sudo yum install pandev-cli # RHEL/CentOS
Настройка
pandev-cli setup
# Введите API-ключ при запросе
# Конфигурация сохранена в ~/.pandev/config.toml
Файл конфигурации:
# ~/.pandev/config.toml
api_key = "pdm_k_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
api_url = "https://api.pandev-metrics.com"
exclude_patterns = ["*.log", "*.lock", "node_modules/**"]
Использование с Vim/Neovim
Добавьте хук на сохранение файла в .vimrc или init.vim:
autocmd BufWritePost * silent! execute '!pandev-cli heartbeat --file ' . shellescape(expand('%:p')) . ' --project ' . shellescape(fnamemodify(getcwd(), ':t')) . ' &'
Для Neovim доступен специализированный Lua-плагин:
-- ~/.config/nvim/lua/plugins/pandev.lua
return {
"pandev-metrics/pandev.nvim",
config = function()
require("pandev").setup({
api_key = os.getenv("PANDEV_API_KEY"),
})
end,
}
Использование с Emacs
;; ~/.emacs.d/init.el
(use-package pandev
:ensure t
:config
(setq pandev-api-key (getenv "PANDEV_API_KEY"))
(global-pandev-mode 1))
Ручные heartbeats
Для пользовательских интеграций отправляйте heartbeats напрямую:
pandev-cli heartbeat \
--file /path/to/file.py \
--project my-project \
--language python \
--activity coding
Проверка работоспособности
После установки плагинов на машинах вашей команды проверьте поток данных:
Индивидуальная проверка
Каждый разработчик может проверить в Profile → Activity → Today:
Активность за сегодня
━━━━━━━━━━━━━━━
Общее время кодирования: 2ч 34м
Проекты: backend-api (1ч 48м), frontend (46м)
Языки: Python (1ч 12м), TypeScript (52м), SQL (30м)
Редакторы: VS Code (1ч 48м), IntelliJ IDEA (46м)
Последний heartbeat: 12 секунд назад ✅
Проверка администратором
Как администратор, проверьте в Settings → Team → Plugin Status:
Developer Plugin Version Last Heartbeat Status
──────────────────────────────────────────────────────────────────────
Alice Wong VS Code 2.4.1 2 мин назад ✅ Активен
Bob Park IntelliJ IDEA 2.4.0 5 мин назад ✅ Активен
Chen Li VS Code 2.3.8 3 дня назад ⚠️ Устарел
Diana Ray Eclipse 2.4.1 1 мин назад ✅ Активен
Erik Svensson — — Никогда ❌ Не установлен
Свяжитесь с разработчиками, у которых статус "Устарел" или "Не установлен" — типичные проблемы: истёкшие API-ключи или корпоративный прокси, блокирующий соединение.
Решение проблем
| Проблема | Решение |
|---|---|
| Плагин установлен, но нет данных в PanDev | Проверьте API-ключ. Перегенерируйте, если не уверены |
| "Connection timeout" в логах плагина | Корпоративный прокси или файрвол блокирует api.pandev-metrics.com. Настройте параметры прокси в плагине или добавьте домен в белый список |
| Активность показывает 0 минут, хотя кодировали | Проверьте паттерны исключения файлов — возможно, вы исключаете файлы, которые редактируете |
| Неправильное имя проекта | Настройте параметр projectDetection. Для git-определения убедитесь, что в папке есть .git директория с remote URL |
| Несколько редакторов считают двойное время | PanDev дедуплицирует пересекающиеся heartbeats. Если VS Code и Chrome активны одновременно, каждый получает свой тип активности |
Конфиденциальность и данные
IDE-плагины PanDev собирают только метаданные:
- Путь и имя файла
- Имя проекта (из git remote или имени папки)
- Язык программирования
- Метка времени
- Имя и версия редактора
- Тип активности (кодирование, отладка, сборка)
Никогда не собираются: содержимое файлов, фрагменты кода, данные буфера обмена, нажатия клавиш, скриншоты или что-либо, что может раскрыть исходный код.
Все данные шифруются при передаче (TLS 1.3) и при хранении (AES-256). Для максимального контроля разверните PanDev on-premise и храните все данные в своей сети.
Начните отслеживать реальное время кодирования. Установите плагины PanDev для вашей команды за считанные минуты. Начните на PanDev Metrics.
