Page History

Specifies the use of a client certificate when Precise for Web tries to connect using Secure Socket Layer (SSL).

Default value: false.

Specifies additional ciphers that OpenSSL uses on top of the default ciphers for SSL version 2 and 3 and Transport Layer Security (TSL) version 1.

For more information, see the following URL: http://www.openssl.org/docs/apps/ciphers.html#cipher_suite_names.

Specifies the password to be used to decrypt the certificate file. The password itself should be encrypted using the Encrypt command that is part of the Precise CLI Utility.

For more information, see the Precise CLI Utility Reference Guide.

Specifies the user password for authentication. The password itself should be encrypted using the Encrypt command that is part of the Precise CLI Utility.

For more information, see the Precise CLI Utility Reference Guide.

The authentication method. One of the following methods should be used:

• basic
• digest
• ntlm

Specifies the extensions used, such as .html, .jsp, and .asp. For example:

<ext-list>html,jsp,asp</ext-list>

Default values: html, swe, asp, aspx, htm, jsp, php, gbl, cfm, pl, php3, do, IScript_PT_NAV_PAGELET, I_Script_AppHP, IScript_UniHeader_Frame, IScript_PT_NAV_INFRAME, iscript_apphp, iscript_timeoutwarning

Specifies the separator of the extension list.

Default value: , (a comma)

Specifies the URL of the statistics module. Add this registry element only if you know that the statistics URL differs from the default URL for the specific Web server type.

Default values:

Apache: server-status?auto iPlanet: .perf

WebLogic: weblogicstat

WebSphere: websphere_stats

Specifies the name of the session cookie used by the application. Define this value to improve client-side correlation in the following Web servers: WebLogic, WebSphere, Tomcat, Oracle AS, Sun One, IIS, Apache 2.x.

Default value: JSESSIONID

Specifies the maximum size of a Precise for Web cookie (in bytes).

Default value: 2048

Specifies the translation of URLs and URL parameters to unicode format. Set this parameter if URLs or parameters may contain non-ASCII characters.

Default value: false

Specifies the name of the URL encoding mechanism. Set this parameter if the server handles URLs that use neither UTF-8 nor local encoding, which are the default encoding types.

A list of URL parameters delimiters. These delimiters are used to separate the parameters of a URL from the URL itself. For example, the URL: “index.html?param1=abc” has 1 parameter ‘param1’. The parameters delimiter in this URL is ‘?’. Use this element if your application uses non-standard delimiters (like ‘;’). To specify more than one delimiter, concatenate all delimiters into one string, for example: <parameter-delimiters>?;.</parameter-delimiters> sets 3 delimiters: ‘?’, ‘;’ & ‘.’ If more than 1 delimiter is used, the first one that is encountered in the URL is used.

Default value: ? (question mark)

Maximum allowed user agent (browser type) length. Records exceeding this value will be ignored (not loaded).

Units: bytes

Default: 256

Maximum allowed user defined 1 & 2 length. Records exceeding this value will be ignored (not loaded).

Units: bytes

Default: 256

Maximum allowed server period (not including network period). Records exceeding this value will be ignored (not loaded).

Units: milliseconds

Default: 3600000 (1 hour)

Maximum allowed difference between current time and future record time. Records that have a later time the allowed will be ignored (not loaded).

Units: milliseconds

Default: 86400000 (1 day)

If true, records with no HTTP status are not ignored.

Default: true

If a record does not contain HTTP status and empty-http-status-allowed is set to true, sets the value to use for the HTTP status of that record.

Default: 0

If fallback-http-status is not set (or set to 0) HTTP statuses outside this range cause the record to be ignored (not loaded).

Default: 0, 599

If true, records with no HTTP protocol are not ignored.

Default: true

If the length of the HTTP protocol of a record exceeds this value, the record will be ignored (not loaded).

Units: bytes

Default: 5

If this is set, only HTTP protocols in this list are allowed, other values will cause the record to be ignored (not loaded).

