Hitachi

JP1 Version 11 JP1/Performance Management - Agent Option for Service Response Description, User's Guide and Reference


8.2.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 probe and IE probe of PFM - Agent for Service Response and the maximum size of a report file.

Table 8‒3: Definition in the General section

Key name

Mandatory

Value to be specified

Mode

Y#

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, TLSV11, or TLSV12))<<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:

  • TLSv1

  • TLSv1.1

  • TLSv1.2

If you monitor a Web server that does not support TLSv1.1, TLSv1.2 or later, 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 or TLSV12 for this option.

If you want to use all protocols, specify NONE. If you want to disable a specific protocol, specify either of the following value:

  • TLSV11: Disables TLSv1.1 or later.

  • TLSV12: Disables TLSv1.2 or later.

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.

enable_low_level_ssl_protocol ((SSL))

--

Specifies which of the SSL protocols used for communication between a probe and a Web server will be lower protocols for monitoring of HTTPS(including monitoring of Web transactions that use HTTPS). PFM - Agent for Service Response supports the following SSL protocols:

  • TLSv1

  • TLSv1.1

  • TLSv1.2

SSLv2.0 and SSLv3.0 become effective in addition to the protocol mentioned above when you specify "SSL" to this key. But, it is not recommended that you validate SSLv2.0 and SSLv3.0,which are lower protocols.

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 8‒4: Definition in the System Log section

Key name

Mandatory

Value 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 8‒5: Definition in the Cluster section

Key name

Mandatory

Value 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 8‒6: Definition in the WEBTRANS Probe section

Key name

Mandatory

Value 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 8‒7: Definition in the FTP Probe section

Key name

Mandatory

Value 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 8‒8: Definition in the IE Probe section

Key name

Mandatory

Value to be specified

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

((IE7, IE8, IE9, IE10 or IE11))#3

--

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.

  • IE8

    Specify this when the monitoring target supports Internet Explorer 8.

  • 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.

  • IE11

    Specify this when the monitoring target supports Internet Explorer 11. You can specify this option when Internet Explorer 11 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 7.3.1 IE Recorder (main) window.

#3

Do not specify version of Internet Explorer that PFM - Agent for Service Response does not support.