Logs

Usage:	storageos logs COMMAND

View and manage node logs

Options:
      --clear-filter       Clears the filter
      --filter string      Set the logging filter
  -f, --follow             Tail the logs for the given node, or all nodes if not specified
      --format string      Output format (raw or table) or a Go template (default "raw")
      --help               Print usage
  -q, --quiet              Only display volume names
  -t, --timeout int        Timeout in seconds. (default 5)
      --verbosity string   Set the logging verbosity

Commands:
  view        Show logging configuration

Run 'storageos logs COMMAND --help' for more information on a command.

The logs command is intended to assist with troubleshooting a running cluster.

Verbosity controls the level of detail shown in the logs with info the default. The available options are debug, info, warning, error and fatal. During normal operation info level is recommended.

Filters fine-tune the amount of detail shown. They allow you to set verbosity to debug level, then set specific categories at a higher level (e.g. info) so there is less noise while troubleshooting an issue.

For example, the filter dp=info,cp=info,etcd=debug would set all dataplane and controlplane categories to info level, then only enable debug on the etcd category. Filters are evaluated from left to right. The verbosity must also be set to debug to show the etcd category at debug level.

Categories are tags on log messages that relate to the component that generated them. A typical log message looks like:

time="2018-01-11T12:42:58Z" level=info msg="lost leadership election, waiting" action=election category=leader error="already exists" module=ha

storageos logs view

Displays the logging verbosity and filters for the whole cluster.

storageos logs view
NODE         LEVEL  FILTER
storageos-1  debug  cp=info,dp=info,leader=debug
storageos-2  info
storageos-3  debug  cp=info,dp=info,ha=debug

Set verbosity

To set the verbosity level on all nodes in the cluster:

storageos logs --verbosity debug
OK

To set the verbosity level on specific nodes, append a list of node names:

storageos logs --verbosity debug storageos-1 storageos-2
OK

Set filter

To set a filter on a single node:

storageos logs --filter cp=info,dp=info,leader=debug storageos-1
OK

If no node names are given, the filter will be applied to all nodes.

Clear filter

To remove the filter, use the --clear-filter flag.

To clear on all nodes:

storageos logs --clear-filter
OK

You can clear the filter on specific nodes by appending one or more node names:

storageos logs --clear-filter storageos-1
OK

Viewing logs

--follow flag allows you to view the cluster logs as they are generated.

# Tail logs for the given node
storageos logs --follow storageos-1

# Tail log for all nodes
storageos logs --follow