How to Check What Web Sites/URLs the Cache Engine Is Caching

Introduction

This document explains how to set up transaction logging to keep track of what web sites/URLs are being cached on the Cache Engine.

Hardware and Software Versions

This configuration was developed and tested using these hardware and software versions:

Hardware: Cisco Cache Engine 500 series and 73xx
Software: Cisco Cache Software, Release 2.3.0 and updated for ACNS version 4.x and 5.x

Transaction Logging

To keep a track of what web sites are being visited, you need to enable transaction logging on the Cache Engine.

To begin, verify that transaction logging is enabled. Issue the show transaction-logging command.

ACNS 4.x

ce-5#show transaction-logging
        Transaction Logs:
        Logging is disabled.
        End user identity is visible.
        File markers are disabled
        Archive interval: every-day at 00:00
        Maximum Number of Archived Files:  3
        Exporting files to servers is disabled.
        Export interval: every-day every 1 hour
        Working Log file - size: 0
        age: Unavailable
        No Archive Log file found
ce-5#

You can see that logging is disabled.

ACNS 5.x

ce-5#show transaction-logging 
Transaction log configuration:
---------------------------------------
Logging is enabled.
End user identity is visible.
File markers are disabled.
Archive interval: every-day every 1 hour
Maximum size of archive file: 2000000 KB
Log File format is squid.
Windows domain is not logged with the authenticated username

Exporting files to ftp servers is disabled.
File compression is disabled.
Export interval: every-day every 1 hour

HTTP Caching Proxy Transaction Log File Info
  Working Log file - size : 206
                     age: 23

WMT MMS Caching Proxy/Server Transaction Log File Info
  Working Log file - size : 575
                     age: 139
  Archive Log file - mms_export_192.168.10.208_20040108_115421  size: 575

A&D Transaction Log File Info
  Working Log file - size : 119
                     age: 139
  Archive Log file - acqdist_192.168.10.208_20040108_115421     size: 119

TV-out Transaction Log File Info
  Working Log file - size : 48
                     age: 139
  Archive Log file - tvout_192.168.10.208_20040108_115421       size: 48

The current log file is named working.log, and is stored in the /local/var/log/translog directory (version 2) or /local1/logs (version 4 and 5). Check your current directory.

ce-5#pwd
/local
ce-5#
change directory to
ce-5# cd /local/var/log/translog  (version 2)
ce-5# cd /local1/logs             (version 4)
check directory contents
ce-5#pwd
/local/var/log/translog

ce-5#dir
  size      date         time       name                LongName        
----------  -------      ------     -----------         ----------------
       512  May-01-2001  00:00:00   .            <DIR>  .
       512  Jan-01-1988  00:09:14   ..           <DIR>  ..
       512  Aug-02-2000  19:28:32   ARCHIVE      <DIR>  archive
         0  May-01-2001  00:00:00   WORKING.LOG         working.log
    3 DIR(S),     1 FILE(S) 0 bytes
    2130116608 bytes AVAILABLE ON VOLUME /c0t0d0s1
ce-5#

Version 4 and 5 include a boomerang directory where content routing race results are logged (configured with the boomerang log-races enable command) and an export directory where log file FTP export results are logged (configured with the transaction-logs export command).

To read the contents of the file, issue the type working.log command.
```
ce-5#type working.log
ce-5#
```
As of now, the file is empty. Notice that the file size in the dir command is zero.

Enable transaction logging.

ce-5#conf t
Enter configuration commands, one per line. End with CNTL/Z
ce-5(config)#transaction-logs enable
            Starting transaction log processes
            Started Transaction Log File Manager Archive Script
            Started Transaction Log Daemon
ce-5(config)#

Check again to see if transaction logging is enabled.

ce-5#show transaction-logging
        Transaction Logs:
        Logging is enabled.
        End user identity is visible.
        File markers are disabled
        Archive interval: every-day at 00:00
        Maximum Number of Archived Files:  3
        Exporting files to servers is disabled.
        Export interval: every-day every 1 hour
        Working Log file - size: 0
        age: 48
        No Archive Log file found
ce-5#

The transaction logs are now enabled.

Verifying the Configuration

These are Web sites that were visited (www.cisco.com for example) to check the contents of the file working.log :

ce-5#type working.log 
987816643.766 116 10.1.1.5 TCP_MISS/0 1468 GET http://www.cisco.com/images* 
987816643.783 133 10.1.1.5 TCP_MISS/0 269 GET http://www.cisco.com/images/* 
987816643.799 299 10.1.1.5 TCP_MISS/0 18036 GET http://www.cisco.com/ - DI* 
987816643.816 166 10.1.1.5 TCP_MISS/0 4508 GET http://www.cisco.com/images* 
987816643.866 83 10.1.1.5 TCP_MISS/0 308 GET http://www.cisco.com/images/h*  
987816643.916 116 10.1.1.5 TCP_MISS/0 269 GET http://www.cisco.com/images/*  
987816643.933 99 10.1.1.5 TCP_MISS/0 1039 GET http://www.cisco.com/images/*  
987816644.16 149 10.1.1.5 TCP_MISS/0 1060 GET http://www.cisco.com/images/*  
987816644.49 133 10.1.1.5 TCP_MISS/0 868 GET http://www.cisco.com/images/h*
987816644.66 133 10.1.1.5 TCP_MISS/0 1130 GET http://www.cisco.com/images/*  
987816644.99 299 10.1.1.5 TCP_MISS/0 13945 GET http://www.cisco.com/images*
987816644.116 83 10.1.1.5 TCP_MISS/0 1886 GET http://www.cisco.com/images/* 
987816644.149 83 10.1.1.5 TCP_MISS/0 729 GET http://www.cisco.com/images/h*

Tip: Most times, the working.log file will become very large. It is not possible to view the file on screen. To do this, FTP into the Cache Engine and copy the file into a local machine to view it.

To obtain an understanding of TCP_MISS, refer to Understanding Cache Engine Transaction Log Analysis.

To disable transaction logging, issue these commands:

 
ce-5#conf t 
Enter configuration commands, one per line. End with CNTL/Z 
ce-5(config)#no transaction-logs enable 
Stopping transaction log processes: 
Stopped transaction log daemon 
ce-5(config)#

To check the status of transaction logging, issue this command:

ce-5#sh transaction-logging 
Transaction Logs: 
  Logging is disabled. 
  End user identity is visible. 
  File markers are disabled 
  Archive interval: every-day at 00:00 

  Maximum Number of Archived Files:  3 
  Exporting files to servers is disabled. 
  Export interval: every-day every 1 hour 

 Working Log file - size: 3887 
                      age: Unavailable 
    No Archive Log file found 
ce-5#

Cisco 500 Series Cache Engines