Default: none

If true, records with no HTTP method are not ignored.

Default: true

If a record does not contain HTTP method and empty-http-method-allowed is set to true, sets the value to use for the HTTP method of that record.

Default: GET

If this is set, only HTTP methods in this list are allowed, other values will cause the record to be ignored (not loaded).

Default: none

Maximum allowed text period. Records exceeding this value will be ignored (not loaded).

Units: milliseconds

Default: 900000 (15 minutes)

Maximum allowed rendering period. Records exceeding this value will be ignored (not loaded).

Units: milliseconds

Default: 900000 (15 minutes)

Maximum files allowed in the output directory. After exceeding this value, no more files will not be written.

Default: 1440

Maximum records allowed in 1 output file. After exceeding this value, a new file will be created.

Default: 10000

Maximum time to have 1 file open.

Units: milliseconds

* Default for summed: 900000 (15 minutes)

*Default for raw: 60000 (1 minute)

Set the maximum for file size.

Units: bytes

Default: 10485760 (10MB)

Maximum files allowed in the output directory. After exceeding this value, no more files will not be written.

Default: 1440

Maximum records allowed in 1 output file. After exceeding this value, a new file will be created.

Default: 10000

Set the maximum for file size.

Units: bytes

Default: 10485760 (10MB)

When set to true, input raw files are deleted after being processed.

Default: true

Maximum number of error files to move to the errors directory when errors occur on files.

Default: 10

When set to false, validation of the statistics component of the web collector are not performed in the verify action (in AdminPoint).

Default: true

Enabled

When set to false, validation of the core web collector are not performed in the verify action (in AdminPoint).

Default: true

When client/server correlation is enabled, the web collector warns - in the verify action (in AdminPoint) – that server records were received but no client records did. This number sets the threshold for this warning.

Default: 1000

When client/server correlation is enabled, the web collector warns - in the verify action (in AdminPoint) – that client records were received but no server records did. This number sets the threshold for this warning.

Default: 500

When server/network correlation is enabled, the web collector warns - in the verify action (in AdminPoint) – that server records were received but no network records did. This number sets the threshold for this warning.

Default: 1000

When server/network correlation is enabled, the web collector warns - in the verify action (in AdminPoint) – that network records were received but no server records did. This number sets the threshold for this warning.

Default: 1000

Will be used by the web collector for communication with server and network agents. If this port is busy, any available port will be used.

Default: 20999

enabled

When set to false, summary processing is not performed by the web collector. This setting is meaningful only on the monitored server (and not on the FP machine where it is ignored). Setting this to false (along with client-server-correlation) sets the work mode to Basic Mode.

Default: true

Enabled

When set to false, server-side collection is disabled.

Default: true

When set to false, client/server correlation is disabled and in fact the instance will work in Basic Mode (this does not have meaning on the FP machine).

Default: true

When set to false, server/network correlation is disabled (this does not have meaning on the FP machine).

Default: true

When set to false, collector settings activity (handling of URL parameters) is done in the web collector instead of in the web filter.

Default: true (processing done on filter)

When set to false, data patterns processing is done in the web collector instead of in the web filter.

Default: true (processing done on filter)

When set to false, data locations processing is done in the web collector, instead of the web filter.

Default: true (processing done on filter)

When set to false client-side collection is disabled

Default: true

When set to false statistics collection is disabled

Default: true

Maximum files allowed in the output directory. After exceeding this value, no more files will not be written.

Default: 2000

Maximum number of threads that will be invoked by the web collector to handle data.

Default: 50

The initial wait time of the serialization timer that serializes the current data to files.

Units: milliseconds

Default: 120000

The cycle time of the serialization timer that serializes the current data to files.

Units: milliseconds

Default: 120000

Set the maximum number of records in the input queue. After the queue reaches this size, we start dropping records. May be used to temporarily ease memory consumption.

Default: 15000

