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 |
|
Key |
HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions |
|
Name |
FreeDiskspacePercent |
|
Data Type |
REG_DWORD (Number) |
|
Value |
Percentage of disk space needed for trace entries to be written |
|
Key |
HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions |
|
Name |
FileLogThreshold |
|
Data Type |
REG_DWORD (Number) |
|
Value |
1= Debug, 2 = Info, 3 = Status, 4 = Warning, 5 = Error, |
|
Key |
HKEY_LOCAL_MACHINE\Software\RES\LoggingOptions |
|
Name |
MaxLogFileSizeMB |
|
Data Type |
REG_DWORD (Number) |
|
Value |
Number of maximum megabytes occupied by trace file |
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.