Enabling trace logging
As directed by the Pega Robotic Automation support team, capturing trace logging files can be helpful in diagnosing and resolving errors. The procedure for capturing trace logging files differs depending on the version of Pega Robotic Automation you are using:
- If you are using Pega Robotic Automation 19.1.5 or later, see Enabling trace logging in Pega Robotic Automation 19.1.
- If you are using Pega Robotic Automation 19.1.4, see Enabling trace logging in Pega Robotic Automation 8.0 SP1.
Enabling trace logging in Pega Robotic Automation 19.1
If you are using Pega Robotic Automation 19.1.5 or later, use the following instructions to enable the logging of trace files. This logging uses the built-in Microsoft Windows Logman command. Administrator access is not required if you are using version 19.1.5 or later.
To enable trace logging, perform the following steps:
- Before starting Pega Robot Runtime, right-click the Start menu and search for Command Prompt. Click the Command Prompt application.
- At the command prompt, go to the Pega Robot Studio installation folder. By default, the folder is C:\Program Files (x86)\Pegasystems\Pega Robot Studio.
- Enter one of the following commands:
Coretest.x32.exe options Location to create a trace file Command to enter Current folder Coretest.x32.exe tracestart Folder that you specify Coretest.x32.exe tracestart c:\full\path The Coretest utility creates the trace file in the folder that you indicate.
- Start Pega Robot Runtime and re-create the issue that you experienced. Note when you began the steps to re-create the issue and when you finished.
- After you re-create the issue, stop the logging by opening a command prompt and entering the following command: Coretest.x32.exe tracestop.
- Collect the log file, timestamps, and any additional notes about the issue and provide them to your Support Engineer for analysis.
The trace file is assigned the name PegaTrace.etl and is located in the folder that you chose in step 3.
Enabling trace logging in Pega Robotic Automation 8.0 SP1
If you are using Pega Robotic Automation 19.1.4 or earlier, including versions 8.0 SP1, use the following instructions to enable trace logging. Note that Administrator access is required to run trace logging. This logging uses the built-in Microsoft Windows Logman command.
- Before starting Pega Robot Runtime, right-click the Start menu and search for Command Prompt. Right-click the Command Prompt application and select Run as administrator.
- At the command prompt, go to the Pega Robot Studio installation folder. By default, the folder is C:\Program Files (x86)\ OpenSpan\OpenSpan Studio for Microsoft Visual Studio 2015.
- Enter the command: Run StartTrace.bat. A confirmation prompts notes that the command completed successfully.
- Re-create the issue that you experienced. Note when you began the steps to re-create the issue and when you finished.
- After you re-create the issue, turn off the logging by entering the command: >Run StopTrace.bat. The system confirms that the command was completed.
- Collect the log file, timestamps, and any additional notes about the issue and provide them to your Support Engineer for analysis.
You can find the log files in the roaming Appdata folder. You can quickly go to the folder by typing %appdata%\OpenSpan into the File Explorer path. The file is assigned the name OpenSpanTrace.etl.
Previous topic Determining the Microsoft .NET version Next topic How can I get the elements from an array?