Obtaining debug information

The script described below is used for running the application functioning diagnostics and obtaining debug information that can help to resolve issues (logs and dump files).

Debug reports for executed files are obtained separately.

The script is a part of Kaspersky Research Sandbox, and is available immediately after installation. The script is located at /opt/kaspersky/sandbox/libexec/utilities/sandbox-debug-report.py.

To run diagnostics:

Log in to the Kaspersky Research Sandbox server.
Gain root privileges to get access to all data that can be obtained.
Execute the following command:
./sandbox-debug-report.py [-h] [--from_date <start date>] [--to_date <end date>] [--timeout <timeout>] [--path_dir <path to directory>]

An archive sandbox-debug-report.<from_date>.<to_date>.tar.gz is created.
Download diagnostics results by using the scp command-line utility:
scp <admin user>@<sandbox host>:<path to report/report file name>

Arguments and description

Arguments, keys	Description
`--help` `-h`	Display help for commands.
`--from_date` `-f`	Start date of the diagnostics report. Date must be specified in YYYY-MM-DD format.
`--to_date` `-t`	End date of the diagnostics report. Date must be specified in YYYY-MM-DD format.
`--timeout` `-T`	Timeout period in seconds. Default value: `15`.
`--path_dir` `-p`	Path to the directory, where the diagnostics report will be stored. Default path: `/var/tmp`

Arguments, keys

Description

--help

-h

Display help for commands.

--from_date

-f

Start date of the diagnostics report.

Date must be specified in YYYY-MM-DD format.

--to_date

-t

End date of the diagnostics report.

Date must be specified in YYYY-MM-DD format.

--timeout

-T

Timeout period in seconds.

Default value: 15.

--path_dir

-p

Path to the directory, where the diagnostics report will be stored.

Default path: /var/tmp

Page top