nodetool setlogginglevel
Sets the logging level threshold for a given component or class.
To see the current logging level, use nodetool getlogginglevels.
Use this command to set logging levels for services instead of modifying logback-text.xml.
|
Extended logging for compaction is supported and requires table configuration. The extended compaction logs are stored in a separate file. |
Synopsis
nodetool [<connection_options>] setlogginglevel
[--] <component> | <class> <level>
Syntax legend
| Syntax conventions | Description |
|---|---|
Italic, bold, or |
Syntax diagrams and code samples use one or more of these styles to mark placeholders for variable values. Replace placeholders with a valid option or your own user-defined value. In CQL statements, angle brackets are required to enclose data types in a set, list, map, or tuple.
Separate the data types with a comma.
For example: In Search CQL statements, angle brackets are used to identify the entity and literal value to overwrite the XML element in the schema and |
|
Square brackets surround optional command arguments. Do not type the square brackets. |
|
Parentheses identify a group to choose from. Do not type the parentheses. |
|
A pipe separates alternative elements. Type any one of the elements. Do not type the pipe. |
|
Indicates that you can repeat the syntax element as often as required. |
|
Single quotation marks must surround literal strings in CQL statements.
Use single quotation marks to preserve upper case.
+
For Search CQL only: Single quotation marks surround an entire XML schema declaration, such as |
|
Map collection.
Curly braces enclose maps ( |
|
Ends a CQL statement. |
|
Separate command line options from command arguments with two hyphens. This syntax is useful when arguments might be mistaken for command line options. |
Options
If an option has a short and long form, both forms are given, separated by a comma.
- -h, --host hostname
-
The hostname or IP address of a remote node or nodes. When omitted, the default is the local machine.
- -p, --port jmx_port
-
The JMX port number.
- -pw, --password jmxpassword
-
The JMX password for authenticating with secure JMX. If a password is not provided, you are prompted to enter one.
- -pwf, --password-file jmx_password_filepath
-
The filepath to the file that stores JMX authentication credentials.
- -u, --username jmx_username
-
The username for authenticating with secure JMX.
- class
-
The following values are valid for the log
classqualifier:-
org.apache.cassandra -
org.apache.cassandra.db -
org.apache.cassandra.service.StorageProxy
-
component: The following values are valid for the log components qualifier:
+ * bootstrap * compaction * cql * repair * ring * streaming
- level
-
If class qualifier and level arguments to the command are empty or null, logging levels are reset to the initial configuration.
The valid values for setting the log
levelinclude the following:-
ALL: Log all levels -
TRACE: Very detailed log messages. Output is recorded to thedebug.logonly. -
DEBUG: Less detailed thanTRACE, but more detailed thanINFO. Output is recorded to thedebug.logonly. -
INFO(default): At this level,debug.logis disabled. Includes general operational entries, warnings, and errors. -
WARN: Minimal detail. Only reports warnings and errors. -
ERROR: Least detailed logs. Only reports errors. -
OFF: No logging.
-
|
More verbose log levels ( |
Examples
Set the logging level for the StorageProxy service to TRACE:
nodetool setlogginglevel org.apache.cassandra.service.StorageProxy TRACE
Log all messages for the CQL service:
nodetool setlogginglevel cql ALL