Командная строка StaffCop

Многие операции, связанные с администрированием, имеют удобную и лаконичную систему команд, выполняемых из командной строки.

Вывод доступных команд

sudo staffcop help [command|django]

выберите django для вывода команд из командной строки django

Активация ключа через командную строку

sudo staffcop activate [ключ]

Добавление правил мониторинга в глобальную конфигурацию

sudo staffcop acl <RULE> <VALUE>

Подробный список правил можно посмотреть здесь

Бэкап базы данных и настроек. Сохраняет бэкап по умолчанию в /var/lib/staffcop/staffcop_backup

sudo staffcop backup_db [PATH_TO_BACKUP]

Восстановление базы данных из бэкапа по пути /var/lib/staffcop/staffcop_backup

sudo staffcop restore_db [PATH_TO_BACKUP]

Удаление всех файлов и скриншотов старше, чем значение DAYS

sudo staffcop cleandata <DAYS>

Удаляет все файлы и события из базы данных старше, чем значение DAYS, после чего уменьшает размер базы данных

sudo staffcop cleanup <DAYS>

Примечание

Оптимальным запасом для обеспечения производительной работы механизма очистки базы будет наличие свободного места из расчета, свободное место = размер базы / 8.

Управление Clickhouse

sudo staffcop clickhouse [install|init|reinit|pump|test|start|stop|restart]

Установка и активация базы данных сlickhouse

sudo staffcop clickhouse install

Апгрейд базы данных Clickhouse до стабильной версии

staffcop upgrade clickhouse

Cтавит последнюю известную стабильную версию Clickhouse. Иногда избавляет от проблем нестабильных версий Clickhouse, обычно более новых.

Загрузка данных из postgresql в clickhouse

sudo staffcop clickhouse pump

Примечание

Эта команда не должна выполняться просто так! Запускайте только если знаете, что делаете!

Тестирование системы выгрузки из postgresql в clickhouse нужно для диагностики

sudo staffcop clickhouse test

Перезапись всех данных clickhouse

sudo staffcop clickhouse reinit

Перезапуск clickhouse-server

sudo staffcop clickhouse restart

Запуск clickhouse-server

sudo staffcop clickhouse start

Остановка clickhouse-server

sudo staffcop clickhouse stop

Тест отправки данных от клиента до сервера и вывод конфигурации агента.

sudo staffcop client [SERVER]

Копирование базы данных и файлов с удаленного до локального сервера (postgresql)

sudo staffcop clone <SSH-USER>@<REMOTE-HOST> [ssh options]

Очистка незанятого места и дефрагментация базы данных

sudo staffcop compact

Определение местонахождения файлов БД

sudo staffcop db_path

Удаление всех данных по выбранному измерению

sudo staffcop delete [--type agent|account|event] [--days N] [--keep-files] [--compact] <NAME>

--type        Удаление данных по агенту, имени пользователя или типу событий
--days N      Оставить данные за N дней
--compact     Дефрагментация базы данных
--keep-files  Оставить файлы
--keep-events Оставить события
--use-id      Удаление данных по id, который береться из БД

Доступный список event для команды:

DiskDrive         | Внешние диски
FileOperation     | Операции с файлами
SystemLog         | Системный лог
UserActivity      | Алерт
WebcamSnapshot    | Снимок с веб-камеры
MicRecording      | Запись звука
DevInventory      | Реестр оборудования
AppInventory      | Реестр софта
WebSearch         | Поисковый запрос
DesktopVideo      | Видео рабочего стола
FormData          | Данные формы
WLan              | Беспроводное подключение
InterceptedFile   | Перехваченный файл
Keyboard          | Ввод с клавиатуры
Run               | Запуск приложения
Exit              | Завершение приложения
Screenshot        | Снимок экрана
NetworkConnection | Сеть
AppInstallation   | Установка ПО
Web               | Посещение сайтов
Im                | Интернет-пейджер
Mail              | Почта
FTP               | FTP
PrintDoc          | Печать документов
UserLogon         | Вход/выход из системы
Clipboard         | Буфер обмена
Device            | Устройства
Stat              | Время активности
File              | Файловый сканер

Примечание

Эта команда чувствительна к регистру имени компьютера, будьте пожалуйста внимательны!

Управление специальными разрешениями администраторов

Usage: staffcop special [options] list | grant <user> <permission|all> | revoke <user> <permission|all>

Special permission management

Avaiable permissions:
 can_access_terminal  Имеет доступ к WEB терминалу
 can_delete_shard     Может удалять данные из БД (помесячно)
 can_delete_event     Может удалять отдельные события
 can_delete_agent     Может удалять компьютеры и пользователей
 all                  Все разрешения

Options:
--password            Параметр позволяет задать дополнительный пароль, который будет запрошен перед исполнением операции в веб-консоле.

Дать разрешение:

staffcop special grant [USER] [PERMISSION]

Отозвать разрешение:

staffcop special revoke [USER] [PERMISSION]

Посмотреть разрешения:

