Agent Guides › Web Agent Guide › Configure Logs › Collect Detailed Agent Connection Data with an Agent Connection Manager Trace Log

Collect Detailed Agent Connection Data with an Agent Connection Manager Trace Log

To collect detailed information about the connections between a Web Agent and Policy Server, you create a Trace Log file that contains information gathered by the Agent Collection Manager.

To collect detailed web agent connection data

1. Open your Agent Configuration object or local configuration file.
2. Set the value of the TraceFile parameter to yes.

   Note: Setting the value of this parameter to yes in a local configuration file of a web server overrides any of the logging settings defined on the Policy Server. For example, when the value of this parameter is set to yes in a LocalConfig.conf file log files are generated even if the value of the AllowLocalConfig parameter in the corresponding Agent Configuration object on the Policy Server is set to no. Additionally, set the related trace logging parameters (that define the file name, size, and so on) in the LocalConfig.conf file to override any Policy Server trace log settings.

3. Specify the full path to the trace log file for your Agent Connection Data in the TraceFileName parameter. This is the file that contains the trace log output.
4. Set the value of the TraceConfigFile parameter to the full path of the following file:

   web_agent_home/config/AgentConMgr.conf
   

   web_agent_home

   Indicates the directory where the SiteMinder Agent is installed.

   Default (Windows 32-bit installations of SiteMinder Web Agents only): C:\Program Files\netegrity\webagent

   Default (UNIX/Linux installations): user_home_directory/netegrity/webagent

   Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\netegrity\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files\netegrity\webagent\win32

5. Define the format the trace log file for your Agent Connection Data by setting the following parameters:

   TraceAppend

   Adds new logging information to the end of an existing log file instead of rewriting the entire file each time logging is invoked.

   Default: No

   TraceDelimiter

   Specifies a custom character that separates the fields in the trace file.

   Default: No default

   Example: |

   TraceFileSize

   Specifies (in megabytes) the maximum size of a trace file. The Web Agent creates a new file when this limit is reached.

   Default: 0 (a new log file is not created)

   Example: 20 (MB)

   TraceFormat

   Specifies how the trace file displays the messages. Choose one of the following options:

   • default—uses square brackets [] to enclose the fields.
   • fixed—uses fields with a fixed width.
   • delim—uses a character of your choice to delimit the fields.
   • xml—uses XML-like tags. A DTD or style sheet is not provided with the Web Agent.

   Default: default (square brackets)

   LogLocalTime

   Specifies whether the logs use Greenwich Mean Time (GMT) or local time. To use GMT, change this setting to no. If this parameter does not exist, the default setting is used.

   Default: Yes

6. Restart your web server so the new settings take effect.

   Detailed information about the Web Agent connections will be collected.

   Note: For SiteMinder r6.0 SP6, the BusyHandleCount and FreeHandleCount attributes are not used.