C
Invalidation and Statistics Document Type Definitions

This appendix describes the Document Type Definition (DTD), or grammar, of invalidation requests and responses.

This appendix contains these topics:

• Invalidation DTD

• Statistics DTD

Invalidation DTD

This section describes the DTD of invalidation requests and responses. The DTD for both requests and responses is defined within WCSinvalidation.dtd, located in the $ORACLE_HOME/webcache/invalidation directory on UNIX and the ORACLE_HOME\webcache\invalidation directory on Windows.

This section contains the following topics:

• Invalidation Request and Response DTD

• Invalidation Preview Request and Response DTD

Invalidation Request and Response DTD

Figure C-1 shows the portion of the DTD for invalidation requests.

Figure C-1 Invalidation Request DTD

<!-- root element for invalidation request -->
<!ELEMENT    INVALIDATION     (SYSTEM?,OBJECT+)>

<!-- VERSION is currently "WCS-1.1" without the quotes -->
<!ATTLIST    INVALIDATION
             VERSION          CDATA          #REQUIRED
>

<!ELEMENT    SYSTEM           (SYSTEMINFO+)>

<!ELEMENT    SYSTEMINFO       EMPTY>
<!ATTLIST    SYSTEMINFO
             NAME             CDATA          #REQUIRED
             VALUE            CDATA          #IMPLIED
>

<!ELEMENT    OBJECT           ((BASICSELECTOR|ADVANCEDSELECTOR), ACTION, INFO?)>

<!ELEMENT    BASICSELECTOR    EMPTY>
<!ATTLIST    BASICSELECTOR
             URI              CDATA          #REQUIRED
>

<!ELEMENT    ADVANCEDSELECTOR (COOKIE|HEADER|OTHER)*>
<!ATTLIST    ADVANCEDSELECTOR
             URIPREFIX        CDATA          #REQUIRED
             HOST             CDATA          #IMPLIED
             URIEXP           CDATA          #IMPLIED
             METHOD           CDATA          #IMPLIED
             BODYEXP          CDATA          #IMPLIED
>

<!ELEMENT    COOKIE           EMPTY>
<!ATTLIST    COOKIE
             NAME             CDATA          #REQUIRED
             VALUE            CDATA          #IMPLIED
>

<!ELEMENT    HEADER           EMPTY>
<!ATTLIST    HEADER
             NAME             CDATA          #REQUIRED
             VALUE            CDATA          #IMPLIED
>

<!ELEMENT    OTHER            EMPTY>
<!ATTLIST    OTHER
             TYPE             CDATA          #REQUIRED
             NAME             CDATA          #REQUIRED
             VALUE            CDATA          #IMPLIED
>

<!ELEMENT    ACTION           EMPTY>
<!ATTLIST    ACTION
             REMOVALTTL       CDATA          #IMPLIED
>
<!ELEMENT    INFO           EMPTY>
<!ATTLIST    INFO           VALUE       CDATA          #REQUIRED
>

Table C-1  Invalidation Request DTD Elements and Attributes

Element	Attribute	Description
INVALIDATION		Root element
	VERSION	Version of the WCSinvalidation.dtd file to use as the XML document type
SYSTEM
SYSTEMINFO		The possible NAME/VALUE pair in a request is as follows: NAME="WCS_PROPAGATE" VALUE="TRUE|FALSE" This pair specifies whether or not invalidation requests are propagated to cache cluster members. If WCS_PROPAGATE is TRUE, it overrides the setting for invalidation propagation in the configuration. If WCS_PROPAGATE is FALSE, it uses the setting specified in the configuration.
OBJECT
	BASICSELECTOR	Invalidation based on the URL
	ADVANCEDSELECTOR	Invalidation based on advanced invalidation selectors
	ACTION	Action to perform on documents
BASICSELECTOR
	URI	URL of the documents to be invalidated
ADVANCEDSELECTOR
	URIPREFIX	Prefix path of the documents to be invalidated The prefix path must begin with http|https://host_name:port/path/filename or with "/" and end with "/". http|https://host_name:port/path/filename is required if the HOST attribute is not specified. The prefix is interpreted literally, including reserved regular expression characters.
	URIEXP	URL of the documents to be invalidated underneath the URIPREFIX
	HOST	Host name and port number of the site (host_name:port) Port 80 is the default port for HTTP and port 443 is the default port for HTTPS.
	METHOD	HTTP request method of the documents to be invalidated
	BODYEXP	HTTP POST body message of the documents to be invalidated
COOKIE
	NAME	Cookie name used by the documents contained within the URL
	VALUE	Value of the cookie If no value is present, then only documents with the named cookie but without value are invalidated.
HEADER
	NAME	HTTP request header used by the documents contained within the URL
	VALUE	Value of the request header. The name must match the header of a multiple-version cacheability rule associated with this URL.
OTHER
	NAME	NAME is one of the following: URI to specify a match of the URL specified in VALUE BODY to specify a match of the HTTP POST body QUERYSTRING_PARAMETER to specify a match of an embedded URL parameter
	TYPE	TYPE is one of the following: SUBSTRING to specify a substring match REGEX to specify a regular expression match
	VALUE	Value of URI, BODY, or QUERYSTRING_PARAMETER
