Extended Logging Enhancements in Excelerator 2.3

Excelerator 2.3 includes the following extended logging enhancements.


Standard Header Field Logging

The following standard header fields are now supported.

NOTE:  Sc refers to server-to-client response headers, and cs refers to client to server request headers. Header content is included in double quotation marks, with null content indicated by a pair of marks.


sc-(Content-Range)


Purpose

This field records the byte ranges vended from an Excelerator cache device to a requesting client.


Values:

The results include the word bytes, are enclosed in double quotes ("), and are either one or more byte ranges separated by commas (,) or a null value ("") if this field is not applicable to the specific log entry (i.e. this is not a byte range request).

NOTE:  A client may request one or more byte ranges in a single request and subsequently, a server may respond with one or more ranges.

In the case of a single range being vended, the log entry will contain an entry equivalent to the HTTP Content-Range header.

In the case of a multi-part response from the server, there are multiple Content-Range headers, which are found preceding each byte range. For multi-part range responses, the log entry will contain each of the ranges vended separated by commas, followed by a slash "/" and the total size of the object.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogcontentrange = yes

apply

where name is the name of your web accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogcontentrange = no

apply

where name is the name of your web accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogcontentrange

where name is the name of your Web Accelerator service.


Examples

"bytes 100-200/2000","bytes 500-700,952-999/2000",""


cs(Range)


Purpose

This field records the byte ranges requested by a client to the Excelerator cache device.


Values

The results include the word bytes, are enclosed in double quotes ("), and are either one or more byte ranges separated by commas (,) or a null value ("") if this field is not applicable to the specific log entry (i.e. this is not a byte range request).


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogrange = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogrange = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogrange

where name is the name of your Web Accelerator service.


Examples

"bytes 100-200", "bytes 500-700, 952-999", ""


cs(If-Range)


Purpose

This field records whether the client request was a conditional range request.


Values

The result is enclosed in double quotation marks (") and is either the text of the range request or a null value ("") if this field is not applicable to the specific log entry (i.e. this is not a conditional byte range request).

NOTE:  The value is typically either an Etag or a date.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogifrange = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogifrange = no

apply

where name is the name of your Web Accelerator service.


Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogifrange

where name is the name of your Web Accelerator service.


Examples

"Etag1234", "Tue, 17 Oct 2002", ""


sc(Content-Length)


Purpose

This field records the size (in bytes) of the entire object being vended from an Excelerator cache device to a requesting client.


Values

The result is contained in double quotes (") and is either the content-length in bytes or null ("") if this field is not applicable to the specific log entry (i.e. the total size of the object is unknown).

NOTE:  A null value ("") in the field might indicate that the object is not in cache and has to be piped from the origin server.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogcontentlength = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogcontentlength = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogcontentlength

where name is the name of your Web Accelerator service.


Examples

"13245", "7776", ""


sc(Etag)


Purpose

This field records the Etag vended from an Excelerator cache device to a requesting client.


Values

The result is enclosed in double quotes (") and is either the etag-text or null ("") if this field is not applicable to the specific log entry (i.e. no Etag provided).

NOTE:  Etags may contain quotes, which will appear as "" to indicate that they are part of the field rather than the end of the field. For example, a log entry of ""123abc"" indicates an Etag value of "123abc". Etags may be used in conjunction with If-Range or other conditional requests.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogetag = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogetag = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogetag

where name is the name of your Web Accelerator service.


Examples

""132mydoghasflees45"", "w/"123hiabc"", ""


cs(Pragma)


Purpose

This field records the pragma value associated with a client request to an Excelerator cache device.


Values

The result is enclosed in double quotes (") and is either the pragma text value or null ("") if this field is not applicable to the specific log entry (i.e. a pragma header is not used).

NOTE:  For HTTP 1.1 no-cache is the only valid value for pragma and although pragma: no-cache is intended for client to server requests, it has been implemented in practice in server to client responses as well.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogrequestpragma = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogrequestpragma = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogrequestpragma

where name is the name of your Web Accelerator service.


Examples

"no-cache", ""


sc(Pragma)


Purpose

This field records the pragma value associated with a server response from an Excelerator cache device to a requesting client.


Values:

The result is enclosed in double quotation marks (") and contains either the pragma text value or is blank if the field is not applicable to the specific log entry (i.e. a pragma header is not used)

NOTE:  For HTTP 1.1 no-cache is the only valid value for pragma and although pragma: no-cache is intended for client to server requests, it has been implemented in practice in server to client responses as well.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogreplypragma = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogreplypragma = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogreplypragma

where name is the name of your Web Accelerator service.


Examples

"no-cache", ""


Pseudo Header Field Logging

The following pseudo header fields are also supported.


sc-completed


Purpose

This field either records that a transaction was completed successfully or it indicates the reason for a failure to complete.


Values

The field contains one of the following values:

Success

Indicates either a normal connection termination or that the transaction was completed and the persistent connection remains open

Timeout

Indicates the connection timed out, perhaps due to network failure, and Excelerator discarded the connection

Reset

Indicates the connection was terminated by the client

Administrative

indicates that Excelerator terminated the connection for reasons unrelated to the connection, such as Excelerator shutting down

-

Not applicable to the specific log entry

Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogcompleted = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogcompleted = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogcompleted

where name is the name of your Web Accelerator service.


Examples

Success, Reset, -


sc-header-size


Purpose

This field records the size (in bytes) of the HTTP header associated with a response to a client.


Values

The field will contain either a byte-count of the record size or a dash (-) if this field is not applicable to the specific log entry.

HINT:  To determine whether an entire object was downloaded, subtract this data from sc-bytes and compare the difference to the entity size.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogheadersize = yes

apply

where name is the name of your web accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogheadersize = no

apply

where name is the name of your web accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogheadersize

where name is replaced with the name of your Web Accelerator service.


Examples

678, 679, -


x-cache-info


Purpose

This field records brief status statements for objects vended from cache or brief reasons why a requested object was not cached.


Values

The following statements or reasons are enclosed in double quotation marks ("). Additional information is enclosed in parentheses ().

pass thru

 

error

 

redirect

 

in cache

fresh

revalidate each use

stale

not modified

updated

 

not in cache

filled

if revalidate each use

not cacheable

(The reasons it was revalidate each use)

(The reason is was not cacheable)

NOTE:  This information could be very useful in troubleshooting.


Enabling

To enable this option, enter the following at the command line:

set accelerator name extlogcacheinfo = yes

apply

where name is the name of your Web Accelerator service.


Disabling

To disable this option, enter the following at the command line:

set accelerator name extlogcacheinfo = no

apply

where name is the name of your Web Accelerator service.


Getting Status

To get logging status for this option, enter the following at the command line:

get accelerator name extlogcacheinfo

where name is the name of your Web Accelerator service.


Examples

"In Cache, Browser Requested Revalidate, Not Modified", "Not In Cache, Not Cacheable (No Validator Or Expiration Time)", "In Cache, Fresh"