Changeset View
Changeset View
Standalone View
Standalone View
doc/0.21.12/rpc/control/logging.md
- This file was added.
--- | |||||
name: logging | |||||
version: 0.21.12 | |||||
group: control | |||||
permalink: doc/0.21.12/rpc/control/logging/ | |||||
--- | |||||
logging ( ["include_category",...] ["exclude_category",...] ) | |||||
Gets and sets the logging configuration. | |||||
When called without an argument, returns the list of categories with status that are currently being debug logged or not. | |||||
When called with arguments, adds or removes categories from debug logging and return the lists above. | |||||
The arguments are evaluated in order "include", "exclude". | |||||
If an item is both included and excluded, it will thus end up being excluded. | |||||
The valid logging categories are: net, tor, mempool, http, bench, zmq, db, rpc, estimatefee, addrman, selectcoins, reindex, cmpctblock, rand, prune, proxy, mempoolrej, libevent, coindb, qt, leveldb, validation | |||||
In addition, the following are available as category names with special meanings: | |||||
- "all", "1" : represent all logging categories. | |||||
- "none", "0" : even if other logging categories are specified, ignore all of them. | |||||
Arguments: | |||||
1. include (json array, optional) A json array of categories to add debug logging | |||||
[ | |||||
"include_category", (string) the valid logging category | |||||
... | |||||
] | |||||
2. exclude (json array, optional) A json array of categories to remove debug logging | |||||
[ | |||||
"exclude_category", (string) the valid logging category | |||||
... | |||||
] | |||||
Result: | |||||
{ (json object where keys are the logging categories, and values indicates its status | |||||
"category": 0|1, (numeric) if being debug logged or not. 0:inactive, 1:active | |||||
... | |||||
} | |||||
Examples: | |||||
> bitcoin-cli logging "[\"all\"]" "[\"http\"]" | |||||
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id":"curltest", "method": "logging", "params": [["all"], "[libevent]"] }' -H 'content-type: text/plain;' http://127.0.0.1:8332/ | |||||