ACTION
	REMOVALTTL	Maximum time that documents can reside in the cache before they are invalidated. The default is 0 seconds.
INFO
	VALUE	Comment for the documents to be included in the invalidation result

Figure C-2 shows the portion of the DTD for invalidation responses.

Figure C-2 Invalidation Response DTD

<!-- root element for invalidation result -->
<!ELEMENT    INVALIDATIONRESULT (SYSTEM?, OBJECTRESULT+)>

<!-- VERSION is currently "WCS-1.1" without the quotes -->
<!ATTLIST    INVALIDATIONRESULT
             VERSION          CDATA          #IMPLIED
>

<!ELEMENT    OBJECTRESULT     ((BASICSELECTOR|ADVANCEDSELECTOR), RESULT, INFO?)>

<!ELEMENT    RESULT           EMPTY>
<!ATTLIST    RESULT
             ID               CDATA          #REQUIRED
             STATUS           CDATA          #REQUIRED
             NUMINV           CDATA          #REQUIRED
>

Table C-2  Invalidation Response DTD Elements and Attributes

Element	Attribute	Description
INVALIDATIONRESULT
	VERSION	Version of the WCSinvalidation.dtd file to use as the XML document type
SYSTEM
SYSTEMINFO		The possible NAME/VALUE pair in a response is as follows: NAME="WCS_CACHE_NAME" VALUE="string" This pair specifies the name of the cache.
OBJECTRESULT
	BASICSELECTOR	Invalidation based on the URL
	ADVANCEDSELECTOR	Invalidation based on advanced invalidation selectors
	RESULT	Action to perform on documents
	INFO	Comment specified in the INFO element of the invalidation request
BASICSELECTOR		See Also: "BASICSELECTOR"
ADVANCEDSELECTOR		See Also: "ADVANCEDSELECTOR"
RESULT
	ID	Sequence number of all the URLs sent in the invalidation response. If there are multiple URLs specified in the invalidation message, then the sequence number starts at 1 for the first URL and continues for each additional URL.
	STATUS	Status of the invalidation. Status is one of the following: SUCCESS for successful invalidations URI NOT CACHEABLE for documents that are not cacheable URI NOT FOUND for documents not found
	NUMINV	Number of documents invalidated

Invalidation Preview Request and Response DTD

Figure C-3 shows the portion of the DTD for invalidation preview requests.

Figure C-3 Invalidation Request DTD

<!-- root element for invalidation preview request -->
<!ELEMENT INVALIDATIONPREVIEW (SYSTEM?, (BASICSELECTOR|ADVANCEDSELECTOR))>

<!-- VERSION is currently "WCS-1.1" without the quotes -->
<!ATTLIST INVALIDATIONPREVIEW
          VERSION  CDATA #REQUIRED
          STARTNUM CDATA #REQUIRED
          MAXNUM   CDATA #REQUIRED
>

Table C-3  Invalidation Preview Request DTD Elements and Attributes

Element	Attribute	Description
INVALIDATIONPREVIEW
	VERSION	Version of the WCSinvalidation.dtd file to use as the XML document type
	STARTNUM	Number representing the first document to be listed
	MAXNUM	Number of documents to be listed
SYSTEM
SYSTEMINFO		The possible NAME/VALUE pair in a request is as follows: NAME="WCS_PROPAGATE" VALUE="TRUE|FALSE" This pair specifies whether or not invalidation requests are propagated to cache cluster members. If WCS_PROPAGATE is TRUE, it overrides the setting for invalidation propagation in the configuration. If WCS_PROPAGATE is FALSE, it uses the setting specified in the configuration.
BASICSELECTOR		See Also: "BASICSELECTOR"
ADVANCEDSELECTOR		See Also: "ADVANCEDSELECTOR"

Figure C-4 shows the portion of the DTD for invalidation preview responses.

Figure C-4 Invalidation Preview Response DTD

<!-- root element for invalidation preview result -->
<!ELEMENT INVALIDATIONPREVIEWRESULT (SYSTEM?, SELECTEDURL*)>

<!ATTLIST INVALIDATIONPREVIEWRESULT
          VERSION      CDATA #REQUIRED
          STATUS       CDATA #REQUIRED
          STARTNUM     CDATA #REQUIRED
          NUMURLS      CDATA #REQUIRED
          TOTALNUMURLS CDATA #REQUIRED
>

<!ELEMENT SELECTEDURL EMPTY>
<!ATTLIST SELECTEDURL VALUE CDATA #REQUIRED>

Table C-4  Invalidation Preview Response DTD Elements and Attributes

Element	Attribute	Description
INVALIDATIONPREVIEWRESULT
	VERSION	Version of the WCSinvalidation.dtd file to use as the XML document type
	STATUS	Status of the preview. Status is one of the following: SUCCESS for successful invalidations URI NOT CACHEABLE for documents that are not cacheable URI NOT FOUND for documents not found
	STARTNUM	Number representing the first document to be listed
	NUMURLS	Number of URLs returned in this preview result
	TOTALNUMURLS	Number of URLs matching the BASICSELECTOR or ADVANCEDSELECTOR selectors
