Web Agent Guides › Web Agent Configuration Guide › Configure Logs › How to Set Up Trace Logging › Trace Message Data Fields

Trace Message Data Fields

You can define what each trace message for a specific component contains by specifying which data fields to include in the message.

Data fields use the following syntax:

data:data_field1,data_field2,data_field3

Some data fields are shown in the following example:

data:message,date,time,user,agentname,IPAddr

There may not be data for fields in each message, so blank fields my occur. For example, if you select RealmOID as a data field, some trace messages will display the realm's OID while others will not.

The following data fields are available:

• Message

  Includes the actual trace message

• SrcFile

  Includes the source file and line number of the trace message

• Pid

  Includes the process ID

• Tid

  Includes the thread ID

• Date

  Includes the date

• Time

  Includes the time

• PreciseTime

  Includes the time, including milliseconds

• Function

  Includes the function in the code containing the trace message

• User

  Includes the name of the user

• Domain

  Includes the SiteMinder domain

• Realm

  Includes the SiteMinder realm

• AgentName

  Includes the Agent name being used

• TransactionID

  Includes the transaction ID

• DomainOID

  Includes the SiteMinder domain OID

• IPAddr

  Includes the client IP address

• RequestIPAddr

  Includes the trace file displays the IP of the server where Agent is present

• IPPort

  Includes the client IP port

• CertSerial

  Includes the certificate serial number

• SubjectDN

  Includes the subject DN of the certificate

• IssuerDN

  Includes the Issuer DN of the certificate

• SessionSpec

  Includes the SiteMinder session spec

• SessionID

  Includes the SiteMinder session ID

• UserDN

  Includes the User DN

• Resource

  Includes the requested resource

• Action

  Includes the requested action

• RealmOID

  Includes the realm OID

• ResponseTime

  Includes the average response time in milliseconds of the Policy Servers associated with a CA Web Agent or SDK Agent and API application

  Note: To output the ResponseTime to a trace log, include the component Agent_Con_Manager along with the data field ResponseTime in the WebAgentTrace.conf file or other file specified in the Policy Server Configuration Object (ACO) and restart the Policy Server. The Agent_Con_Manager component, or Agent API Connection Manager, calculates the ResponseTime each time a response is received from a Policy Server and keeps a running average. To locate the ResponseTime in the trace log, search for [PrintStats].