IBM Tivoli Composite Application Manager for Transactions, Version 7.4.0.0

Monitor elements

In addition to the test results common to all elements, the HTTP monitor generates a set of test results containing data specific to HTTP service tests.

Table 1 describes the additional elements for the HTTP monitor.

Elements indicated by an asterisk (*) are available as workspace attributes. The names of the attributes are shown within brackets below the element. Absence of an asterisk indicates there is no equivalent workspace attribute. Attributes shown in brackets but without an element indicate that they are only available as workspace attributes, there is no equivalent element.

Table 1. HTTP monitor elements

Element

Description

$bytesPerSec*

(BytesPerSec)

The average number of bytes transferred each second.

$bytesTransfered*

(BytesTransferred)

The number of bytes uploaded or downloaded.

$checksum

The Checksum element does not normally provide meaningful values for service level classifications because checksum values are not known when the profile element is created (the monitor calculates checksum values while tests are in progress). The $checksum and $previousChecksum monitor elements are intended for alert enrichment using the monitor's rules file.

$command

The HTTP command issued by the monitor. For example, HEAD, GET, GETALL, or POST.

$connectTime*

(ConnectTime)

The time taken to connect to the server.

$downloadTime*

(DownloadTime)

The time taken to download the file.

(Elements)

The number of page elements received.

$formname

The name of the form used in a POST action.

$lastStatus*

(PageStatus)

If a profile element retrieves multiple pages, this element contains the result string of the last page retrieved. This value is the same as that of $urlResultn where n is equal to the value of $pageCount.

$lastModified

The value of the Last-Modified HTTP header field of the first page retrieved.

$page*

(Page)

The page accessed on the HTTP server.

$pageCount

The total number of resources downloaded during a GETALL test, excluding the test page itself. If the tested page does not refer to any other resources, this element is not generated.

$port*

(Port)

The port used to access the HTTP server. If the test used a proxy server, this is the value of the port on the proxy server to which the request was submitted.

To preserve the port of the intended destination server, set the generateProxyTokens property to 1, or start the monitor with the -generateproxytokens command line parameter

$previousChecksum

The PreviousChecksum element does not normally provide meaningful values for service level classifications because checksum values are not known when the profile element is created (the monitor calculates checksum values while tests are in progress). The $previousChecksum and $checksum monitor elements are intended for alert enrichment using the monitor's rules file.

$proxyAuthType

The server authentication type for the proxy server.

$proxyCache

The value true indicates that the proxy server retrieved the web page from the server, rather than from its own cache.

$proxyPort

The port number of the proxy server to which the request was submitted.

$proxyServer

The host name of the proxy server.

$proxyUsername

Used by the monitor together with the password to log into the proxy server.

$regexpMatchn

The contents of the line matching the regular expression.

$regexpn

The regular expression.

$regexpMatchn

The contents of the line matching the regular expression.

$regexpStatusn

The status of the regular expression match:

NONE - No regular expression checking is configured

MATCHED - A match was found for the regular expression

FAILED - A match was not found for the regular expression

$responsetime*

(ResponseTime)

The time taken after a connection is created, until the first byte of the page is received.

$timeSinceModification

The time that has elapsed since the page was last modified. This is the difference between the time of the test and the value of the Last-Modified HTTP header field of the first page retrieved.

$urlDownloadTimesn*

(UrlDownloadTime)

URL download time of each element in a GETALL request. Each element is numbered, starting with 000 ($urlDownloadTime000, $urlDownloadTime001, $urlDownloadTime002, and so on).

$urln*

(Url)

URL of each page in a GETALL test. Each page is numbered, starting with 000 ($url000, $url001, $url002, and so on).

$urlResultn*

(UrlResultString)

Result string for each page downloaded in a GETALL request. Each result is numbered, starting with 000 ($urlResult000, $urlResult001, $urlResult002, and so on).

$username

The name used to access pages that require the user to be authenticated.

Note: The monitor generates the $proxyName elements if the generateProxyTokens property has the value 1, or you started the monitor with the -generateproxytokens command line parameter.


Last updated: September 2014