What are the Catchpoint Logs?
All Catchpoint services create and store information in log files, including Test runs, Errors, Alerts, and other events. These files can be a helpful resource for troubleshooting issues across the Enterprise nodes.
Most Catchpoint log files are archived in the 3genlabs directory and subdirectory.
This tutorial will walk you through locating and collecting logs.
Prerequisites
- Access to Enterprise Node
- A user account with root user privileges
Viewing Individual Log Files
First, open the Linux terminal as a root user. This will enable root privileges.
Use the following command to see the logs in real-time:
$ catchpoint log -c
This will display all the Catchpoint log files, including tests scheduled, errors observed, etc.
By default, Catchpoint logs are located under:
/var/3genlabs/hawk/syntheticnode/service/log/hawksyntheticnodeservice*.log
To list all the log files:
$ ls -la /var/3genlabs/hawk/syntheticnode/service/log
To read the logs:
less /var/3genlabs/hawk/syntheticnode/service/log/<logname>.log
NOTE: You can use tail, cat, or vim for reading the logs
Collecting Logs for Catchpoint Support:
The following command will generate a .txz file containing all logs for the most recent 24 hours.
$ sudo catchpoint log --snapshot
If you want to collect logs for more than 24 hours, include the argument -d <number>, replacing <number> with the number of days to collect logs for. For example, the following command will generate an archive of logs for the past two days (most recent 48 hours).
$ sudo catchpoint log --snapshot -d 2
The archived files of the log are stored in the following location in .txz format.
/var/tmp/catchpoint/