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

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

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

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

  • macOS с установленным Homebrew (brew.sh)

  • API-токен PanDev Metrics — откройте веб-приложение, перейдите в Settings → Plugins → CLI и скопируйте значение из шага Введите ваш токен. Токен начинается с pandev_.

    Адрес сервера и воркспейс уже зашиты в токен, поэтому отдельный Server URL вводить не нужно.

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

curl -fsSL https://raw.githubusercontent.com/pandev-metriks/pandev-cli/main/install.sh | bash
sudo pandev-cli-plugin --install

Первая команда запускает официальный инсталлятор: он подключает Homebrew-tap PanDev (если есть brew) и ставит бинарник. Вторая регистрирует фоновый демон (это единственный шаг, которому нужен sudo).

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

Запустите pandev login и вставьте токен в приглашение.

sudo pandev login
# Enter your PanDev token (starts with 'pandev_'):

Чтобы обойтись без приглашения — например, в скрипте провижининга — передайте токен флагом:

sudo pandev login -t pandev_...

--token pandev_... и --token=pandev_... делают то же самое.

предупреждение

Токен — это учётные данные: кто им владеет, тот шлёт метрики от вашего имени. Не кладите его в коммиты и общие чаты, а на общей машине лучше вводите в приглашение, чтобы токен не осел в истории shell.

Токен хранится локально, демон сам переподключается после рестартов.

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

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

pandev status

Проверьте, что heartbeats копятся:

pandev time

Также можно открыть Настройки → Плагин → CLI plugin в UI PanDev Metrics — ваша машина появится со свежим timestamp.

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

pandev --help     # Все команды плагина
pandev status     # Состояние демона и auth
pandev time       # CLI-активность за сегодня
pandev login      # Переавторизация

Обновление​

Обновлениями занимается Homebrew:

brew update && brew upgrade pandev-cli-plugin

Удаление​

sudo pandev-cli-plugin --uninstall
brew uninstall pandev-cli-plugin
brew untap pandev-metriks/pandev-cli

Troubleshooting​

pandev status пишет «not authenticated»

Запустите sudo pandev login ещё раз. Если не помогает — проверьте, что Server URL без trailing slash и что URL доступен с этой же машины: curl -I <server-url>.

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

Повторите регистрацию:

sudo pandev-cli-plugin --install

И снова pandev status.

Самоподписанный сертификат на on-prem-сервере

Плагин уважает доверие из Keychain. Импортируйте корневой CA организации через Keychain Access → System → Certificates и пометьте как доверенный для SSL.

Через 30 минут в дашборде ничего не появляется

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

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

Heartbeats появляются в дашбордах в течение нескольких минут после прогона cron-job'ов.

FAQ​

Поддерживается Apple Silicon (M1/M2/M3)?​

Да. Homebrew ставит правильный бинарник под архитектуру автоматически.

Зачем для установки sudo?​

Одноразовый pandev-cli-plugin --install регистрирует launch agent, чтобы демон стартовал при логине. Дальше демон работает от вашего пользователя — больше sudo не нужно.

Какие shell поддерживаются?​

zsh (дефолт на macOS), bash и fish. Плагин цепляется к shell при установке.

Как сменить сервер или воркспейс?​

Скопируйте токен нужного воркспейса в веб-приложении и выполните sudo pandev login -t <НОВЫЙ_ТОКЕН>. Адрес сервера внутри токена, больше менять нечего.

Похожее​