Capturing printing diagnostics for a SAS® Visual Analytics report in releases 7.5 and 7.51


Overview

Typically, the Transport log is sufficient to investigate printing problems in SAS Visual Analytics on SAS® 9.4. If additional diagnostics are required, this SAS Note explains how to gather diagnostic information about a SAS Visual Analytics print request in releases 7.5 and 7.51. 

CAUTION: The print debug package includes the data used in the report. If you do not want to share data, then do not create the debug package.  

Note: For information about how to capture the information beginning with release 8.2, see SAS KB0036156.

Locate the Path for the Debug Directory

This tool saves a ZIP file in the location specified by the Transport Services property named viewerservices.report.debug.directory. To see the path in your environment, follow these steps:

  1. Log on to SAS® Management Console with an administrative ID.
  2. Expand Application Management ► Configuration Manager ► SAS Application Infrastructure ► Visual Analytics ► Visual Analytics Services.
  3. Right-click Visual Analytics Transport Services and select Properties.
  4. Click the Advanced tab. Note the path specified for the viewerservices.report.debug.directory property. Here is an example.

Path for the directory is highlighted in blue as C:\SAS\Config\Lev1\Web\Logs\SASVisualAnalyticsTransportDebug\

Enable the Debug Property

Note: For information about how to access the SAS® Web Administration Console, see Use the SAS Web Administration Console.

  1. Log on to the SAS Web Administration Console with an administrative ID. The URL is in this form: http(s)://server:port/SASAdmin
  2. Expand the left pane, and then select Application Management.
  3. Scroll down the list of applications and select Visual Analytics Transport Service.
  4. On the right, click the Logging tab. It might take a few seconds for the page to populate.
  5. Set the com.sas.onebi.transportservices.utils.debug.Report logging context to DEBUG, and then click the Set Options button. (Scroll to see the button if it is not visible on the screen.)
  6. Log out of the SAS Web Administration Console. You do not have to restart the web application server.

In a list, com.sas.onebi.transportservices.utils.debug.Report is highlighted in red, with ALL deselected, TRACE deselected, and DEBUG selected (everything else is deselected).

Note: If the logging context is not already listed, then you must enter it into the Enter new logging context field, and then click Set Options.

Capture the Print Debug Package

  1. Log on to SAS® Visual Analytics Designer.
  2. Open the report that is having the printing problem.
  3. Press CTRL+ALT+D. You see a message that says Printing debug enabled. 
  4. Select Print from the report options menu. 
  5. In the Print to PDF dialog box, select the required settings and then click Print. 
  6. Press CTRL+ALT+D again. You see a message that says Printing debug disabled. 
  7. Navigate to the path specified by the viewerservices.report.debug.directory property.
  8. Two ZIP files are generated. Send a copy of the ZIP file ending in get_PrintedReport.zip to your track. The file will be named similar to sasdemo@SASBI_Simple Report_getPrintedReport.zip.