7.2 Probe action condition definition file (esp.conf)

The Probe action condition definition file is used to set the IE Probe Daemon's start options and the Probe Daemon's start options. It is read when the IE Probe Daemon starts and the Probe Daemon starts.

To apply the definitions specified in the Probe action condition definition file, you must restart PFM - Agent for Service Response.

Organization of this section
(1) Format
(2) Definition
(3) Example

(1) Format

[General]
mode=ESP
number_of_probes=maximum-number-of-measurement-conditions-for-probe
max_reportfile_size=maximum-size-of-report-file
ie_number_of_probes=maximum-number-of-measurement-conditions-for-IE-probe
ie_max_reportfile_size=maximum-size-of-IE-probe-report-file
ie_service_flag={Y|N}
disable_ssl_protocol={NONE|TLSV11}
html_script_skip_flag={Y|N}

[System Log]
printlog_flag={Y|N}

[Cluster]
cluster_flag={Y|N}
shared_directory=folder-name-on-shared-disk-used-for-cluster-operation

[WEBTRANS Probe]
max_keep_alive_session=maximum-sessions-count-in-keep-alive-mode
skip_emb_rsc_error={Y|N}
post_redirect_method={GET|POST}

[FTP Probe]
ignore_quit_resp_recv_error={Y|N}

[IE Probe]
html_log_flag={Y|N}
max_number_of_html_log=maximum-number-of-storing-HTML-file-acquired-when-measuring-IE-scenario
ie_probe_browser_mode=Internet-Explorer-version-for-using-IE-probe

Note:
The following notes apply to specifying the Probe action condition definition file:
  • Each key name and its value must be connected by an equal sign (=).
  • Each key name and its value must be specified on a single line.
  • The specification must begin in column 1.