SELECTEDURL		URLs matching the BASICSELECTOR or ADVANCEDSELECTOR selectors to be invalidated
BASICSELECTOR		See Also: "BASICSELECTOR"
ADVANCEDSELECTOR		See Also: "ADVANCEDSELECTOR"

Statistics DTD

Oracle9iAS Web Cache provides a simple, extensible, and flexible XML query interface to monitor the cache runtime information. You can query any selected group of data to get information about the performance of the cache, as well as information about the cache configuration.

This section describes the DTD of statistics requests and responses. The DTD for both requests and responses is defined within the file wcstats.dtd, located in the $ORACLE_HOME/webcache/dtds directory on UNIX and the ORACLE_HOME\webcache\dtds directory on Windows.

Figure C-5 shows the contents of the statistics DTD file, wcstats.dtd.

Figure C-5 Statistics DTD

<?xml version="1.0"?>
<!ELEMENT WCSTATS (GROUP*)>

<!ATTLIST WCSTATS DTD_VERSION CDATA #FIXED "1.0">

<!ELEMENT GROUP (PARAM*, ENTRY*, GROUP*)>
<!ATTLIST GROUP
  NAME CDATA #REQUIRED
>

<!ELEMENT PARAM EMPTY>
<!ATTLIST PARAM 
  NAME CDATA #REQUIRED
  VALUE CDATA #REQUIRED
>

<!ELEMENT ENTRY EMPTY>
<!ATTLIST ENTRY 
  NAME CDATA #REQUIRED
  VALUE CDATA #IMPLIED
>

Table C-5 describes the element names, the attributes, and descriptions of each attribute.

Table C-5  Statistics DTD

Element	Attribute	Description
WCSTATS		Root element
	DTD_VERSION	The version of the DTD to use as the XML document type. The valid value is 1.0.
	GROUP	You can specify more than one GROUP element in the request. GROUP can have child elements, including subgroups. If a request contains the GROUP element without any children, Oracle9iAS Web Cache returns all of the ENTRY values for the group as well as all subgroup values.
	NAME	A unique string associated with each statistic or group of statistics. In each top-level GROUP, NAME is associated with a unique numerical ID. You can use either the string or the numerical ID.
PARAM		An optional subelement of the element GROUP. This element is used to send input parameters. PARAM cannot have child elements. For example, to request URL_STATISTICS, you specify how many URLs are to be returned in the result. You pass the string "OBJECT_COUNT" as the NAME and the number of URLs to be returned as the VALUE.
	NAME	A string that names the data to be returned
	VALUE	A string used to pass values to the element
ENTRY		An optional subelement of the element GROUP. ENTRY cannot have child elements.
	NAME	A unique string associated with each statistic
	VALUE	A string used to pass values to the element or to retrieve values from Oracle9iAS Web Cache

Groups of Statistics

In the statistics DTD, types of data are grouped based on their logical relationship. The statistics DTD associates a group ID with each top-level group. To improve the performance of group lookup, you can use the number in the GROUP NAME field in your query XML message, rather than the string. (String comparison is a slower operation.)

To ensure the backward compatibility of all the XML messages, future versions of Oracle9iAS Web Cache will add new groups only after existing groups, without changing the existing order. If, in future versions, Oracle9iAS Web Cache deletes any existing groups, that group ID will not be reused for other purposes.

Table C-6 shows the group names and their corresponding group IDs.

Table C-6  Statistics Groups

Group Name	Group ID
TIME	101
PID	102
OPEN_CONNECTIONS	103
BYTES_SERVED	104
BYTES_SAVED_WITH_COMPRESSION	105
INVALIDATION_REQUESTS	106
INVALIDATED_OBJECTS	107
CACHED_DOC_COUNT	108
CACHED_DOC_SIZE	109
REFRESHES	114
COMPRESSED_HITS	115
COMPRESSED_MISSES	116
SESSION_COUNT	121
URL_STATS	124
CACHEABILITY_RULES	125
HTTP_REQUESTS	126
ERRORS	127
HITS	128
MISSES	129
CLUSTERS	130
SITE	131
HTTP_CLIENT_REQUESTS	132
CACHE_INFO	133

These groups are divided into five main categories:

• Cache Information Groups

• Runtime Statistics Groups

• Site Information Group

• Origin Server Statistics Group

• URL Statistics Group

Cache Information Groups

The cache information groups provide general information about caches.

Table C-7 lists the cache information groups and subgroups, the valid values that can be passed to the NAME attribute of the ENTRY element for the group, and a description of the attribute.

Table C-7  Cache Information Group

GROUP Name	ENTRY Name	Description
TIME		A group that returns information about how long the cache has been running and how long since the statistics were reset
	CACHE_START_TIME	The time when the cache was last started
	STATS_RESET_TIME	The time when the statistics were last reset
	LAST_MODIFIED_TIME	The time when the cache was last modified
