collect-logs-start

collect-logs-start

Start log collection

SYNTAX

couchbase-cli collect-logs-start [--cluster <url>] [--username <user>] [--password <password>] [--all-nodes] [--nodes <node_list>] [--upload] [--upload-host <host>] [--customer <customer>] [--ticket <ticket>]

DESCRIPTION

This command collects all Couchbase 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-status 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 mainly for Couchbase 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.

OPTIONS

-c
--cluster

Specfies the hostname of a node in the cluster. See the HOST FORMATS section for more information on specifying a hostname.

-u
--user <username>

Specifies the username of the user executing the command. If you do not have a user account with permision to execute the command then it will fail with an unauthorized error.

-p
--password <password>

Specifies the password of the user executing the command. If you do not have a user account with permision 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.

--all-nodes

Specifies that log collection shoue 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 list should be comma separated. This parameter may not be specified at the same time as the --nodes option.

--upload

Specifies that the logs should be uploaded to the the host specified with the --upload-host option. This option should be used by Couchbase Enterprise customers when uploading logs for the Couchbase Support Team.

--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 when 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 the customer has a ticket number.

HOST FORMATS

When specifying a host for the couchbase-cli command the following formats are expected:

  • couchbase://<addr>

  • <addr>:<port>

  • http://<addr>:<port>

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.

EXAMPLES

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 we have a three node cluster with IP addresses 192.168.1.5, 192.168.1.6, and 192.168.1.7 and we only want to collect logs on the first two nodes and we don’t want to upload the logs then we would 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

I you are a Couchbase Enterprise Edition user and you need to upload logs for all nodes for 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.