Chapter 4: Property Reference
223
trace.request( )
Determines whether detailed trace output is generated for the current request. The default value is no,
which produces no output. Trace output is generated at the end of a request, and includes request
parameters, property settings, and the effects of all actions taken. Output tracing can be set
conditionally by creating a rule that combines this property with conditions such as url= or
client.address=.
By default, trace output is written to an object accessible using the following console URL:
http://ProxySG_IP_address:8081/Policy/Trace/default_trace.html
The trace output location can be controlled using the trace.destination( ) property.
Note: Tracing is best used temporarily, such as for troubleshooting; the log_message( ) action is
best for on-going monitoring.
Syntax
trace.request(yes|no)
The default value is no.
Layer and Transaction Notes
Use in any layer.
Applies to all transactions.
Example
; Generate trace details when a specific URL is requested.
url=//www.example.com/confidential trace.request(yes)
See Also
•Properties:
trace.destination(), trace.rules()