Specific fields for HTTP attributes
In the Attribute information page Figure 182, there are two fields for HTTP attributes that define how data is collected from the URL. The Attribute Type field can be any value from a list that controls the information about the URL that is returned. Some attribute types require a value in the Type Value field.
The following table describes all of the attribute types for the Managed URLs attribute group, and the type value when one is required:
| Attribute type | Description | Type value | Data type returned | Differences with FTP and file protocols |
|---|---|---|---|---|
| XPath Query | Runs an XPath query on the content returned from a URL connection. The query must be written to return data useful for an attribute, not a list of nodes. | The XPath query to run against the content obtained from a URL connection. | The data returned can be a string, a numeric, or a timestamp value. If the data is in the XML DateTime format, you can specify timestamp as the attribute type and the agent converts the value to a Candle Timestamp. | None |
| Response Time | The amount of time in milliseconds that it took to download the content from the requested URL. | None | Integer (number of milliseconds) | None |
| Response Message | The HTTP response message that is returned by the server. | None | String | The response message applies only if the URL uses the HTTP or HTTPS protocols. |
| Response Code | The HTTP response code that is returned by the server. | None | Integer | The response code applies only if the URL uses the HTTP or HTTPS protocols. It is always 0 for file or FTP URLs. |
| Response Length | The size of the content in bytes that was downloaded from the requested URL | None | Integer (size in bytes) | None |
| Response Header | The response header can be used to retrieve a value from one of the URL response header fields. The argument specifies which field is requested. | The response header field to collect. | String | Generally FTP and file protocols do not have any headers that can be collected. |
| Request URL | The connection was made to this URL. All of the response keywords provide information about the connection to this URL. The XPath Query can be used to obtain information obtained from the content returned by accessing this URL. | None | String | None |
| Page Objects | The number of objects discovered on the monitored HTML page that are monitored by the URL Objects attribute group. | None | Integer | None |
| Total Object Size | The total size of the objects monitored in the URL Objects attribute group for this web page. | None | Integer (in bytes) | None |
| Alias | The user specified alias for this URL. | None | String | None |
| User | The user specified data for this URL. | None | String | None |
The following table describes the attribute types for the URL Objects attribute group:
| Attribute type | Description | Type value | Data type returned | Differences with FTP and file protocols |
|---|---|---|---|---|
| URL | The URL that is monitored in the Managed URLs table. | None | String | None |
| Object Name | The URL for the object being monitored within the HTML page. | None | String | None |
| Object Size | The size in bytes of the content downloaded from the Object Name URL. | None | Numeric | None |
| Object Response Time | The time in milliseconds it took to download the page object. | None | Numeric | None |