Перейти к основному содержимому
Версия: v2 (текущая)

Установка на Windows

Поставьте CLI-плагин PanDev Metrics на Windows примерно за 3 минуты. После этого активность вашего терминала (имя команды + timestamp) появится в дашбордах PanDev Metrics.

Перед началом​

  • Windows 10 или 11 с PowerShell (5.1 или новее, предустановлен)
  • Учётка PanDev Metrics
  • Ваш API-токен — скопируйте его в веб-приложении PanDev Metrics (профиль / настройки API). Токен уже несёт в себе ваш воркспейс и сервер, больше ничего настраивать не нужно.

Шаг 1 — Установите плагин​

Откройте PowerShell от имени администратора (правый клик по PowerShell → Запуск от имени администратора) и выполните:

iwr -useb https://raw.githubusercontent.com/pandev-metriks/homebrew-pandev-cli/main/install.ps1 | iex

Скрипт скачивает бинарник CLI, добавляет его в PATH и регистрирует фоновый демон, чтобы он запускался вместе с сессией.

примечание

Скрипт установки нужно запускать из PowerShell с правами администратора — он регистрирует фоновый демон на системном уровне.

:::tip Если скрипт заблокирован PowerShell может блокировать удалённые скрипты в зависимости от execution policy. Разрешите их для текущей сессии и выполните команду снова:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

Это действует только на текущее окно PowerShell — общесистемную политику не меняет. :::

Шаг 2 — Авторизуйтесь​

Войдите по API-токену:

pandev login -t <YOUR_TOKEN_HERE>

Замените <YOUR_TOKEN_HERE> на токен, скопированный из веб-приложения. Токен хранится локально, демон сам переподключается после рестартов.

Шаг 3 — Проверьте​

Убедитесь, что демон работает и авторизован:

pandev status

Проверьте, что heartbeat'ы накапливаются:

pandev time

Можно также открыть Settings → Plugin → CLI plugin в веб-приложении PanDev Metrics — ваша машина должна появиться там со свежим временем heartbeat.

Полезные команды​

pandev --help                 # Список всех команд плагина
pandev status                 # Состояние демона и авторизации
pandev time                   # Активность CLI за сегодня
pandev login -t <TOKEN>       # Переавторизация с новым токеном

Обновление​

Запустите скрипт установки повторно из PowerShell с правами администратора, чтобы подтянуть свежую версию:

iwr -useb https://raw.githubusercontent.com/pandev-metriks/homebrew-pandev-cli/main/install.ps1 | iex

Удаление​

pandev-cli-plugin --uninstall

Команда останавливает и удаляет фоновый демон и стирает локально сохранённый токен.

Troubleshooting​

iwr ... | iex падает с ошибкой выполнения скрипта

Execution policy PowerShell блокирует удалённые скрипты. Разрешите их для текущей сессии и повторите установку:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
pandev: command not found после установки

Установщик добавляет CLI в PATH, но текущее окно PowerShell открылось до этого изменения. Закройте и снова откройте PowerShell, затем выполните pandev status.

pandev status пишет «not authenticated»

Повторите pandev login -t <YOUR_TOKEN_HERE> со свежим токеном из веб-приложения. Убедитесь, что скопировали токен целиком, без лишних пробелов в начале и конце.

pandev status показывает, что демон не запущен

Запустите скрипт установки (Шаг 1) ещё раз, чтобы перерегистрировать демон, затем снова проверьте pandev status.

Self-signed certificate на on-prem сервере

Плагин использует хранилище сертификатов Windows. Импортируйте корневой CA вашей организации в Доверенные корневые центры сертификации (certmgr.msc → Доверенные корневые центры сертификации → Сертификаты → Импорт).

Нет данных на дашборде через 30 минут

Проверьте три вещи:

  1. pandev status сообщает, что авторизован и работает
  2. pandev time показывает ненулевое значение
  3. Токен принадлежит тому же аккаунту, что вы смотрите в UI PanDev Metrics

FAQ​

Где взять токен?​

Откройте веб-приложение PanDev Metrics, перейдите в свой профиль / настройки API и скопируйте API-токен. Тот же токен подходит для IDE-плагинов.

Какие терминалы поддерживаются?​

Плагин встраивается в shell, поэтому heartbeat'ы дают и PowerShell, и Windows Terminal. Команды внутри WSL ловит сборка под Linux.

Нужны права администратора?​

Да. Скрипт установки запускайте из PowerShell, открытого от имени администратора — он регистрирует фоновый демон на системном уровне. После установки повседневные команды (pandev status, pandev time, pandev login) работают в обычном окне без прав администратора.

Как сменить аккаунт или сервер?​

Запустите pandev login -t <NEW_TOKEN> с токеном нужного аккаунта. Новый токен заменит старый.

Похожее​