Настройка трассировки
05 июня 2023
ID 193448
В разделе приведена инструкция для Kaspersky Endpoint Agent для Windows. Эта инструкция может быть частично или полностью неприменима к Kaspersky Endpoint Agent для Linux. Актуальную инструкцию для Kaspersky Endpoint Agent для Linux смотрите в справке решения, в составе которого вы используете программу: Kaspersky Anti Targeted Attack Platform или Kaspersky Managed Detection and Response.
Kaspersky Endpoint Agent не создает папку для сохранения файлов трассировки или файлов дампа на устройстве автоматически. Необходимо указать папку, которая уже доступна на устройстве.
Чтобы настроить трассировку в программе Kaspersky Endpoint Agent через интерфейс командной строки:
- На устройстве запустите интерпретатор командной строки (например, Command Prompt cmd.exe) с правами учетной записи локального администратора.
- С помощью команды
cd
перейдите в папку, где находится файл agent.exe.Например, введите команду
cd "C:\Program Files (x86)\Kaspersky Lab\Endpoint Agent\"
и нажмите на клавишу ENTER. - Введите одну из следующих команд и нажмите на клавишу ENTER:
agent.exe --trace=enable --folder <путь к папке для сохранения файлов трассировки>
, чтобы включить трассировку.Трассировка будет включена для всех процессов Kaspersky Endpoint Agent, запущенных в текущий момент. Файлы трассировки будут создаваться в папке, которую вы указали.
Убедитесь, что папка, которую вы указали, доступна на управляемом устройстве. Иначе файлы трассировки не будут созданы.
agent.exe --trace=enable --folder <путь к папке для сохранения файлов трассировки> --rotation=yes --rotate-file-size=<максимальный размер файла в МБ> --rotate-files-count=<максимальное количество файлов>
, чтобы включить трассировку в режиме перезаписи старых файлов трассировки при достижении указанных значений размера и количества файлов.Указанное ограничение по количеству файлов применяется для каждого отлаживаемого процесса Kaspersky Endpoint Agent отдельно, поэтому суммарное количество файлов для всех процессов может превышать заданное значение. Если с параметром
--rotation=yes
не указать параметры--rotate-file-size
или--rotate-files-count
(один из, или оба), то программа использует значения по умолчанию. По умолчанию задан 1 файл размером в 50 МБ.agent.exe --trace=disable
, чтобы выключить трассировку.Трассировка будет отключена для всех процессов Kaspersky Endpoint Agent, запущенных в текущий момент.
agent.exe --trace=show
, чтобы просмотреть текущее состояние трассировки и путь к папке для сохранения файлов трассировки.Отобразятся значения параметров
trace.enable
(true
, если трассировка включена илиfalse
, если трассировка отключена) иtrace.folder
(путь к папке).
Коды возврата команды --trace
:
- -1 – команда не поддерживается.
- 0 – команда выполнена успешно.
- 1 – команде не передан обязательный аргумент.
- 2 – общая ошибка.
- 4 – синтаксическая ошибка.
- 5 – объект не найден (не найден путь, указанный в качестве пути к папке с файлами журнала трассировки).
- 9 – неверная операция (например, попытка выполнения команды
--trace=disable
, если трассировка уже отключена).