PID		A group that returns information about the cache server ID
	CACHE_PROCESS	The process ID of the cache server
CACHED_DOC_COUNT		A group that returns information about documents in the cache
	CURRENT	The total number of documents currently stored in the cache. CURRENT returns the aggregate of the owned and on-demand documents
OWNED	CURRENT	A subgroup of CACHED_DOC_COUNT The number of owned documents currently stored in the cache
DEMAND	CURRENT	A subgroup of CACHED_DOC_COUNT The number of on-demand documents currently stored in the cache
CACHED_DOC_SIZE		A group that returns information about the size of documents in the cache
	CURRENT	The size, in bytes, of the documents currently stored in the cache. CURRENT returns the aggregate of the owned and on-demand documents
OWNED	CURRENT	A subgroup of CACHED_DOC_SIZE The size, in bytes, of the owned documents currently stored in the cache
DEMAND	CURRENT	A subgroup of CACHED_DOC_SIZE The size, in bytes, of the on-demand documents currently stored in the cache
CACHEABILITY_RULES		A group that returns information about the configured cacheability rules
RULE		A subgroup of CACHEABILITY_RULES
	INDEX	An index generated by Oracle9iAS Web Cache that represents the cacheability rule
	REGULAR_EXPRESSION	The regular expression specified for the cacheability rule
	SITE_MASK	A string that is used to map multiple site names to one or more origin servers
CLUSTERS		A group that returns information about Oracle9iAS Web Cache clusters
	MEMBER_COUNT	The number of caches that are members of the cluster
	NAME	The cluster name
	CONFIG_CHECKSUM	A value generated by Oracle9iAS Web Cache that indicates the version of the configuration file
CACHE_INFO		A group that returns information about the size of the cache
	MAX_CACHE_SIZE	The maximum cache size as configured in the Resource Limits page
	ACTION_LIMIT_SIZE	Ninety percent of the maximum cache size (MAX_CACHE_SIZE)
	ALLOCATED_MEM_SIZE	The physical size of the cache, which is the amount of data memory allocated by Oracle9iAS Web Cache for cache storage and operation

Runtime Statistics Groups

Oracle9iAS Web Cache collects two types of runtime statistics:

• General runtime statistics

• Timed runtime statistics

Table C-8 lists the general runtime statistics groups and subgroups, the valid values that can be passed to the NAME attribute of the ENTRY element for the group, and a description of the attribute.

Table C-8  General Runtime Statistics Group

GROUP Name	ENTRY Name	Description
OPEN_CONNECTIONS		A group that returns information about the connections to the cache
	CURRENT	The number of current open connections to the cache
	MAX_SINCE_START	The maximum number of connections to the cache that have been open at the same time since the cache was last started
APP_SRVR_REQUEST_BACKLOG		A group that returns information about origin server request backlogs
	CURRENT	The current number of requests that the origin server is processing for Oracle9iAS Web Cache
	MAX_SINCE_START	The maximum number of requests that the origin server has processed for Oracle9iAS Web Cache since the cache was last started
SESSION_COUNT		A group that returns information about the connections to Oracle9iAS Web Cache.
	CURRENT	The number of current active connections that Oracle9iAS Web Cache has open
	MAX_SINCE_START	The maximum number of current connections that Oracle9iAS Web Cache had open at any one time since it was last started
CACHE_REDIRECT_DOC_COUNT		A group that returns information about document redirection
	CURRENT	The number of documents currently redirected by Oracle9iAS Web Cache
	MAX_SINCE_START	The maximum number of documents redirected by Oracle9iAS Web Cache since the cache was last started

Table C-9 lists the timed runtime statistics groups and subgroups and a description of each group or subgroup.

The following strings are valid values for the NAME attribute of the ENTRY element of all of the timed statistics listed in Table C-9:

• RECENT_PER_SEC: The average number for each second during the last ten seconds

• MAX_PER_SEC_SINCE_START: The maximum number for each second since the cache was last restarted

• AVG_PER_SEC_SINCE_START: The average number for each second since the cache was last restarted

• TOTAL_SINCE_START: The total number since the cache was last restarted

• TOTAL_SINCE_RESET: The total number since the statistics were reset

• AVG_PER_SEC_SINCE_RESET: The average since the statistics were reset

Table C-9  Timed Runtime Statistics Group

