User manual HP MEDIA CACHE SA2150 CACHE SERVER APPLIANCE ADMINISTRATOR GUIDE

[. . . ] HP Cache Server Appliance Administrator Guide HP Part Number 5971-3045 Printed in June 2001 Notice The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. Hewlett-Packard assumes no responsibility for the use or reliability of its software on equipment that is not furnished by Hewlett-Packard. [. . . ] To create traditional custom log formats: 1. Access Traffic Manager from your browser (refer to Accessing Traffic Manager, on page 8). On the Configure tab, click the Logging button. Scroll to the Custom Logs section of the Logging page (shown below). 4. Click the Make These Changes button, then exit Traffic Manager. Telnet into the HP web cache appliance and select Shell Access as described in Overview of Access Methods, on page 7. To add a traditional custom log specification, enter a line in the logs. config file with the following format: format:enable_flag:format_id:format_name:string:file_name:type:header NOTE Each line in the logs. config file produces one file (if the format is active). Specify values for the fields: Field format enable_flag Description All lines must begin with the word format. This field enables or disables transaction logging using this format. You can enter one of the following: · enabled · disabled If you enter disabled, you have defined a custom log file format but are not using it. format_id format_name string Use a unique integer to identify each of your custom log formats. Enter a printf-style format string specifying the field symbols to be displayed and how they should look in ASCII. For a list of the available field symbols and their meanings, refer to Appendix E, Event Logging Formats. 104 Chapter 12 Working with Log Files Field file_name type Description Enter a name you want to use for the log file created with this format. Enter one of the following: · ASCII · BINARY header If you want your custom log file to have header text, enter it here. Example The following example custom log definition produces a log file that records the client host IP address, the client request universal resource identifier, and the proxy response status code: format:enabled:1:minimal:%<chi> / %<cqu> / %<pssc>:minimalist:ASCII:myheader For more information about configuring the logs. config file, see logs. config, on page 169. Run the command traffic_line -x to apply the configuration changes. Using XML-based custom formats Traffic Server supports a broad range of logging formats, including both standard and traditional custom formats. However, associating these formats to specific servers, collation hosts, and log files is rather coarsegrained. For example, when you enable collation, it is generally enabled for all formats and only to a single collation server. Traffic Server's XML-based custom log specification is more flexible, enabling you to institute much more control over the type of information recorded in your log files. The heart of the XML-based custom logging feature is an XML-based logging configuration file (logs_xml. config) that enables you to create very modular descriptions of logging objects. The logs_xml. config file uses three types of objects to create custom log files: · · · The LogFormat object defines the content of the log file using printf-style format strings. The LogFilter object defines a filter so that you include or exclude certain information from the log file. The LogObject object specifies all the information needed to produce a log file. For example: o The name of the log file (required). [. . . ] A protocol that enables encrypted, authenticated communications across the Internet. Used mostly in communications between origin servers and web browsers. An Internet Standard transport layer protocol. TCP provides reliable end-to-end communication by using sequenced data sent by IP. traffic_cop. [. . . ]