Max time for server records to wait in memory for correlation (with both client & network records).

Units: milliseconds

Default: 90000 (1.5 minutes)

Max time for server records to wait in memory for correlation (with both client & network records) when this instance uses the client collector.

Units: milliseconds

Default: 30000 (30 seconds)

Set the maximum number of records in the input queue. After the queue reaches this size, we start dropping records. May be used to temporarily ease memory consumption.

Default: 10000

Max time for client records to wait in memory for correlation (with server records).

Units: milliseconds

Default: 90000 (1.5 minutes)

Max time for client records to wait in memory for correlation (with server records) when this instance uses the client collector.

Units: milliseconds

Default: 180000 (3 minutes)

Max time in milliseconds for client records first byte time. If the first byte time exceeds the maximum, it will be fixed by taking the server + network time.

Default: 900000 milliseconds

Set the maximum number of records in the input queue. After the queue reaches this size, we start dropping records. May be used to temporarily ease memory consumption.

Default: 15000

Max time for network records to wait in memory for correlation (with server records).

Units: milliseconds

Default: 90000 (1.5 minutes)

When set to false, server-side filtering is disabled

Default: true

A list of identifiers that will be reset in the filtering-summary process (when needed).

The identifiers will be reset, one by one, in the order they appear here until the top N limit is reached.

Valid values:

• url
• domain
• userAgent
• userDefined1
• userDefined2
• appUserName
• clientIP
• location
• city
• state
• country
• siebelView
• urlParams
• protocol
• httpMethod
• sessionID

Default: httpMethod, userAgent, protocol

When set to false, client-side filtering is disabled

Default: true

A list of identifiers that will be reset in the filtering-summary process (when needed).

The identifiers will be reset, one by one, in the order they appear here until the top N limit is reached.

Valid values:

• url
• domain
• protocol
• userAgent
• userDefined1
• userDefined2
• appUserName
• clientIP
• location
• city
• state
• country
• siebelView
• title
• host
• connectionType
• privateIP
• login

Default: userAgent, protocol

PssInstanceName

Specifies whether to read the configuration files on filter initialization. If this parameter is set to FALSE, parameters are taken from the Web server only.

Default: TRUE

Specifies whether to write initialization log messages to standard output. In some cases the standard output is written to the Web server log.

Applies only to J2EE-based application servers (Sun ONE, WebSphere, Tomcat, Oracle Application Server, SAP J2EE, or BEA WebLogic)

Take only the defined prefix.

For example: <pattern1>abraham</pattern1> - For URL 'abraham123.html' you will see

'abraham%'.

Take only the defined suffix.

For example: <pattern1>html</pattern1> - For URL 'abraham123.html' you will see '%html'.

Take text up to the defined key (not including that key).

For example: <pattern1>;jsessionid</pattern1> - For URL 'abraham123.html;jsessionid' you will see 'abraham123.html%' (if showReplaceChar="false", you will get 'abraham123.html').

Use the given regular expression to change the given URL.

For example: <pattern1 replace="$1">service(.*)</pattern1> - For URL 'service123' you will get '123' (for more on regular expressions, consult your support representative).

dynamic-inst

The first tag of the dynamic instrumentation configuration file.

J2EE: mandatory

ISAPI: mandatory

Enables or disables the instrumentation filter globally.

J2EE: optional

ISAPI: optional Values: true, false

Default value: true

handle-js*

Enables or disables the JavaScript handling by the filter.

J2EE: optional

ISAPI: optional Values: true, false

Default value: true

strict-servlet-api (J2EE)

Forces compatibility with the J2EE servlets specifications.

J2EE: optional

ISAPI: not applicable

Values: true, false

Default value: true

js-mime-type

Uses js-mime-type protocol.

J2EE: optional

ISAPI: optional

Values: if possible to use dynamically obtained, otherwise use application/x-javascript

Default value: if possible use dynamically obtained, otherwise use application/x-javascript

