Common Log File HTTP Operation Log Publisher

Common Log File HTTP Operation Log Publishers may be used to write information about HTTP operations to files on the local filesystem, using the W3C common log format.

Elements that will be included in log messages are:

1. The IP address of the remote client.
2. A dash, to indicate that RFC 1413 (ident) information about the client is not available.
3. The authenticated identity (e.g., username) for the client (from the REMOTE_USER header), or a dash if the client is not authenticated.
4. A timestamp for the request, using the format "'['dd/MMM/yyyy:HH:mm:ss Z']'".
5. Information about the request, which is the HTTP method (e.g., GET or POST) followed by the request path (including any query string) and HTTP protocol version.
6. The integer value of the HTTP status code returned to the client.
7. The number of bytes of actual content (e.g., excluding HTTP headers and other overhead) returned to the client.

dsconfig Usage

To list the configured Log Publishers:

dsconfig list-log-publishers
     [--property {propertyName}] ...

To view the configuration for an existing Log Publisher:

dsconfig get-log-publisher-prop
     --publisher-name {name}
     [--tab-delimited]
     [--script-friendly]
     [--property {propertyName}] ...

To update the configuration for an existing Log Publisher:

dsconfig set-log-publisher-prop
     --publisher-name {name}
     (--set|--add|--remove) {propertyName}:{propertyValue}
     [(--set|--add|--remove) {propertyName}:{propertyValue}] ...

To create a new Common Log File HTTP Operation Log Publisher:

dsconfig create-log-publisher
     --publisher-name {name}
     --type common-log-file
     --set enabled:{propertyValue}
     --set log-file:{propertyValue}
     [--set {propertyName}:{propertyValue}] ...

To delete an existing Log Publisher:

dsconfig delete-log-publisher
     --publisher-name {name}