Group Name	Description
BYTES_SERVED	The ENTRY elements for this group return statistics about the bytes served by the cache.
HTTP_REQUESTS	The ENTRY elements for this group return statistics about the browser, peer cache, and ESI requests served by the cache.
HTTP_CLIENT_REQUESTS	The ENTRY elements for this group return statistics about the browser and peer cache requests served by the cache.
BYTES_SAVED_WITH_COMPRESSION	The ENTRY elements for this group return statistics about the additional bytes sent to browsers if in-cache compression is turned off.
INVALIDATION_REQUESTS	The ENTRY elements for this group return statistics about the invalidation requests submitted to the cache.
INVALIDATED_OBJECTS	The ENTRY elements for this group return statistics about the objects invalidated.
HITS	The ENTRY elements for this group return statistics about the browser requests resolved by documents in the cache. Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
FRESH_HITS	A subgroup of the group HITS The ENTRY elements for this group return statistics about the browser requests resolved by documents in the cache. Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
FROM_OWNED_TO _CLIENT	A subgroup of the group FRESH_HITS The ENTRY elements for this group return statistics about browser requests resolved by owned documents in the cache.
FROM_OWNED_TO_PEER	A subgroup of the group FRESH_HITS The ENTRY elements for this group return statistics about browser requests resolved by retrieving owned documents from a peer cache.
FROM_DEMAND_TO_CLIENT	A subgroup of the group FRESH_HITS The ENTRY elements for this group return statistics about browser requests resolved by on-demand content.
STALE_HITS	A subgroup of the group HITS The ENTRY elements for this group return statistics about browser requests resolved by expired or invalidated content. Every STALE_HITS element in this group returns the aggregate value of the corresponding STALE_HITS elements in the subgroups.
FROM_OWNED_TO_CLIENT	A subgroup of the group STALE_HITS The ENTRY elements for this group return statistics about browser requests resolved by expired or invalidated owned content.
FROM_OWNED_TO_PEER	A subgroup of the group STALE_HITS The ENTRY elements for this group return statistics about browser requests resolved by expired or invalidated owned documents from a peer cache.
FROM_DEMAND_TO_CLIENT	A subgroup of the group STALE_HITS The ENTRY elements for this group return statistics about browser requests resolved by expired or invalidated on-demand content.
MISSES	The ENTRY elements for this group return statistics about cacheable and noncacheable misses. Misses are browser requests for documents that were not served by the cache. Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
CACHEABLE_MISSES	A subgroup of the group MISSES The ENTRY elements for this group return statistics about cacheable misses. Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
FROM_OWNED_TO_CLIENT	A subgroup of the group CACHEABLE_MISSES The ENTRY elements for this group return statistics about browser requests for cacheable owned documents that were not served by the cache.
FROM_OWNED_TO_PEER	A subgroup of the group CACHEABLE_MISSES The ENTRY elements for this group return statistics about browser requests for documents owned by a peer cache that were not served by the cache.
FROM_DEMAND_TO_CLIENT	A subgroup of the group CACHEABLE_MISSES The ENTRY elements for this group return statistics about cacheable misses for on-demand content.
NONCACHEABLE_MISSES	A subgroup of the group MISSES The ENTRY elements for this group return statistics about noncacheable misses Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
FROM_OWNED_TO_CLIENT	A subgroup of the group NONCACHEABLE_MISSES The ENTRY elements for this group return statistics about noncacheable misses for owned documents.
FROM_OWNED_TO_PEER	A subgroup of the group NONCACHEABLE_MISSES The ENTRY elements for this group return statistics about noncacheable misses for documents owned by a peer cache.
FROM_DEMAND_TO_CLIENT	A subgroup of the group NONCACHEABLE_MISSES The ENTRY elements for this group return statistics about noncacheable misses for on-demand content.
OWNER_UNKNOWN	A subgroup of the group NONCACHEABLE_MISSES The ENTRY elements for this group return statistics about noncacheable misses for which the owner is unknown.
REFRESHES	The ENTRY elements for this group return statistics about the documents that the cache has refreshed from the application Web servers.
COMPRESSED_HITS	The ENTRY elements for this group return statistics about the total requests served from the cache in compressed form.
COMPRESSED_MISSES	The ENTRY elements for this group return statistics about the total requests retrieved from the application Web servers and compressed by the cache before serving.
ERRORS	The ENTRY elements for this group return statistics about the apology pages that the cache has served. Every ENTRY element in this group returns the aggregate value of the corresponding ENTRY elements in the subgroups.
NETWORK_ERRORS	A subgroup of the group ERRORS The ENTRY elements for this group return statistics about the apology pages that the cache has served to Web browsers due to a network error.
SITE_BUSY_ERRORS	A subgroup of the group ERRORS The ENTRY elements for this group return statistics about the apology pages that the cache has served to Web browsers due to a network or busy Web site error.
PARTIAL_PAGE_ERRORS	A subgroup of the group ERRORS The ENTRY elements for this group return statistics about the apology pages that the cache has served to Web browsers due to an HTML fragment retrieval problem for a page that supports partial page caching.

Site Information Group

The site information group provides multiple-site support. You can request statistics for all sites or for a specific site. Oracle9iAS Web Cache first checks to see if this group exists in the request message, then requests the statistics, ensuring that the correct statistics are returned to multiple-site environments.

Table C-10 lists the site information group, the valid values that can be passed to the NAME attribute of the ENTRY element for the group, and a description of the attribute.

Table C-10  Site Information Group

GROUP Name	ENTRY Name	Description
SITE		A group that returns information about a Web site
	ID	An index generated by Oracle9iAS Web Cache as an identifier of the site
	NAME	The name of the site

Origin Server Statistics Group

The origin server statistics group provides information and statistics about the origin server.

