log_level
The log_level
command changes the rippled
server's logging verbosity, or returns the current logging level for each category (called a partition) of log messages.
The log_level
method is an admin method that cannot be run by unprivileged users.
Request Format
An example of the request format:
{ "id": "ll1", "command": "log_level", "severity": "debug", "partition": "PathRequest" }
The request includes the following parameters:
Field | Type | Description |
---|---|---|
severity | String | (Optional) What level of verbosity to set logging at. Valid values are, in order from least to most verbose: fatal , error , warn , info , debug , and trace . If omitted, return current log verbosity for all categories. |
partition | String | (Optional) Ignored unless severity is provided. Which logging category to modify. If omitted, or if provided with the value base , set logging level for all categories. |
Response Format
Examples of successful responses:
Loading: "/etc/rippled.cfg" Connecting to 127.0.0.1:5005 { "result" : { "status" : "success" } }
The response follows the standard format. The response format depends on whether the request specified a severity
. If it did, the log level is changed and a successful result contains no additional fields.
Otherwise, the response contains the following field:
Field | Type | Description |
---|---|---|
level | Object | The current log levels of each category. This list of categories is subject to change without notice in future releases. You can use the field names as values to partition in requests to this command. |
Possible Errors
- Any of the universal error types.
invalidParams
- One or more fields are specified incorrectly, or one or more required fields are missing.