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

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

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

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

  • macOS с установленным Homebrew (brew.sh)
  • Учётка PanDev Metrics (логин + пароль)
  • Server URL вашего PanDev Metrics:
    • Cloud: https://metrics-cloud.pandev.io
    • On-prem: URL, который дал администратор

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

brew install pandev-metriks/pandev-cli/pandev-cli-plugin
sudo pandev-cli-plugin --install

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

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

Запустите pandev login и введите Server URL, логин и пароль:

sudo pandev login

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

Шаг 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. Аккаунт, под которым делали pandev login, совпадает с аккаунтом в 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 заново и введите новый URL.

Похожее​