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

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

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

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

  • Linux-дистрибутив с установленным Homebrew on Linux (docs.brew.sh/Homebrew-on-Linux)

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

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

подсказка

Если не можете поставить Homebrew — попросите у администратора standalone-бинарник плагина.

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

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

На Linux Homebrew регистрирует демон автоматически — sudo не нужен.

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

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

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

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 # Переавторизация

Обновление

brew update && brew upgrade pandev-cli-plugin

Удаление

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

Troubleshooting

pandev: command not found после установки

Префикс Homebrew может быть не в PATH. Добавьте его в init-скрипт shell:

echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
exec bash -l
pandev status показывает, что демон не запущен

Перезапустите brew-сервисы или сессию терминала и повторите pandev login. Если не помогает — посмотрите ошибки в journalctl --user -xe.

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

Добавьте корневой CA организации в системный trust store:

# Debian / Ubuntu
sudo cp company-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates

# Fedora / RHEL
sudo cp company-ca.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust
Через 30 минут в дашборде ничего не появляется

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

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

FAQ

Какие дистрибутивы поддерживаются?

Любой, где работает Homebrew on Linux — Ubuntu, Debian, Fedora, RHEL, Arch, openSUSE и т.д. Плагин — обычный 64-битный Linux-бинарник.

Нужен root / sudo?

Нет. Демон работает от вашего пользователя; Homebrew on Linux ставится без root.

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

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

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

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

Похожее