Search <book_title>...

Veritas CloudPoint Administrator's Guide

Last Published: 2019-10-01

Product(s): CloudPoint (2.2)

Platform: Linux

Viewing CloudPoint logs

CloudPoint provides a MongoDB client helper utility (flexsnap-log) that is located within the flexsnap-coordinator service. This utility allows you to access the MongoDB logs collection.

The general command syntax for using the flexsnap-log utility is as follows:

# sudo docker exec flexsnap-coordinator flexsnap-log <options>

Table: Flexsnap-log command options

Command option	Description
<service>	The CloudPoint service name. The command displays the logs of the specified service.
- h \| --help	Displays the command syntax and a description of the available options.
-n <N> \| --limit <N>	Displays the last "N" number of log messages. For example, to view the last 50 log messages, specify the following: `-n 50`
-t \| --tail	Use this option to follow and monitor the log messages in real time.
-F <format> \| --format <format>	Displays the log messages in the specified output format. For example, `-F {container_name}: {log}`.
-v \| --verbose	Displays the command output in a verbose mode.
-j \| --json	Displays the logs in a JavaScript Object Notation (JSON) format.
-d <days> \| --days <days>	Displays the logs for the last "DAYS" number of days. For example, to view the logs for the last seven days, specify the following: `-d 7`
-f <filename> \| --file <filename>	Dumps the logs to the file specified in `<filename>`.

You can view the CloudPoint logs using any of the following commands on the CloudPoint host:

To obtain all the CloudPoint service logs, run the following command:
# sudo docker exec flexsnap-coordinator flexsnap-log
To obtain logs of a specific CloudPoint container service, run the following command:
# sudo docker exec flexsnap-coordinator flexsnap-log <flexsnap-service name>
To tail or follow log messages, run the following command:
# sudo docker exec flexsnap-coordinator flexsnap-log -t
To obtain the last "N" number of log messages, run the following command:
# sudo docker exec flexsnap-coordinator flexsnap-log -n <N>

You can also combine these options to achieve a specific output. For example, to obtain the last 10 log messages for the flexsnap-agent service, run the following command:

# sudo docker exec flexsnap-coordinator flexsnap-log -n 10 flexsnap-agent

The command output displays messages similar to the following:

flexsnap-agent: flexsnap-agent-offhost[1] flexsnap.updates: INFO - find_files:netapp.zip
flexsnap-agent: flexsnap-agent-offhost[1] flexsnap.updates: INFO - find_files:nutanix.zip
flexsnap-agent: flexsnap-agent-offhost[1] flexsnap.updates: INFO - find_files:oracle.zip
flexsnap-agent: flexsnap-agent-offhost[1] flexsnap.updates: INFO - find_files:purestg.zip
flexsnap-agent: flexsnap-agent-offhost[1] flexsnap.updates: INFO - find_files:windows.zip
flexsnap-agent: flexsnap-agent-offhost[1] INFO - Beginning registration with coordinator
flexsnap-agent: flexsnap-agent-offhost[1] INFO - loaded plugin, sending configId status: {}
flexsnap-agent: flexsnap-agent-offhost[1] INFO - Sending list of sources
flexsnap-agent: flexsnap-agent-offhost[1] INFO  Registration complete

The most recent CloudPoint logs are also available in the flexsnap-fluentd container logs. You can use standard Docker commands to obtain the logs.

Run the following command:

# sudo docker logs flexsnap-fluentd | grep flexsnap-agent | head -10

The command output displays messages similar to the following:

flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread agent: 
INFO - Not generating certificate. Join token not passed for role agent"}

flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread 
flexsnap.ca: INFO - Loading /opt/VRTScloudpoint/keys/agent.6c5c9.cert.pem 
/opt/VRTScloudpoint/keys/cacert.pem"}

flexsnap-agent: {"container_name":"flexsnap-agent","source":"stdout","log":
"Mar 04 09:10:20 f5d1ae1c4808 flexsnap-agent-offhost[1] MainThread 
flexsnap.connectors.rabbitmq: INFO - Starting service"}

To view the flexsnap-fluentd container logs in real time, run the following command:

# sudo docker logs flexsnap-fluentd -f | grep <flexsnap-service-name>