Cisco Cisco Unified Customer Voice Portal 11.0(1) User Guide
C
HAPTER
5:
VXML Server
L
OGGING
U
SER
G
UIDE FOR
C
ISCO
U
NIFIED
CVP
VXML
S
ERVER
AND
C
ISCO
U
NIFIED
C
ALL
S
TUDIO
109
Activity Logger Configuration: File Purging
The Activity Logger can be configured to automatically delete files that conform to certain
criteria. Properly configured, this will allow an administrator to avoid having the system’s hard
drive fill up with logs, thereby preventing new calls from being logged. A few notes about file
purging that must be understood:
criteria. Properly configured, this will allow an administrator to avoid having the system’s hard
drive fill up with logs, thereby preventing new calls from being logged. A few notes about file
purging that must be understood:
•
A logger has control only over the files appearing under the logger instance’s dedicated log
folder and cannot control those files managed by other logger instances. This even applies to
multiple instances of the same logger since each logger instance is given its own unique
folder within the
folder and cannot control those files managed by other logger instances. This even applies to
multiple instances of the same logger since each logger instance is given its own unique
folder within the
logs
folder of the application. Activity Logger file purging therefore
applies only to those files appearing under the logger instance’s folder.
•
Since loggers are activated only when events occur in a call, the file purging activity will
only take place when a call ends. As a result, a system that receives no calls at all will not
automatically delete files until a new call is received and completes.
only take place when a call ends. As a result, a system that receives no calls at all will not
automatically delete files until a new call is received and completes.
•
When the Activity Logger starts up for the first time, it will apply the purging strategy on any
files that exist in the logger directory. Therefore, if an application server is shut down with
files in the logger directory and then restarted a long time later, these files could be deleted
when the application server starts up and the logger initializes. This applies to any file
appearing in the logger directory, not just activity logs.
files that exist in the logger directory. Therefore, if an application server is shut down with
files in the logger directory and then restarted a long time later, these files could be deleted
when the application server starts up and the logger initializes. This applies to any file
appearing in the logger directory, not just activity logs.
•
The Activity Logger keeps information about the activity log files in memory and acts on
that to determine whether to delete them rather than by monitoring the remaining hard drive
space on the system. This is done to avoid having to do file IO to determine if a file is to be
purged and so minimizes overhead (though there still is overhead in simply deleting files).
One consequence of this is that the logger keeps track only of those files it is managing. The
logger is unaware of any files added to the directory after the application server initializes. So
the purging strategy will affect those files only.
that to determine whether to delete them rather than by monitoring the remaining hard drive
space on the system. This is done to avoid having to do file IO to determine if a file is to be
purged and so minimizes overhead (though there still is overhead in simply deleting files).
One consequence of this is that the logger keeps track only of those files it is managing. The
logger is unaware of any files added to the directory after the application server initializes. So
the purging strategy will affect those files only.
The optional
<purge>
tag defines the purging strategy. If this tag does not appear in the
configuration, no file purging will take place. The tag can contain one of the following child
tags:
tags:
•
file_age
. The Activity Logger will delete activity log files older than X days, where X is an
integer greater than 0 specified in the
older_than
attribute.
•
file_count
. The Activity Logger will delete activity log files if the logger folder contains
greater than X files, where X is an integer greater than 0 specified in the
greater_than
attribute. When the files are deleted, the oldest ones are deleted first until the folder reaches
the desired file count.
the desired file count.