Start log collection
couchbase-cli collect-logs-start [--cluster <url>] [--username <user>] [--password <password>] [--all-nodes] [--nodes <node_list>] [--redaction-level] [--output-directory] [--temporary-directory] [--upload] [--upload-host <host>] [--upload-proxy <host>] [--customer <customer>] [--ticket <ticket>]
This command collects all Couchbase Server log files from one or more nodes in the cluster. Log collection is useful when there are failures in the cluster and you need to figure out what is going on. Since there are many log files on various different server the collect-logs-start command helps in aggregating all of the different log file Couchbase Server creates.
To get the location of the collected log files you can run the collect-logs-status1 command either while the log collection task is running or after the log collection task has completed. If the --upload flag is specified then the logs will also be uploaded to the host specified in the --upload-host flag. The upload flag is intended for Couchbase Server Enterprise Edition users who need to upload logs to the Couchbase Support Team to aid in diagnosing support tickets that they have filed.
Note that only one log collection task may be running at any given time in the cluster.
Specifies the hostname of a node in the cluster. See the HOST FORMATS section for more information on specifying a hostname.
- --user <username>
Specifies the username of the user executing the command. If you do not have a user account with permission to execute the command then it will fail with an unauthorized error.
- --password <password>
Specifies the password of the user executing the command. If you do not have a user account with permission to execute the command then it will fail with an unauthorized error. If this argument is specified, but no password is given then the command will prompt the user for a password through non-echoed stdin. You may also specify your password by using the environment variable CB_REST_PASSWORD.
Specifies that log collection should take place on all nodes in the cluster. May not be specified at the same time as --nodes.
- --nodes <node_list>
A list of one or more nodes to collect logs from, the nodes must include the administrator port. The list should be comma separated. This parameter may not be specified at the same time as the --nodes option.
Specifies that the logs should be uploaded to the host specified with the --upload-host option. This option should be used by Couchbase Server Enterprise customers when uploading logs for the Couchbase Support Team.
- --upload-proxy <host>
Specifies the proxy to use when uploading logs. This is useful when a cluster is deployed in secure environments and do not have a direct outbound connection to the internet to upload logs.
- --upload-host <host>
Once log collection is completed, the logs zip file should be uploaded to this URL. This parameter is required if the --upload flag is specified.
- --customer <name>
The name of the customer who is uploading these logs. This option is required if the --upload flag is specified.
- --ticket <num>
The ticket number that the support team has created to track the issue filed. This parameter is optional when specifying the --upload flag, but recommended if you have a ticket number.
When specifying a host for the couchbase-cli command the following formats are expected:
It is recommended to use the couchbase://<addr> format for standard installations. The other two formats allow an option to take a port number which is needed for non-default installations where the admin port has been set up on a port other that 8091.
To collect logs on all nodes without uploading them run the following command.
$ couchbase-cli collect-logs-start -c 192.168.1.5 --username Administrator \ --password password --all-nodes
If there is a three node cluster with IP addresses 192.168.1.5, 192.168.1.6, and 192.168.1.7 and you only want to collect logs on the first two nodes and don’t want to upload the logs then run the command below.
$ couchbase-cli collect-logs-start -c 192.168.1.5 --username Administrator \ --password password --nodes 192.168.1.5:8091,192.168.1.6:8091
If you are a Couchbase Server Enterprise Edition user and you need to upload logs for all nodes for a support ticket then you can run the following command.
$ couchbase-cli collect-logs-start -c 192.168.1.5 --username Administrator \ --password password --all-nodes --upload --upload-customer customer_name \ --upload-host s3.amazonaws.com/cb-customers --ticket 12345
ENVIRONMENT AND CONFIGURATION VARIABLES
CB_REST_PASSWORD Specifies the password of the user executing the command. This environment variable allows you to specify a default argument for the -p/--password argument on the command line. It also allows the user to ensure that their password are not cached in their command line history.
CB_REST_PASSWORD Specifies the password of the user executing the command. This environment variable allows you to specify a default argument for the -p/--password argument on the command line.