Origin server statistics can contain multiple SERVER subgroups. Each SERVER group contains origin server configuration information as well as origin server runtime statistics. The runtime statistics are similar in format to cache runtime statistics

Table C-11 lists the origin server statistics groups and subgroups, the valid values that can be passed to the NAME attribute of the ENTRY element for the group, and a description of the attribute.

Table C-11  Origin Server Statistics Group

GROUP Name	ENTRY Name	Description
APP_SRVR_STATS		A group that returns information about origin servers
SERVER		A subgroup of the group APP_SRVR_STATS
	HOSTNAME	The name of the host on which the origin server is running
	PORT	The port number from which the origin server is listening for Oracle9iAS Web Cache requests
	IS_PROXY	Whether or not the origin server is a proxy server. Valid values are "NO" and "YES"
	STATUS	The status of the origin server
	SECONDS_SINCE_STATUS_CHANGE	The number of seconds since the status of the origin server changed
REQUESTS		A subgroup of the group SERVER
	RECENT_PER_SECOND	The average number of requests served for each second during the last ten seconds
	MAX_PER_SEC_SINCE_START	The maximum number of requests served for each second since the origin server was last restarted
	AVG_PER_SEC_SINCE_START	The average number of requests served for each second since the origin server was last restarted
	TOTAL_SINCE_START	The total number of requests served since the origin server was last restarted.
	TOTAL_SINCE_RESET	The total number of requests served since the statistics were reset
	AVG_PER_SEC_SINCE_RESET	The average number of requests served for each second since the statistics were reset
LATENCY		A subgroup of the group SERVER
	RECENT_PER_SECOND	The average number of seconds, in the last 10-second interval, used to process requests for Oracle9iAS Web Cache
	MAX_PER_SEC_SINCE_START	The maximum number of seconds used to process requests for Oracle9iAS Web Cache since the origin server started
	AVG_PER_SEC_SINCE_START	The average number of seconds used to process requests for Oracle9iAS Web Cache since the origin server started
	TOTAL_SINCE_START	The total number of seconds used to process requests for Oracle9iAS Web Cache since the origin server started
	TOTAL_SINCE_RESET	The total number of seconds used to process requests for Oracle9iAS Web Cache since the statistics were reset
	AVG_PER_SEC_SINCE_RESET	The average number of seconds used to process requests for Oracle9iAS Web Cache since the statistics were reset
ACTIVE_SESSIONS		A subgroup of the group SERVER
	CURRENT	The number of current active connections from Oracle9iAS Web Cache that the origin server has open
	MAX_SINCE_START	The maximum number of active connections from Oracle9iAS Web Cache that the origin server has had open at any one time
OPEN_CONNECTIONS		A subgroup of the group SERVER
	CURRENT	The number of current connections from Oracle9iAS Web Cache that the origin server has open
	MAX_SINCE_START	The maximum number of connections from Oracle9iAS Web Cache that the origin server has had open at any one time

URL Statistics Group

The URL statistics group returns the URLs of the most popular documents. You specify the number of URLs to be returned. This is the information returned as the Most Popular Documents in the Cache Contents page (Administration > Monitoring > Cache Contents) of Oracle9iAS Web Cache Manager.

The URL statistics group can contain multiple URL subgroups.

Table C-12 lists the URL statistics groups and subgroups, the valid values that can be passed to the NAME attribute of the ENTRY element for the group, and a description of the attribute.

Table C-12  URL Statistics Group

GROUP Name	PARAM or ENTRY Name	Description
URL_STATS		A group that returns information about the most popular documents in the cache.
	OBJECT_COUNT (PARAM)	The number of the most popular URLs to be returned. You must supply a number to the VALUE attribute.
URL		A subgroup of the group URL_STATS
	URLNAME (ENTRY)	The URL of the request.
	SCORE (ENTRY)	An internally generated, relative value that indicates the popularity of a URL
	CACHABILITYRULE (ENTRY)	The index to the cacheability rule that triggered the document to be cached
	SIZE (ENTRY)	The size of the document represented by the URL

Query Methods

To retrieve Oracle9iAS Web Cache statistics, you send a POST message to the Oracle9iAS Web Cache statistics port. By default, the statistics port is 4002.

Each request must include the authentication header as part of the message. The following example shows the authentication header:

POST / HTTP/1.0
Authorization: BASIC < base64 encoding of administrator:administrator_password>
content-length: #bytes

In the example, #bytes refers to the size, in bytes, of the body of the statistics request.

The body of a statistics request must begin with the following:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS DTD_VERSION="1.0">

If the request XML message contains the ENTRY element, the response will return the value of that ENTRY. If the message contains the GROUP element without any children, it will return all ENTRY values for the group as well as all ENTRY values for the subgroup.

Examples

The following examples illustrate XML request and response messages.

Figure C-6 shows the request and response messages that retrieve the URLs of 50 of the most popular objects in the cache. It uses the GROUP ID, 124, rather than the GROUP NAME, URL_STATS.

Figure C-6 Obtaining the URLs of the Most Popular Documents

