pdweb.doccache component

Edit online

The pdweb.doccache statistics component gathers information about WebSEAL document-caching activity. This component reports statistics for all MIME types that aer enabled in the [content-cache] stanza of the WebSEAL configuration file. This component is always enabled by default and cannot be disabled.

The following list describes the types of global information available for all MIME types:
General Errors
The number of errors reported by the pdweb.doccache component when there are memory allocation failures, initialization failures, or invalid MIME type header values.
Uncachable
The number of instances when there is no cache that is defined for the MIME type of the document to be cached.
Pending Deletes
The number of entries that are marked for deletion, but these entries are still in use.
Pending Size
The number of bytes that are used by entries that are marked for deletion, but these entries are still in use.
Misses
The number of times a URL is looked up in the document cache and is not found. A found cached document eliminates the need to access the real document again.
Cache MIME type
The MIME type of documents that is stored in this cache. The following list describes the cache MIME types:
Max size
The maximum combined byte size of all documents in the cache.
Max entry size
The maximum byte size for any single cached document. If the document size exceeds this internally calculated value, it is not cached.
Size
The total byte count for all documents currently located in the cache.
Count
The current number of entries in the cache.
Hits
The number of successful lookups. (Documents that are successfully found in the cache.)
Stale hits
The number of successful lookups that found an entry that was too old and was purged instead.
Create waits
The number of times subsequent requests for a document are blocked (made to wait) while the document content is initially being cached.
Cache no room
The number of times a document that is valid for caching cannot fit into the cache. The reason is that there are too many entries that are being created at the same time.
Additions
The number of successful new entries in the cache.
Aborts
The number of times the creation of a new cache entry is canceled. The reason might be a header that indicates the entry must not be cached.
Deletes
The number of cache entries that were deleted because the entry is stale (expired) or because the creation was canceled.
Updates
The number of entries that had expiry times updated.
Too big error
The number of attempts to cache documents that exceed the maximum entry size (and therefore are not cached).
MT errors
The number of times more than one thread tries to create the same entry in the cache. (MT=Multi-Threading)
The following example shows the output from a stats get command for the pdweb.doccache component: 
#pdadmin> server task default-webseald-instance stats get pdweb.doccache

General Errors : 0
Uncachable     : 0
Pending Deletes: 0
Pending Size   : 0
Misses         : 0
Cache MIME type  : text/html
  Max size       : 2048000
  Max entry size : 128000
  Size           : 0
  Count          : 0
  Hits           : 0
  Stale hits     : 0
  Create waits   : 0
  Cache no room  : 0
  Additions      : 0
  Aborts         : 0
  Deletes        : 0
  Updates        : 0
  Too big errors : 0
  MT errors      : 0