mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
97 lines
2.1 KiB
Groff
Generated
97 lines
2.1 KiB
Groff
Generated
.TH "LIGHTNING-GETLOG" "7" "" "" "lightning-getlog"
|
|
.SH NAME
|
|
lightning-getlog - Command to show logs\.
|
|
.SH SYNOPSIS
|
|
|
|
\fBgetlog\fR [level]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
The \fBgetlog\fR the RPC command to show logs, with optional log \fIlevel\fR\.
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fIlevel\fR: A string that rappresent the log level (info, unusual, debug, io)\.
|
|
|
|
.RE
|
|
.SH EXAMPLE JSON REQUEST
|
|
.nf
|
|
.RS
|
|
{
|
|
"id": 82,
|
|
"method": "getlog",
|
|
"params": {
|
|
"level": "debug"
|
|
}
|
|
}
|
|
.RE
|
|
|
|
.fi
|
|
.SH RETURN VALUE
|
|
|
|
On success, a object will be return with the following parameters:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
\fIcreated_at\fR: An floating point value that rappresent the {}\.
|
|
.IP \[bu]
|
|
\fIbytes_used\fR: A string that rappresent the dimension in bytes of the log file\.
|
|
.IP \[bu]
|
|
\fIbytes_max\fR: An integer that rappresent the max dimension in bytes of log file\.
|
|
.IP \[bu]
|
|
\fIlog\fR: An array of object where each elements contains the following proprieties:.RS
|
|
.IP \[bu]
|
|
\fItype\fR: A string that rappresent the log level\. The propriety can have an value equal to SKIPPED\.
|
|
.IP \[bu]
|
|
\fItime\fR: A floating point value that rappresent the time\.
|
|
.IP \[bu]
|
|
\fIsource\fR: A string that rappresent the source of line\.
|
|
.IP \[bu]
|
|
\fIlog\fR: A string that rappresent the content of line\.
|
|
|
|
.RE
|
|
|
|
.IP \[bu]
|
|
\fInum_skipped\fR: An integer that it is present only if the log level is equal to SKIPPED\.
|
|
|
|
.RE
|
|
|
|
On failure, one of the following error codes may be returned:
|
|
|
|
.RS
|
|
.IP \[bu]
|
|
-32602: Error in given parameters\.
|
|
|
|
.RE
|
|
.SH EXAMPLE JSON RESPONSE
|
|
.nf
|
|
.RS
|
|
{
|
|
"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."
|
|
}
|
|
]
|
|
}
|
|
.RE
|
|
|
|
.fi
|
|
.SH AUTHOR
|
|
|
|
Vincenzo Palazzo \fI<vincenzo.palazzo@protonmail.com\fR> wrote the initial version of this man page, but many others did the hard work of actually implementing this rpc command\.
|
|
|
|
.SH RESOURCES
|
|
|
|
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR
|
|
|