Record an Appsight Log

On occasion, Technical Support may ask you to create a log of your computer’s activity to
help pinpoint the root cause of an application problem. BMC’s AppSight Black Box is
available from the Kingdom Help menu to make this recording.

Note: Appsight is not supported on Windows 10 operating systems.

AppSight is a software module that operates like a black box flight recorder on a plane. It
monitors application execution, captures a real-time log of application activity, and helps
pinpoint the root cause of application problems quickly and effectively.
Appsight is automatically installed with Kingdom unless during a Custom installation you
choose to deselect Appsight.
AppSight creates two logs:
• a visual log of all activity that occurs on your monitors
• a text log of all activity.
After you record the troubleshooting log, you save it and send it to Technical Support for
analysis.
To start recording a troubleshooting log, follow these steps:
1. Choose Help > Start Recording.
The Recording Details dialog box appears.

Kingdom® 2017 1
2. Complete the following information to create a header file for the troubleshooting log:
• First name—required.
• Last name—required.
• Company name—optional.
• Incident number—your Technical Support contact will give you an incident number.
• Description of issue—enter a description of what has occurred and what you will
reproduce while in recording mode.
• Kingdom version and build—this field is automatically filled in by Kingdom. It
displays the version and build of Kingdom, including the type of license.
• Save As—contains 2 fields:
- The first field is the location where the recording file (*.asl) will be saved. Accept
the default location or click Browse to navigate to another location. The default
location is your desktop.
- The second field is the location of the recording profile (*.rpr) that will be used.
Unless Tech Support has sent you a custom recording profile, you will not need to
browse to the location of this file. The general Kingdom.rpr file location is
automatically entered.

2 Kingdom® 2017
3. Click Start Recording to record your session. The Black Box is recording the executable
when you see a blinking bulls-eye icon on your system tray . If you do not see this
icon, then the Black Box is not recording the problem. Contact a support representative
for assistance.
4. Run the application to recreate the scenario.
5. After you have finished performing the function in question, choose Help > Stop
Recording.
6. The <log_file_name>.asl file will be saved to the location specified in the Recording
Details form. The default location is your desktop.
7. Send the log file to Kingdom Tech Support as an E-mail attachment, or through an FTP
site.
If you send the AppSight log file through an FTP sight, send them in binary mode. If the
files are FTP’d via ASCII, the files may become corrupted.

Kingdom® 2017 3
4 Kingdom® 2017