Tracing

You can use registry keys to have Ivanti Automation create a trace file for troubleshooting. After adding the registry keys, restart the Ivanti Automation services.

You can also enable Agent+ tracing from the console by clicking Topology > Agents, then click the Traces tab. For more information, see Agent Traces tab.

Agent+ and Dispatcher

For machines running Dispatchers or Agent+. Dispatchers and Agent+ will generate a new trace file each time the service is restarted. Also, a separate file will be generated for all tasks in a job executed on the Agent+.

To enable Agent+ and Dispatcher tracing, add the following registry keys and values:

Key	HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions
Name	Enable
Data Type	REG_DWORD (Boolean)
Value	1= enabled, 0= disabled

Key	HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions
Name	EnableFileLogs
Data Type	REG_DWORD (Boolean)
Value	1= enabled, 0= disabled

Key	HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions
Name	EnableSidekickLogs
Data Type	REG_DWORD (Boolean)
Value	1= enabled, 0= disabled

Key	HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions
Name	FileLogLocation
Data Type	REG_SZ (String)
Value	Local drive letter and path where the trace file will be stored

Legacy agents and Automation Console

To enable tracing for machines running the legacy agent or the Automation Console, add the following registry keys and values:

Key	HKEY_LOCAL_MACHINE\Software\RES\AutomationManager
Name	Trace
Data Type	REG_SZ (String Value)
Value	yes = enabled, no = disabled

Key	HKEY_LOCAL_MACHINE\Software\RES\AutomationManager
Name	TraceDetailed
Data Type	REG_SZ (String Value)
Value	yes = enabled, no = disabled

Key	HKEY_LOCAL_MACHINE\Software\RES\AutomationManager
Name	TraceFile
Data Type	REG_SZ (String Value)
Value	<path_to_logfile>\<filename>

For 64-bit machines, add the following registry values:

Key	HKEY_LOCAL_MACHINE\Software\Wow6432Node\RES\AutomationManager
Name	Trace
Data Type	REG_SZ (String Value)
Value	yes = enabled, no = disabled

Key	HKEY_LOCAL_MACHINE\Software\Wow6432Node\RES\AutomationManager
Name	TraceDetailed
Data Type	REG_SZ (String Value)
Value	yes = enabled, no = disabled

Key	HKEY_LOCAL_MACHINE\Software\Wow6432Node\RES\AutomationManager
Name	TraceFile
Data Type	REG_SZ (String Value)
Value	<path\filename>

• Because these settings are set on HKEY_LOCAL_MACHINE\SOFTWARE\RES\AutomationManager level, all Ivanti Automation services (legacy Agent and Console) installed on the computer will be traced.
• The file will always be 2 MB. Older entries will be overwritten within the file. If the trace is running for a longer period, the file should be copied on a regular basis.
• The last line in the file is not necessarily the latest entry.

Management Portal

To generate the Ivanti Automation Management Portal trace file, add the following registry values to the machine running the Ivanti Automation Management Portal:

Key	HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions
Name	Enable
Data Type	REG_DWORD (Boolean)
Value	1= enabled, 0= disabled

This will generate a file called "logs.txt" in the Logs folder. By default, this will be: "C:\Program Files\Ivanti\Automation\Management Portal\App_Data\Logs"

Notes:

• If the Application Pool in Microsoft Internet Information Services is configured to use a different user account, make sure that this account has access to the folder.

• It is not possible to configure tracing to a different path or file.

• The maximum size of the logfile will be 10 MB and is non-configurable.

• The trace file will continuously being written to disk, make sure to disable this after finishing troubleshooting.