The following code shows the request:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS DTD_VERSION="1.0">
<GROUP NAME="124"/> 
   <!-- NAME="URL_STATS" -->
   <PARAM NAME="OBJECT_COUNT" VALUE="50"/>
</WCSTATS>

The following code shows the response:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd"/>

<WCSTATS  DTD_VERSION="1.0">
<GROUP NAME="124">
 <PARAM NAME="OBJECT_COUNT" VALUE="50"/>
 <GROUP NAME="URL"/>
   <ENTRY NAME="NAME" VALUE="/sitename:port/admin/images/headers/maglass.gif/"/>

   <ENTRY NAME="SCORE" VALUE="99"/>
   <ENTRY NAME="CACHABILITYRULE" VALUE="1"/>
   <ENTRY NAME="SIZE" VALUE="1037"/>
 </GROUP>
.
.
.
</GROUP>
</WCSTATS>

Figure C-7 shows the request and response messages that retrieve the number of objects recently invalidated for each second. The example uses the GROUP ID, 107, rather than the GROUP NAME, INVALIDATED_OBJECTS.

Figure C-7 Obtaining the Number of Invalidated Objects

The following code shows the request:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS  DTD_VERSION="1.0">
<GROUP NAME="107"> <!-- NAME="INVALIDATED_OBJECTS" -->
  <ENTRY NAME="RECENT_PER_SEC"/>
</GROUP>
</WCSTATS>

The following code shows the response:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS  DTD_VERSION="1.0">
<GROUP NAME="107" NAME="INVALIDATED_OBJECTS">
 <ENTRY NAME="RECENT_PER_SEC" VALUE="50"/>
</GROUP>
</WCSTATS>

Figure C-8 shows the request and response messages that retrieve all statistics for the group INVALIDATED_OBJECTS. The example uses the GROUP ID, 107, rather than the GROUP NAME, INVALIDATED_OBJECTS. Because the request contains only the GROUP element, Oracle9iAS Web Cache returns all statistics in the group.

Figure C-8 Obtaining All Statistics for Invalidated Objects

The following code shows the request:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS DTD_VERSION="1.0">
<GROUP NAME="107"/>
</WCSTATS>

The following code shows the response:

<?xml version="1.0"?>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">

<WCSTATS DTD_VERSION="1.0">
<GROUP NAME="107"> <!-- INVALIDATED_OBJECTS -->
 <ENTRY NAME="RECENT_PER_SEC" VALUE="50"/>
 <ENTRY NAME="MAX_SINCE_START" VALUE="100"/>
 <ENTRY NAME="AVG_SINCE_START" VALUE="36"/>
 <ENTRY NAME="TOTAL_SINCE_START" VALUE="1000"/>
 <ENTRY NAME="TOTAL_SINCE_RESET" VALUE="500"/>
 <ENTRY NAME="AVG_SINCE_RESET" VALUE="30"/>
</GROUP>
</WCSTATS>

Complete Statistics Template

Figure C-9 lists a complete template for all elements in the statistics DTD.

Figure C-9 Complete Statistics Template

<?xml version="1.0"?>

<WCSTATS>
<!DOCTYPE WCSTATS SYSTEM "internal:///wcstats.dtd">
<WCSTATS DTD_VERSION="1.0">

<!-- Cache_Information -->
<GROUP NAME="TIME">
  <ENTRY NAME="CACHE_START_TIME" VALUE=""/>
  <ENTRY NAME="STATS_RESET_TIME" VALUE=""/>
  <ENTRY NAME="LAST_MODIFIED_TIME" VALUE=""/>
</GROUP>

<GROUP NAME="PID">
  <ENTRY NAME="CACHE_PROCESS" VALUE=""/> 
</GROUP>

<GROUP NAME="CACHED_DOC_COUNT">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <GROUP NAME="OWNED">
    <ENTRY NAME="CURRENT" VALUE=""/>
  </GROUP>
  <GROUP NAME="DEMAND">
    <ENTRY NAME="CURRENT" VALUE=""/>
  </GROUP>
</GROUP>
<GROUP NAME="CACHED_DOC_SIZE">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <GROUP NAME="OWNED">
    <ENTRY NAME="CURRENT" VALUE=""/>
  </GROUP>
  <GROUP NAME="DEMAND">
    <ENTRY NAME="CURRENT" VALUE=""/>
  </GROUP>
</GROUP>

<GROUP NAME="CACHEABILITY_RULES">
  <GROUP NAME="RULE">
    <ENTRY NAME="INDEX" VALUE=""/>
    <ENTRY NAME="REGULAR_EXPRESSION" VALUE=""/>
    <ENTRY NAME="SITE_MASK" VALUE=""/>
  </GROUP>
   .
   .
   .
</GROUP>
<GROUP NAME="CLUSTERS">
  <ENTRY NAME="MEMBER_COUNT" VALUE=""/>
  <ENTRY NAME="NAME" VALUE=""/>
  <ENTRY NAME="CONFIG_CHECKSUM" VALUE=""/>
</GROUP>

