8.3.3 Format and definition of measurement conditions (service-specific condition sections)
This subsection describes the format and definition of measurement conditions for each target Internet service.
The 12 types of SERVICE_IDs are described below.
- Organization of this subsection
(1) HTTP
This subsection describes the tags for the settings specific to the HTTP service.
(a) Format
<SERV_PARAM> <HTTP> <URL>URL</URL> <POST> <MESSAGE_BODY>message-body</MESSAGE_BODY> </POST> <DEPTH>depth</DEPTH> <WEB_AUTH> <WEB_USERNAME>Web-authentication-user-name</WEB_USERNAME> </WEB_AUTH> <PROXY> <PROXY_HOSTNAME>proxy-host-name-or-IP-address</PROXY_HOSTNAME> <PROXY_PORT>proxy-port-number</PROXY_PORT> <PROXY_USERNAME>proxy-user-name</PROXY_USERNAME> </PROXY> </HTTP> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (HTTP)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<HTTP>...</HTTP> |
Y |
Contains the parameters specific to the HTTP service. |
<URL>...</URL> ((character string of up to 255 bytes))#1 |
Y |
Specifies the URL of the Web page to be subject to measurement. The protocol identifier (http://) is not included. The port number can be omitted. If the port number is omitted, port number 80 is used. |
<POST>...</POST> |
-- |
Specifies that the POST method is to be measured. To set this tag, use the <MESSAGE_BODY> tag. To omit the specification, omit the <POST> tag and the tags contained in the <POST> tag. When this tag is omitted, the GET method is used. |
<MESSAGE_BODY>...</MESSAGE_BODY> ((1 to 1,023 bytes of character string)) |
--#2 |
Specifies a character string that is to be sent as the message body for transmission by the POST method. When the POST method is used, this item cannot be omitted. |
<DEPTH>...</DEPTH> ((1 to 100))<<2>> |
-- |
Specifies the depth of embedded resources and frames to be acquired. This is the depth of the resources and frames in the Web page that are to be downloaded. The following shows examples:
For details about embedded resources and frames, see HTTP in 10. Records. |
<WEB_AUTH>...</WEB_AUTH> |
-- |
Specifies that Web authentication is to be performed. Use the <WEB_USERNAME> tag to specify the settings related to Web authentication. To omit the specification, omit the <WEB_AUTH> tag and all the tags contained in it. |
<WEB_USERNAME>...</WEB_USERNAME> ((character string of up to 64 bytes)) |
--#3 |
Specifies the user name to be used for Web authentication. This tag is applicable only when Web authentication is executed. |
<PROXY>...</PROXY> |
-- |
Specifies that a proxy is to be used. Use the <PROXY_HOSTNAME>, <PROXY_PORT>, and <PROXY_USERNAME> tags to specify the proxy-related settings. To omit the specification, omit the <PROXY> tag and all the tags contained in it. |
<PROXY_HOSTNAME>...</PROXY_HOSTNAME> ((character of up to 255 bytes))#4 |
--#5 |
Specifies the proxy server's host name or IP address. This tag is applicable only when a proxy is used. |
<PROXY_PORT>...</PROXY_PORT> ((1 to 65535)) |
--#5 |
Specifies the proxy server's port number. This tag is applicable only when a proxy is used. |
<PROXY_USERNAME>...</PROXY_USERNAME> ((character of up to 64 bytes)) |
--#6 |
Specifies the user name to be used for proxy authentication. If proxy authentication is not performed, omit this tag. |
(2) HTTPS
This subsection describes the tags for the settings specific to the HTTPS service.
(a) Format
<SERV_PARAM> <HTTPS> <URL>URL</URL> <POST> <MESSAGE_BODY>message-body</MESSAGE_BODY> </POST> <DEPTH>depth</DEPTH> <WEB_AUTH> <WEB_USERNAME>Web-authentication-user-name</WEB_USERNAME> </WEB_AUTH> <PROXY> <PROXY_HOSTNAME>proxy-host-name-or-IP-address</PROXY_HOSTNAME> <PROXY_PORT>proxy-port-number</PROXY_PORT> <PROXY_USERNAME>proxy-user-name</PROXY_USERNAME> </PROXY> <SSL_AUTH_IGNORE></SSL_AUTH_IGNORE> <CLIENT_AUTH> <CLIENT_CERT_FILE>client-certificate-file-name</CLIENT_CERT_FILE> </CLIENT_AUTH> </HTTPS> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (HTTPS)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<HTTPS>...</HTTPS> |
Y |
Contains the parameters specific to the HTTPS service. |
<URL>...</URL> ((character string of up to 255 bytes))#1 |
Y |
Specifies the URL of the Web page to be subject to measurement. The protocol identifier (https://) is not included. The port number can be omitted. If the port number is omitted, port number 443 is used. |
<POST>...</POST> |
-- |
Specifies that the POST method is to be measured. To set this tag, use the <MESSAGE_BODY> tag. To omit the specification, omit the <POST> tag and the tags contained in the <POST> tag. When this tag is omitted, the GET method is used. |
<MESSAGE_BODY>...</MESSAGE_BODY> ((1 to 1,023 bytes of character string)) |
--#2 |
Specifies a character string that is to be sent as the message body for transmission by the POST method. |
<DEPTH>...</DEPTH> ((1 to 100))<<2>> |
-- |
Specifies the depth of embedded resources and frames to be acquired. This is the depth of the resources and frames in the monitored Web page that are to be downloaded. The following shows examples:
For details about embedded resources and frames, see HTTPS in 10. Records. |
<WEB_AUTH>...</WEB_AUTH> |
-- |
Specifies the settings related to Web authentication. Specify this tag to perform Web authentication. If you do not want to perform Web authentication, omit the <WEB_AUTH> tag and all the tags contained in it. |
<WEB_USERNAME>...</WEB_USERNAME> ((character string of up to 64 bytes)) |
--#3 |
Specifies the user name to be used for Web authentication. This tag is applicable only when Web authentication is executed. |
<PROXY>...</PROXY> |
-- |
Specifies that a proxy is to be used. Use the <PROXY_HOSTNAME>, <PROXY_PORT>, and <PROXY_USERNAME> tags to specify the proxy-related settings. To omit the specification, omit the <PROXY> tag and all the tags contained in it. |
<PROXY_HOSTNAME>...</PROXY_HOSTNAME> ((character of up to 255 bytes))#1 |
--#4 |
Specifies the proxy server's host name or IP address. This tag is applicable only when a proxy is used. |
<PROXY_PORT>...</PROXY_PORT> ((1 to 65535)) |
--#4 |
Specifies the proxy server's port number. This tag is applicable only when a proxy is used. |
<PROXY_USERNAME>...</PROXY_USERNAME> ((character of up to 64 bytes)) |
--#5 |
Specifies the user name to be used for proxy authentication. If proxy authentication is not performed, omit this tag. |
<SSL_AUTH_IGNORE> </SSL_AUTH_IGNORE> |
-- |
Specifies that measurement is to continue when SSL server authentication fails. To terminate measurement if SSL server authentication fails, omit this tag. |
<CLIENT_AUTH>...</CLIENT_AUTH> |
-- |
Specifies that client authentication is to be performed. Use the <CLIENT_CERT_FILE> tag to specify the settings related to client authentication. If you do not want to perform client authentication, omit the <CLIENT_AUTH> tag and all the tags contained in it. |
<CLIENT_CERT_FILE>...</CLIENT_CERT_FILE> ((character of up to 255 bytes)) |
--#6 |
Specifies the file in which the client certificate and private key are stored. Use a maximum of 255 bytes to specify the name of a file that is stored in installation-folder\agtv\probe\cert. Do not include the path. The file must be converted to Base64-encoded X.509 format. |
(3) SMTP
This subsection describes the tags for the settings specific to the SMTP service.
(a) Format
<SERV_PARAM> <SMTP> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> <MSG_SIZE>message-size</MSG_SIZE> <DST_MAIL_ADDR>destination-email-address</DST_MAIL_ADDR> <SRC_MAIL_ADDR>source-email-address</SRC_MAIL_ADDR> <POP3_AUTH> <POP3_HOSTNAME>POP3-host-name-or-IP-address</POP3_HOSTNAME> <POP3_PORT>POP3-port-number</POP3_PORT> <POP3_USERNAME>POP3-user-name</POP3_USERNAME> </POP3_AUTH> </SMTP> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (SMTP)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<SMTP>...</SMTP> |
Y |
Contains the parameters specific to the SMTP service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes)) |
Y |
Specifies the SMTP server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535))<<25>> |
-- |
Specifies the SMTP server's port number. |
<MSG_SIZE>...</MSG_SIZE> ((0 to 10000))(bytes) |
Y |
Specifies the size of the text for a measurement email. |
<DST_MAIL_ADDR>...</DST_MAIL_ADDR> ((character string of up to 256 bytes)) |
Y |
Specifies exactly one email address to which a measurement email is to be sent. |
<SRC_MAIL_ADDR>...</SRC_MAIL_ADDR> ((character string of up to 256 bytes)) |
-- |
Specifies the email address from which a measurement email is to be sent. |
<POP3_AUTH>...</POP3_AUTH> |
-- |
Specifies that POP3 (POP before SMTP) authentication is to be performed. Use the <POP3_HOSTNAME>, <POP3_PORT>, and <POP3_USERNAME> tags to specify the settings related to POP3 authentication. To omit the specification, omit the <POP3_AUTH> tag and all the tags contained in it. |
<POP3_HOSTNAME>...</POP3_HOSTNAME> ((character string of up to 255 bytes)) |
--# |
Specifies the POP3 server's host name or IP address. This tag is applicable only when POP3 authentication is executed. |
<POP3_PORT>...</POP3_PORT> ((1 to 65535))<<110>> |
--# |
Specifies the POP3 server's port number. This tag is applicable only when POP3 authentication is executed. |
<POP3_USERNAME>...</POP3_USERNAME> ((character string of up to 40 bytes)) |
--# |
Specifies the user name to be used for POP3 authentication. This tag is applicable only when POP3 authentication is executed. |
(4) POP3
This subsection describes the tags for the settings specific to the POP3 service.
(a) Format
<SERV_PARAM> <POP3> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> <USERNAME>user-name</USERNAME> <NON_DELETE_MAIL></NON_DELETE_MAIL> </POP3> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (POP3)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<POP3>...</POP3> |
Y |
Contains the parameters specific to the POP3 service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes)) |
Y |
Specifies the POP3 server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535))<<110>> |
-- |
Specifies the POP3 server's port number. |
<USERNAME>...</USERNAME> ((character string of up to 40 bytes)) |
Y |
Specifies the user name to be used in the POP3 service. |
<NON_DELETE_MAIL> </NON_DELETE_MAIL> |
-- |
Specifies that read emails are not to be deleted. To delete read emails, omit this tag. |
(5) IMAP4
This subsection describes the tags for the settings specific to the IMAP4 service.
(a) Format
<SERV_PARAM> <IMAP4> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> <USERNAME>user-name</USERNAME> <DELETE_MAIL></DELETE_MAIL> </IMAP4> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (IMAP4)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<IMAP4>...</IMAP4> |
Y |
Contains the parameters specific to the IMAP4 service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes)) |
Y |
Specifies the IMAP4 server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535))<<143>> |
-- |
Specifies the IMAP4 server's port number. |
<USERNAME>...</USERNAME> ((character string of up to 64 bytes)) |
Y |
Specifies the user name to be used in the IMAP4 service. |
<DELETE_MAIL> </DELETE_MAIL> |
-- |
Specifies that read emails are to be deleted. If you do not want to delete read emails, omit this tag. |
(6) DNS
This subsection describes the tags for the settings specific to the DNS service.
(a) Format
<SERV_PARAM> <DNS> <IPADDRESS>IP-address</IPADDRESS> <PORT>port-number</PORT> <QUERY>name-of-host-to-be-searched</QUERY> <RETRY>retries-count</RETRY> </DNS> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (DNS)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<DNS>...</DNS> |
Y |
Contains the parameters specific to the DNS service. |
<IPADDRESS>...</IPADDRESS> |
Y |
Specifies the DNS server's IP address. Only the IP address is accepted; the DNS name is not accepted. |
<PORT>...</PORT> ((1 to 65535))<<53>> |
-- |
Specifies the DNS server's port number. |
<QUERY>...</QUERY> ((character string of up to 255 bytes)) |
Y |
Specifies the name of the host to be searched for that is registered on the DNS server. |
<RETRY>...</RETRY> ((1 to 5))<<1>> |
-- |
Specifies the number of retries. From this value and the timeout value specified in the <TIME_OUT> tag contained in the <GEN_PARAM> tag, the retry timeout value is determined and set automatically. The formula is as follows: Retry timeout value = timeout value/(number of retries + 1) |
(7) DHCP
This subsection describes the tags for the settings specific to the DHCP server.
(a) Format
<SERV_PARAM> <DHCP> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> <PROBE_PORT>probe's-port-number</PROBE_PORT> <NON_ACCEPT_OFFER></NON_ACCEPT_OFFER> </DHCP> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (DHCP)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<DHCP>...</DHCP> |
Y |
Contains the parameters specific to the DHCP service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes)) |
Y |
Specifies the DHCP server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535))<<67>> |
-- |
Specifies the DHCP server's port number. |
<PROBE_PORT>...</PROBE_PORT> ((1 to 65535))<<68>> |
-- |
Specifies the port number of the probe that is used as the DHCP client in measuring the measurement condition. |
<NON_ACCEPT_OFFER> </NON_ACCEPT_OFFER> |
-- |
Specifies that the IP address assigned from the DNS server is not to be accepted. To accept it, omit this tag. |
(8) FTP
This subsection describes the tags for the settings specific to the FTP service.
(a) Format
<SERV_PARAM> <FTP> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> <USERNAME>user-name</USERNAME> <TRANS_DIRECTION>transfer-direction</TRANS_DIRECTION> <FILE_NAME>name-of-transferred-file</FILE_NAME> <PASSIVE></PASSIVE> </FTP> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (FTP)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<FTP>...</FTP> |
Y |
Contains the parameters specific to the FTP service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes))#1 |
Y |
Specifies the FTP server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535))<<21>> |
-- |
Specifies the FTP server's port number. |
<USERNAME>...</USERNAME> ((character string of up to 64 bytes)) |
Y |
Specifies the user name to be used in the FTP service. |
<TRANS_DIRECTION>...</TRANS_DIRECTION> ((UPLOAD or DOWNLOAD)) |
Y |
Specifies the file transfer method.#2 To transfer a file to the server, specify UPLOAD; to transfer a file from the server, specify DOWNLOAD. |
<FILE_NAME>...</FILE_NAME> ((character string of up to 32 bytes)) |
Y |
Specifies the name of the file to be transferred. |
<PASSIVE></PASSIVE> |
-- |
Specifies the connection mode.#3 This tag is used to establish data connection in the PASSIVE mode. To omit the specification, omit this tag. When this tag is omitted, data transfer connection is established in the ACTIVE mode. |
(9) TCP
This subsection describes the tags for the settings specific to the TCP service.
(a) Format
<SERV_PARAM> <TCP> <HOSTNAME>host-name-or-IP-address</HOSTNAME> <PORT>port-number</PORT> </TCP> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (TCP)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<TCP>...</TCP> |
Y |
Contains the parameters specific to the TCP service. |
<HOSTNAME>...</HOSTNAME> ((character string of up to 255 bytes))# |
Y |
Specifies the TCP server's host name or IP address. |
<PORT>...</PORT> ((1 to 65535)) |
Y |
Specifies the TCP server's port number. |
(10) WEBTRANS
This subsection describes the tags for the settings specific to the WEBTRANS service.
(a) Format
<SERV_PARAM> <WEBTRANS> <TRANSACTION_FILE>Web-transaction-file-name</TRANSACTION_FILE> <TRANSACTION_NAME>Web-transaction-name</TRANSACTION_NAME> </WEBTRANS> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (WEBTRANS)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<WEBTRANS>...</WEBTRANS> |
Y |
Contains the parameters specific to the WEBTRANS service. |
<TRANSACTION_FILE>...</TRANSACTION_FILE> ((character string of up to 255 bytes)) |
Y |
Specifies the name of the Web transaction file. Specify a file with the extension .xml that is stored in installation-folder\agtv\probe\webtrans.
|
<TRANSACTION_NAME>...</TRANSACTION_NAME> ((character string of up to 255 bytes)) |
Y |
Specifies the name of the Web transaction. The vertical bar character (|) cannot be used. |
(11) IESCENA
This subsection describes the tags for the settings specific to the IE scenario.
(a) Format
<SERV_PARAM> <IESCENA> <IESCENA_FILE>IE-scenario-file-name</IESCENA_FILE> </IESCENA> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (IESCENA)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<IESCENA>...</IESCENA> |
Y |
The tag to contain the parameters specific to the IE scenario. |
<IESCENA FILE>... </IESCENA FILE> ((character string of up to 255 bytes) |
Y |
Specifies the name of the IE scenario file. Specify a file with the extension .xml that is stored in installation-folder\agtv\probe\iescena.
|
(12) USERSERV
This subsection describes the tags for the settings specific to a user-defined service.
(a) Format
<SERV_PARAM> <USERSERV> <USER_SERVICE_ID>user-defined-service-ID</USER_SERVICE_ID> </USERSERV> </SERV_PARAM>
(b) Definition of <SERV_PARAM> (USERSERV)
XML tag |
Mandatory |
Role of tag and value to be specified |
---|---|---|
<USERSERV>...</USERSERV> |
Y |
Contains the parameters specific to a user-defined service. |
<USER_SERVICE_ID>...</USER_SERVICE_ID> ((1 to 100)) |
Y |
Specifies a user-defined service ID that has been registered in the command registration file. |