The BIS_TRACE_SUFFIX Environment Variable

On BIS/IIS, the BIS_TRACE_SUFFIX environment variable and, on BIS/Apache, the BISTraceSuffix configuration parameter allows trace parameters to be injected into every trace statement. While this requires administrative access to the web server, this is useful for globally providing specific clients access to trace information.

For example, if your trace statements look like this:

{{ trace(page, noip) }}

and you wish to view trace data from the machine at 192.168.3.54, and control such tracing with the MySecretTrace query parameter, place this into the server environment:

BIS_TRACE_SUFFIX=ip=192.168.3.54,queryparam=MySecretTrace

• This will effectively append these parameters to every Trace tag executed on the server without requiring the actual .srf file to be edited. Note that the .srf files must contain a Trace tag for this feature to take effect.
• See Setting Environment Variables for information about setting and modifying environment variables on Windows. See Configuring Apache for information about setting Apache configuration parameters.