2020-08-26 13:43:56 +01:00
lightning-getlog -- Command to show logs.
=========================================
SYNOPSIS
--------
**getlog** \[level\]
DESCRIPTION
-----------
The **getlog** the RPC command to show logs, with optional log *level* .
- *level*: A string that rappresent the log level (info, unusual, debug, io).
EXAMPLE JSON REQUEST
--------------------
```json
{
"id": 82,
"method": "getlog",
"params": {
"level": "debug"
}
}
```
RETURN VALUE
------------
On success, a object will be return with the following parameters:
- *created_at*: An floating point value that rappresent the {}.
- *bytes_used*: A string that rappresent the dimension in bytes of the log file.
- *bytes_max*: An integer that rappresent the max dimension in bytes of log file.
- *log*: An array of object where each elements contains the following proprieties:
- *type*: A string that rappresent the log level. The propriety can have an value equal to SKIPPED.
- *time*: A floating point value that rappresent the time.
- *source*: A string that rappresent the source of line.
- *log*: A string that rappresent the content of line.
- *num_skipped*: An integer that it is present only if the log level is equal to SKIPPED.
On failure, one of the following error codes may be returned:
2020-08-31 13:42:28 +01:00
- -32602: Error in given parameters.
2020-08-26 13:43:56 +01:00
EXAMPLE JSON RESPONSE
---------------------
```json
{
"created_at": "1598192543.820753463",
"bytes_used": 89285843,
"bytes_max": 104857600,
"log": [
{
"type": "SKIPPED",
"num_skipped": 45
},
{
"type": "INFO",
"time": "0.453627568",
"source": "plugin-autopilot.py",
"log": "RPC method 'autopilot-run-once' does not have a docstring."
}
]
}
```
AUTHOR
------
Vincenzo Palazzo < < vincenzo.palazzo @ protonmail . com > > wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command.
RESOURCES
---------
Main web site: < https: / / github . com / ElementsProject / lightning >