staffcop special list

Восстановление дерева фильтров

sudo staffcop rebuild_mptt

Выполните команду, если у вас наблюдаются ошибки при открытии веб-интерфейса в консоли JS

Экспорт фильтров и конфигураций в FILE_TO_EXPORT.json (путь должен быть полным)

sudo staffcop export FILE_TO_EXPORT.json

Импорт фильтров и конфигураций из FILE_TO_IMPORT.json.

sudo staffcop import FILE_TO_IMPORT.json

Текущие фильтры будут сохранены.

Вывод информации о сервере и занятом месте на диске.

sudo staffcop info

Инициализация или восстановление настроек сервера.

sudo staffcop init

Установка агента с сервера Staffcop

sudo staffcop install [options] ip-address

--domain=DOMAIN       | Домен
--user=USER           | Имя пользователя
--password=PASSWORD   | Пароль
--server=SERVER_HOST  | IP-адрес сервера staffcop
--port=SERVER_PORT    | Порт сервера staffcop
--dry-run             | Проверка возможности установки
--reinstall           | Переустановка агента
--traceback           | Вывод trace ошибок
--uninstall           | Удаление агента
--language=LANGUAGE   | Выбор языка (en, ru)
--log                 | Показать лог установки
--version             | Вывод версии программы

Где, ip-address - это IP-адрес того ПК на котором вы хотите установить агента. В качестве адреса ПК - может выступать и имя рабочей станции, в этом случае у вас должен быть корректно настроен DNS-сервер в параметрах сетевых подключений системы.

Запуск mule в высоком приоритете

sudo staffcop mule <MULE_NAME>

Выполнение команды для распознавания текста в изображениях или pdf

sudo staffcop ocr <image or pdf file>

Вывести статистику по ящику

staffcop grab --server=<server> --login=<login> --password=<password>

Установка нового пароля для пользователя

sudo staffcop passwd NEW_PASSWORD

Вывод текущих sql-запросов и план выполнения

sudo staffcop prof

Удаление пользователей и агентов, которые не имеют событий

sudo staffcop prune

Вывод процессов staffcop

sudo staffcop ps

Перестройка отчетов за N месяцев

sudo staffcop rebuild_sessions MONTHS

Сброс к настройкам сервера по умолчанию

sudo staffcop reinit [full]

Если выбрать параметр «full», также удаляет все пользовательские фильтры

Перезапуск сервиса staffcop

sudo staffcop restart

Создание суперпользовтеля в веб-интерфейсе

sudo staffcop createsuperuser

Объединение событий агентов или аккаунтов с идентичными именами

staffcop sane          | объединяются агенты и аккаунты
staffcop sane agents   | объединяются только агенты
staffcop sane accounts | объединяются только аккаунты

Управление шардированием

sudo staffcop shard [init|install|list|ddl|index|copy|drop]

Создание шарда для текущего месяца

sudo staffcop shard init

Включение фунционала шардирования базы данных

sudo staffcop shard install

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

Необратимая операция! Команда работает в PostgreSQL версии 11 и выше, требуется 50% дискового пространства.

Вывод списка текущих шардов

sudo staffcop shard list

Удаление части шардированой базы данных

sudo staffcop shard drop agent_event_2021_01_01

Удалить часть БД, которая накопилась за январь 2021 года

Доступ к sql-консоли staffcop

sudo staffcop sql

Добавляет, удаляет и отображает динамические поля в модели куба

staffcop dynamic [options]

Примечание

Для вывода краткой справки по этой команде, напишите просто staffcop dynamic

Присвоение конфигурации для пользователя или агента

staffcop config --[user|agent] <AgentName|UserName> <ComputerConfigurationName|UserConfigurationName>

Примечание

Если название конфигурации состоит из нескольких слов, тогда следует использовать ковычки «Computer Config».

Запуск сервиса staffcop

sudo staffcop start

Остановка сервиса staffcop

sudo staffcop stop

Вывод топовых процессов staffcop

sudo staffcop top

Удаление всех данных

sudo staffcop truncate

Обновление до последней версии

sudo staffcop upgrade

Обновление postgresql (до версии 11)

sudo staffcop upgrade-postgress

Пересчитать один фильтр

sudo staffcop process 'Имя фильтра' 0

Примечание

Можно пересчитать один фильтр начиная с определённого ID если вместо «0» указать номер события с которого нужно пересчитать фильтр.

Например, чтобы пересчитать фильтр с именем «Карты» начиная с ID=1000000, нужно выполнить команду:

sudo staffcop process 'Карты' 1000000

Включить\Выключить дополнительные возможности веб-интерфейса

Чтобы включить Linux-консоль на сервере и опцию удаления данных от агентов нужно выполнить команду:

sudo staffcop enable webshell

Чтобы выключить Linux-консоль на сервере, и опцию удаления данных от агентов нужно выполнить команду:

sudo staffcop disable webshell

Примечание

По умолчанию эти меню отключены в веб-интерфейсе.