Web Agent Guides › Web Agent Configuration Guide › Configure Logs › How to Set Up Trace Logging › 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 Web Agent is installed.

     Default (Windows installations): C:\Program Files\CA\webagent

     Default (UNIX installations): /opt/ca/webagent

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 the custom character that separates the fields in the trace.conf 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.

     Note: This feature is not supported for Apache 1.x and Sun Java System on UNIX systems. Use the default or leave this setting blank.

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

     Example: 20 (MB)

   • TraceFormat

     Specifies how the trace.conf 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 r12.0 SP2, the BusyHandleCount and FreeHandleCount attributes are not used.