The maintenance utility performs routine maintenance and logging tasks for Experience Analytics passive capture. You can use the utility to help maintain the ability of the PCA to perform passive capture.
Capture health check
The maintenance utility monitors the capture processes to determine whether they are in good health.
If the utility decides the capture processes are unhealthy, it performs a forced restart. The forced restart stops the capture processes, clears the runtime statistics that they collect, and then restarts them. The health check helps the capture processes recover from situations that degrade the effectiveness and performance of the capture processes. When the maintenance utility determines that capture is unhealthy and needs a restart, it writes a message to the maintenance log file to indicate this situation.
According to a predefined schedule, the maintenance utility stops the capture processes, clears the runtime statistics that are collected, then restarts the processes.
The restart occurs at a specific time every day or every week at a specific time on a specific day. The forced restart prevents the capture processes from entering unhealthy situations that would cause the health check to fail.
Log file location
For the Experience AnalyticsCX Passive Capture Application, log files are located in the following directories:
When the PCA is upgraded, the location of log file directories is never updated. If you upgrade your PCA from an initial installation before build 3206, then log files are stored in the following location:
The log file directory is stored in the following file:
Locate the following entry:
Log file cleanup
The log files that are monitored by the utility are in the directory
/var/log/tealeaf and include the date in the filename, such as
The utility monitors that age and size of specific log files. It also deletes them if they are older than a specified number of days or larger than a specified size.
Statistics log files are generated in the PCA log directory.
The maintenance utility generates a file that contains various runtime statistics over time. This file is intended for debugging and diagnosis of various capture and hit delivery problems.
Statistics log files are generated in the PCA log directory, which is the following location by default:
Log files have the following file name format:
- Newer logs are in plaintext format.
- Older logs are compressed into compress files.
Converting statistics log files to output format
If needed, you can use a script that is provided by Experience Analytics to convert a PCA
statslog file into
.xml format for more analysis. The
script is in the following location:
/usr/local/ctccap. If the PCA software is installed in another location, the shebang at line 1 of the script must be changed to point to the correct location of the php binary:
<pca install location>/bin/php.
./stat2csv -t type -f infile -w outfile
infile- the statistics log file in plain text or compress format.
outfile- the name of the
.xmlfile to output.
type- the type of file to output:
./stat2csv -t csv -f statistics_20090406.log -w statistics_20090406.csv ./stat2csv -t xml -f statistics_20090406.log.gz -w statistics_20090406.xml
The utility synchronizes the current date and time with the current date and time of a Experience AnalyticsCX server that is running the Transport Service. The maintenance log file contains the output of the time synchronization task if it is enabled.