<GROUP NAME="CACHE_INFO">
  <ENTRY NAME="MAX_CACHE_SIZE" VALUE=""/>
  <ENTRY NAME="ACTION_LIMIT_SIZE" VALUE=""/>
  <ENTRY NAME="ALLOCATED_MEM_SIZE" VALUE=""/>
</GROUP>

<!-- General Runtime Statistics -->
<GROUP NAME="OPEN_CONNECTIONS">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
</GROUP>

<GROUP NAME="APP_SRVR_REQUEST_BACKLOG">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
</GROUP>
<GROUP NAME="SESSION_COUNT">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
</GROUP>
<GROUP NAME="CACHE_REDIRECT_DOC_COUNT">
  <ENTRY NAME="CURRENT" VALUE=""/>
  <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
</GROUP>

<!-- Timed Runtime Statistics -->
<GROUP NAME="BYTES_SERVED">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>

<GROUP NAME="HTTP_REQUESTS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="HTTP_CLIENT_REQUESTS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>

<GROUP NAME="BYTES_SAVED_WITH_COMPRESSION">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>

<GROUP NAME="INVALIDATION_REQUESTS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>

<GROUP NAME="INVALIDATED_OBJECTS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="HITS">
<ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
<ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>

<GROUP NAME="FRESH_HITS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  <GROUP NAME="FROM_OWNED_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>  
  <GROUP NAME="FROM_OWNED_TO_PEER">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_DEMAND_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
</GROUP>
<GROUP NAME="STALE_HITS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  <GROUP NAME="FROM_OWNED_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_OWNED_TO_PEER ">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_DEMAND_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>  
</GROUP>
</GROUP>
<GROUP NAME="MISSES">
<ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
<ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>

<GROUP NAME="CACHEABLE_MISSES">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  <GROUP NAME="FROM_OWNED_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_OWNED_TO_PEER">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>  
  <GROUP NAME="FROM_DEMAND_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
</GROUP>
<GROUP NAME="NONCACHEABLE_MISSES">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  <GROUP NAME="FROM_OWNED_TO_PEER">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_OWNED_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
  <GROUP NAME="FROM_DEMAND_TO_CLIENT">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>  
  <GROUP NAME="OWNER_UNKNOWN">
    <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
    <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
    <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>      
    <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
  </GROUP>
</GROUP>
</GROUP>
<GROUP NAME="REFRESHES">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="COMPRESSED_HITS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="COMPRESSED_MISSES">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="ERRORS">
<ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
<ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
<ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
<ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
<GROUP NAME="NETWORK_ERRORS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="SITE_BUSY_ERRORS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
<GROUP NAME="PARTIAL_PAGE_ERRORS">
  <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
  <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
  <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>
  <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
</GROUP>
</GROUP>

<!-- Multisite Statistics -->
<GROUP NAME="SITE">
  <ENTRY NAME="ID" VALUE=""/>
  <ENTRY NAME="NAME" VALUE=""/>
</GROUP>

<!-- Origin Server Statistics-->
<GROUP NAME="APP_SRVR_STATS">
  <GROUP NAME="SERVER">
    <ENTRY NAME="HOSTNAME" VALUE="">
    <ENTRY NAME="PORT" VALUE="">
    <ENTRY NAME="IS_PROXY" VALUE="">
    <ENTRY NAME="STATUS" VALUE="">
    <ENTRY NAME="SECONDS_SINCE_STATUS_CHANGE" VALUE=""/>
    <GROUP NAME="REQUESTS">
      <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
      <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
      <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
      <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
      <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>        
      <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
    </GROUP>
    <GROUP NAME="LATENCY">
      <ENTRY NAME="RECENT_PER_SEC" VALUE=""/>
      <ENTRY NAME="MAX_PER_SEC_SINCE_START" VALUE=""/>
      <ENTRY NAME="AVG_PER_SEC_SINCE_START" VALUE=""/>
      <ENTRY NAME="TOTAL_SINCE_START" VALUE=""/>
      <ENTRY NAME="TOTAL_SINCE_RESET" VALUE=""/>        
      <ENTRY NAME="AVG_PER_SEC_SINCE_RESET" VALUE=""/>
    </GROUP>
    <GROUP NAME="ACTIVE_SESSIONS">
      <ENTRY NAME="CURRENT" VALUE=""/>
      <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
    </GROUP>
    <GROUP NAME="OPEN_CONNECTIONS">
      <ENTRY NAME="CURRENT" VALUE=""/>
      <ENTRY NAME="MAX_SINCE_START" VALUE=""/>
    </GROUP>
  </GROUP>
  ...
</GROUP>

<!-- URL Statistics -->
<GROUP NAME="URL_STATS">
  <PARAM NAME="OBJECT_COUNT" VALUE="50"/>
  <GROUP NAME="URL">
    <ENTRY NAME="URLNAME" VALUE=""/>
    <ENTRY NAME="SCORE" VALUE=""/>
    <ENTRY NAME="CACHABILITYRULE" VALUE=""/>
    <ENTRY NAME="SIZE" VALUE=""/>
  </GROUP>
  .
  .
  .
</GROUP>

</WCSTATS>