Record a GBC log

With the GBC, you can record a session log to capture the interaction between the front-end and the DVM, with the intent of using that log later to replay the session for debugging purposes, or to provide a demo of the application. A log can also be useful when reporting a support case.

Starting a session log

To start a session log, include the recordgbclog query string parameter in the application URL, with the value set to 1. For example, open the demos application by entering the URL for your GAS in a browser:

GAS 5.00 and greater
http://localhost:6394/ua/r/demo?recordgbclog=1
GAS prior to 5.00
http://localhost:6394/ua/r/gwc-demo?recordgbclog=1

The application starts in recording mode. All interaction between the front-end and the DVM is recorded, to include the user interaction with the sidebar and any context menus. The window size is also stored in the log.

Be aware of the following:

  • All user local actions are not written to the log, as the user local action does not interact with the DVM.
  • Images and resources are, by default, not taken into account. To record a log that includes the images, see the next section of this topic.
  • Browser window resizing at runtime is not taken into account.

Starting a session log that includes the real images

By default, the placement and the size of any images in the application are shown, but the image itself is not saved to the log file. Instead, a placeholder image (a red square with a red X in the center) is included in the session log.

To start a session log that includes the actual images, include both the recordgbclog and withrealimages query string parameters in the application URL, with the value for both set to 1. For example, open the demos application by entering the URL for your GAS in a browser:

GAS 5.00 and greater
http://localhost:6394/ua/r/demo?recordgbclog=1&withrealimages=1
GAS prior to 5.00
http://localhost:6394/ua/r/gwc-demo?recordgbclog=1&withrealimages=1

Stop and download a session log

To stop and download a session log:

  1. Click on the "Recording log ..." label in the chromebar. The log is downloaded for you.
  2. Quit the application. The application ended page displays, with a link to "Get the GBC logs". Click on this link to download the session log.

The session log file without images takes the format *app_name*-*session_id*.gbclog

A session log file with images takes the format *app_name*-*session_id*_realImages.gbclog