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.