instance-id*

prolog-string*

An extra string that is injected during instrumentation (in addition to the regular callout to JavaScript). Usually it is used to add the <!Doctype element (because according to some browsers this tag should come at the beginning of the Web page).

J2EE: optional

ISAPI: optional

no-recompress

For compressed content. If set to true, insert the instrumentation script without recompression.

Apache: applicable for version 2.0 and higher

Values: true, false

Default value: true

accumulate-on-parsing

If parsing is on, accumulate response buffers till the <html> or <head> tag is found (see also the note after this table).

J2EE: optional

ISAPI: optional

Apache: applicable for version 2.0 and higher

Values: true, false

Default value: true

max-parsing-bytes

Looks for the <html> tag or the <head> tag only in the first n bytes specified.

J2EE: optional

ISAPI: optional

Apache: applicable for version 2.0 and higher Values: number of bytes, -1 for full parsing

Default value: 2048

private-log

Controls the writing of messages that need to be logged before the user-agent is obtained, to the private log.

J2EE: optional

ISAPI: optional Values: true, false

Default value: false

i3-log

Enables the i3 log globally.

J2EE: not applicable

ISAPI: not applicable

Values: true, false

Default value: false

enable

Enables or disables “Webgarden” support.

Values: true, false

Default value: true for IIS and SAP WAS Web servers, false on any other Web server

sampling-interval

Setting the sampling interval (in milliseconds) in which each process in the “Webgarden” updates its status.

Value: any number higher than 500

Default value: 2000

user-agents

Introduces the user-agents section.

J2EE: mandatory

ISAPI: mandatory

user-agent

Describes the configuration per user-agent.

J2EE: mandatory, only for user-agent with name "Default"

ISAPI: mandatory, only for user-agent with name "Default"

accumulation

Controls whether to perform accumulation of chunks/parts of the Web content and then preforming instrumentation all together. The default is not to use it and perform instrumentation on-the-fly (and perform accumulation only if necessary). There is an option to force accumulation (true) or to disable instrumentation when accumulation must be done (false).

J2EE: mandatory

ISAPI: mandatory

Values: default, true, false

Default value: default

parsing

Controls whether to perform light-parsing to inject the first script after <html> or <head> (what is recognized first). "false" means to inject the script at the beginning of the page, without parsing.

J2EE: mandatory

ISAPI: mandatory

Values: true, false

Default value: true

enable

Enables or disables the instrumentation filter per user-agent.

J2EE: mandatory

ISAPI: mandatory

Values: true, false

Default value: false

second-script

i3-log

Enables or disables the i3 log per user-agent.

J2EE: mandatory

ISAPI: mandatory

Values: true, false

Default value: false

private-log

Enables or disables the private log.

J2EE: mandatory

ISAPI: mandatory

Values: true, false

Default value: false

include-ip

Introduces the section in which you define the IP addresses that should be included in the dynamic instrumentation process. By default all IPs are included.

J2EE: optional

ISAPI: optional

range from

Beginning of the IP address range.

J2EE: optional

ISAPI: optional

Value: IP address

range to

End of the IP address range.

J2EE: optional

ISAPI: optional

Value: IP address

url-exclude

Introduces the section in which you define the URLs that should be excluded. By default all URLs are included.

J2EE: optional

ISAPI: optional

url-include*

Introduces the section in which you define the URLs that should be included. By default all URLs are included.

J2EE: optional

ISAPI: optional

include-char-encoding

Introduces the section for additional character encoding that is supported in the filter (in addition to the built-in character support).

J2EE: optional

ISAPI: optional

char-enc

Defines additional character encoding that is supported in the filter (in addition to the built-in character support). Use if your pages are written in none Unicode character encoding.

J2EE: optional

ISAPI: optional

req-header-exclude

Introduces the section that defines the HTTP request headers for which HTTP requests is excluded.

J2EE: optional

ISAPI: optional

header name