A line beginning with a hash mark (#) is treated as a comment line.

(2) Definition

This subsection describes the definitions. You can omit any unneeded optional key name (or optional section).

General section:
Specifies the maximum number of measurement conditions for the IE probe and probe of PFM - Agent for Service Response and the maximum size of a report file.

Table 7-3 Definition in the General section

Key nameMandatoryValue to be specified
ModeY#Always ESP. When the probe is used, this item takes effect.
number_of_probes
((1 to 100))<<10>>
--Specifies the maximum number of measurement conditions for a probe. When the probe is used, this item takes effect.
max_reportfile_size
((1 to 32))(MB)<<4>>
--Specifies the maximum size of a report file. When the probe is used, this item takes effect.
ie_number_of_probes
((1 to 20))<<5>>
--Specifies the maximum number of measurement conditions for an IE probe. When the IE probe is used, this item takes effect.
ie_max_reportfile_size
((1 to 32))( MB)<<1>>
or,
((128K to 32768K))(KB)
--Specifies the maximum size of an IE report file. When the IE probe is used, this item takes effect.
ie_service_flag
((Y or N))<<N>>
--Specifies whether you use Windows services to start and stop the IE probe. If you use, specify Y. If you do not use, specify N.
If you manually start and stop the IE probe from the Windows start menu, specify N.
If you operate PFM - Agent for Service Response in a cluster system, specify Y.
If you do not use IE scenarios in a cluster environment, specify N.
disable_ssl_protocol
((NONE or TLSV11))<<NONE>>
--Specifies which of the SSL protocols used for communication between a probe and Web server will be disabled for monitoring of HTTPS (including monitoring of Web transactions that use HTTPS). PFM - Agent for Service Response supports the following SSL protocols:
  • SSLv2
  • SSLv3
  • TLSv1
  • TLSv1.1
If you monitor a Web server that does not support TLSv1.1, the Result Code (RESULT_CODE) field of the record collected by monitoring might be set to 3, causing a measurement error. You might be able to prevent this error by specifying TLSV11 for this option. If you want to use all protocols, specify NONE. If you want to disable TLSv1.1, specify TLSV11.
html_script_skip_flag
((Y or N))<<N>>
--Specifies whether the contents of script tags will be ignored when embedded resources are searched during monitoring of HTTP, HTTPS, or Web transactions.
Specify Y to ignore the contents of script tags during a search. Specify No to search for the contents of script tags.
Specifying Y might be able to prevent the KAVK08261-E message from being output to a log during HTTP or HTTPS measurement or the KAVK08261-E and KAVK08311-W messages from being output to a log during Web transaction measurement.
Legend:
Y: Mandatory item
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value
#
When you use the probe, this item is mandatory.

System Log section:
Specifies a setting related to log output.

Table 7-4 Definition in the System Log section

Key nameMandatoryValue to be specified
printlog_flag
((Y or N))<<N>>
--Specifies whether or not the Probe Daemon's event log and the IE Probe Daemon's event log are to be output. To output the event log, specify Y; otherwise, specify N.
Legend:
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value

Cluster section:
Specifies settings related to cluster operation.

Table 7-5 Definition in the Cluster section

Key nameMandatoryValue to be specified
cluster_flag
((Y or N))<<N>>
--Specifies Y to use PFM - Agent for Service Response in a cluster environment; otherwise, specifies N.
shared_directory
((up to 255 bytes))
--#When PFM - Agent for Service Response is to be used in a cluster environment, this item specifies the name of the directory on the shared disk to which report files are to be output.
If you specify Y in cluster_flag, you must specify this item. If you specify N in cluster_flag, this item is ignored, if specified. Do not enclose the value in double quotation marks (") even when the specified path contains a space.
Legend:
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value
#
When Y is specified in cluster_flag, this item is mandatory.

WEBTRANS Probe section:
Specifies settings related to Web transaction measurement. These settings take effect when you use the probe.

Table 7-6 Definition in the WEBTRANS Probe section

Key nameMandatoryValue to be specified
max_keep_alive_session
((1 to 20))<<10>>
--When the keep alive mode is used for Web transaction measurement, this item specifies the maximum number of sessions that can be kept alive. This becomes the maximum number of sessions per Web transaction measurement.
skip_emb_rsc_error
((Y or N))<<Y>>
--Specifies whether or not measurement is to continue when acquisition of an embedded resource results in an error during Web transaction measurement. To continue measurement, specify Y; otherwise, specify N.
post_redirect_method
((GET or POST))<<GET>>
--Specifies the method to be used for redirecting a POST request during Web transaction measurement. To use a GET method, specify GET; to use a POST method, specify POST. Normally, do not change this value.
Legend:
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value

FTP Probe section:
Specifies a setting related to FTP measurement.

Table 7-7 Definition in the FTP Probe section

Key nameMandatoryValue to be specified
ignore_quit_resp_recv_error
((Y or N))<<N>>
--Specifies whether or not monitoring is to continue when a reception error occurs in the response message from the FTP server for a logout request (entry of the QUIT command) during FTP measurement. To continue measurement, specify Y; otherwise, specify N. When FTP monitoring is performed in an environment where a Windows firewall is used, specify Y in this item.
Legend:
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value

IE Probe section:
Specifies a setting related to IE Probe measurement. These settings take effect when you use the probe.

Table 7-8 Definition in the IE Probe section

Key nameMandatoryMandatory
html_log_flag
((Y or N))<<Y>>
--Specifies whether the Web pages acquired while measuring IE scenarios are output to the HTML files. Specify Y to check the contents of the HTML files when detecting problems during measurements. The output files when replaying an IE scenario are stored in a folder. The character code of the output file is UTF-8. The following shows the output destination of the HTML files and their names:
The output destination of the HTML files:
installation-folder\agtv\probe\probedata\iescena\ieprobed_ measurement-condition-ID\measurement-start-time-for-IE-scenario#1
The output file name:
output-number_sequence-number_frame-number.html#2
max_number_of_html_log
((1 to 500))<<20>>
--Specifies the maximum case number of storing the HTML files acquired while measuring IE scenarios. Counts all the HTML files acquired when measuring an IE scenario as 1 case. The IE probe stores the HTML files the max_number_of_html_log times for each measurement condition. If the store case number exceeds the max_number_of_html_log, the files of the oldest case are deleted.
If you specify N as the value of html_log_flag, the value you specified is ignored.
ie_probe_browser_mode#3
((IE7, IE8, IE9, or IE10))
--Specifies the Internet Explorer version for using the IE probe.
Before specifying this item, check the Internet Explorer version supported by the monitoring target and the version of Internet Explorer installed in an environment in which PFM - Agent for Service Response is installed.
Internet Explorer 7 is the default version.
  • IE7
    Specify this when the monitoring target supports Internet Explorer 7. You can specify this option when Internet Explorer 8 or a later version is installed in an environment in which PFM - Agent for Service Response is installed.
  • IE8
    Specify this when the monitoring target supports Internet Explorer 8. You can specify this option when Internet Explorer 8 or a later version is installed in an environment in which PFM - Agent for Service Response is installed.
  • IE9
    Specify this when the monitoring target supports Internet Explorer 9. You can specify this option when Internet Explorer 9 or a later version is installed in an environment in which PFM - Agent for Service Response is installed.
  • IE10
    Specify this when the monitoring target supports Internet Explorer 10. You can specify this option when Internet Explorer 10 or a later version is installed in an environment in which PFM - Agent for Service Response is installed.
You must specify the Internet Explorer version that was specified when IE scenarios were created. This value must also be specified for ie_rec_browser_mode in the IE Recorder action condition definition file. If a value is not specified or if an invalid value is specified, the default version (Internet Explorer 7) is used.
Legend:
--: Optional item
(( )): Specifiable value range of the key.
<< >>: Default value
#1
The measurement start time for IE scenario is displayed in the following format: YYYYMMDD_hhmmss format (YYYY:Year, MM:Month, DD:Day, hh:Hour, mm:Minute, ss:second).
#2
The output number begins with 1. For details about the sequence number, see 6.2.1 IE Recorder (main) window.
#3
Do not specify version of Internet Explorer that PFM - Agent for Service Response does not support.

(3) Example

The following is an example of a Probe action condition definition file:

[General]
mode= ESP
number_of_probes= 10
max_reportfile_size= 1
ie_number_of_probes= 5
ie_max_reportfile_size= 128K
ie_service_flag= N
disable_ssl_protocol=NONE
html_script_skip_flag=N

[System Log]
printlog_flag=Y

[Cluster]
cluster_flag= N
shared_directory=folder-name-on-shared-disk-used-for-cluster-operation

[WEBTRANS Probe]
max_keep_alive_session= 10
skip_emb_rsc_error= Y
post_redirect_method= GET

[FTP Probe]
ignore_quit_resp_recv_error= N

[IE Probe]
html_log_flag= Y
max_number_of_html_log= 10
ie_probe_browser_mode=