Расширения для браузеров
Расширение PanDev Metrics записывает, какими веб-инструментами пользуются разработчики (домен + заголовок страницы + время), чтобы часы в документации, дашбордах и AI-ассистентах попадали в PanDev Metrics рядом с данными из IDE и Git.
Расширение — это тонкий клиент, который смотрит за активной вкладкой и шлёт browser events на сервер PanDev Metrics. Содержимое страниц, значения форм, скриншоты и DOM никогда не собираются.
Кратко
| Свойство | Значение |
|---|---|
| Назначение | Учёт времени в веб-инструментах |
| Собирается | Домен, заголовок страницы, время на странице |
| Не собирается | Контент страницы, формы, скриншоты, DOM |
| Whitelist | Настраивает организация (admin) |
| Blacklist | Настраивает каждый юзер для себя |
| Backend endpoint | /v1/browser-events |
| Конфигурация в UI | Настройки → Настройки браузера |
Поддерживаемые браузеры
PanDev Metrics поставляет расширения для 10 браузеров. Chromium-браузеры ставятся из Chrome Web Store; Firefox — из Firefox Add-ons.
| Браузер | Магазин | Установка |
|---|---|---|
| Google Chrome | Chrome Web Store | Chrome |
| Mozilla Firefox | Firefox Add-ons | Firefox |
| Microsoft Edge | Chrome Web Store | Edge |
| Yandex Browser | Chrome Web Store | Yandex |
| Opera | Chrome Web Store | Opera |
| Arc | Chrome Web Store | Arc |
| Brave | Chrome Web Store | Brave |
| Sidekick | Chrome Web Store | Sidekick |
| Vivaldi | Chrome Web Store | Vivaldi |
| Whale (Naver) | Chrome Web Store | Whale |
Один и тот же билд расширения работает во всех Chromium-форках. Для Firefox — отдельная сборка.
Модель трекинга
PanDev Metrics использует двухслойный фильтр: организация определяет, что можно трекать, а каждый юзер может вычесть из этого ещё что-то для себя.
Whitelist (уровень организации)
Whitelist настраивает администратор в Настройки → Настройки браузера. Это список доменов и категорий, которые интересуют организацию — обычно сайты документации, внутренние инструменты, code-хосты, AI-ассистенты, таск-трекеры.
- Домены не в whitelist игнорируются полностью. По ним ничего не уходит на сервер.
- Изменения whitelist применяются ко всем разработчикам tenant'а.
- Типичные записи:
github.com,gitlab.com,*.atlassian.net,stackoverflow.com,chat.openai.com, внутренние*.company.local.
Blacklist (уровень пользователя)
Blacklist — это личный список исключений разработчика, настраивается в popup расширения. Срабатывает после whitelist организации.
- Домены, которые юзер занёс в blacklist, отбрасываются ещё до того, как событие покинет браузер.
- Полезно для исключения личной почты, банков, медицины и любых сайтов, которые юзер не хочет видеть в рабочих метриках.
- Blacklist'ы хранятся локально в расширении и не видны администратору.
переход на URL
→ попадает в whitelist?
нет → drop (ничего не уходит)
да → попадает в blacklist пользователя?
да → drop
нет → отправка на /v1/browser-events
Что собирается
Каждое событие, уходящее на /v1/browser-events, содержит:
| Поле | Пример | Комментарий |
|---|---|---|
| Домен | github.com | Hostname активной вкладки |
| Заголовок страницы | Pull Request #1234 · org/repo | Title в момент события |
| Timestamp | 2026-05-13T14:21:08Z | Когда событие создано |
| Время на странице | 42 (секунды) | Активное время на этой вкладке |
| Пользователь | Логин PanDev Metrics | Привязка к учётке |
Что НЕ собирается
By design расширение не может отправлять:
- Контент страницы (HTML, текст, картинки)
- Данные форм (поиск, пароли, сообщения)
- Скриншоты и снимки DOM
- URL глубже hostname — query-параметры и пути по умолчанию не передаются
- Cookies и local storage
Как это укладывается в модель времени
Browser-события считаются той же логикой активного времени с правилом 15-минутного зазора, что и IDE/CLI-плагины. Время на whitelist-доменах складывается с временем в IDE и терминале — получаются активные часы, время на задачу и входы для DORA.
Аутентификация
Расширение логинится обычной учёткой PanDev Metrics — тот же логин, что и для веба. После установки нажмите на иконку расширения и введите:
| Параметр | Значение |
|---|---|
| Server URL | https://metrics-cloud.pandev.io (Cloud) или ваш on-prem URL |
| Company Login | Идентификатор tenant'а (только для corporate SaaS — для личного Cloud и on-prem оставьте пустым) |
| Login | Email или username |
| Password | Пароль |
Конфигурация в UI
Whitelist, маппинги категорий и tenant-настройки browser-расширения живут в:
Настройки → Настройки браузера
Администраторы также видят, у каких разработчиков расширение активно и timestamp последнего события по каждому.
Приватность
Гарантия приватности browser-плагина стоит на трёх правилах:
- Whitelist-first. Ничего не уходит по доменам, на которые организация не подписалась.
- Без контента. Расширение читает только
window.location.hostnameиdocument.title. Тела страниц оно не читает. - User veto. Любой разработчик может локально занести любой домен в blacklist — это перебивает whitelist организации в его браузере.
По более глубоким вопросам — что именно доходит до сервера — обращайтесь к администратору PanDev Metrics.
FAQ
Нужно ставить расширение в каждый браузер?
Да. Каждый браузер держит расширения изолированно, поэтому ставьте в каждый отдельно. Логин PanDev переиспользуйте.
Расширение трекает incognito / приватный режим?
Нет. Chromium-браузеры по умолчанию отключают расширения в incognito. То же — в приватных окнах Firefox. Можно вручную включить расширение для приватного режима, если нужно.
Браузер не будет тормозить?
Нет. События лёгкие (несколько сотен байт), батчатся и уходят в фоне. Никакого скрапинга DOM или анализа контента нет.
Что будет, если я оффлайн?
События копятся локально в расширении и сливаются на сервер, когда сеть вернётся. Timestamp'ы сохраняются.
Можно посмотреть, что именно отправляет расширение?
Да. Откройте DevTools браузера → Network, фильтр browser-events. Каждый запрос покажет, какой домен, title и длительность уходят на сервер.
Поддерживаются ли Chromium-форки, не вошедшие в список?
Большинство Chromium-форков принимают расширения из Chrome Web Store. 10 браузеров выше — официально протестированные; остальные обычно работают, но в QA не входят.