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 represents the log level (broken, unusual, info, debug, or io). The default is info.

EXAMPLE JSON REQUEST

{
  "id": 82,
  "method": "getlog",
  "params": {
    "level": "debug"
  }
}

RETURN VALUE

On success, an object is returned, containing:

  • created_at (string): UNIX timestamp with 9 decimal places, when logging was initialized

  • bytes_used (u32): The number of bytes used by logging records

  • bytes_max (u32): The bytes_used values at which records will be trimmed

  • log (array of objects):

    • type (string) (one of “SKIPPED”, “BROKEN”, “UNUSUAL”, “INFO”, “DEBUG”, “IO_IN”, “IO_OUT”)

    If type is “SKIPPED”:

    • num_skipped (u32): number of unprinted log entries (deleted or below level parameter)

    If type is “BROKEN”, “UNUSUAL”, “INFO” or “DEBUG”:

    • time (string): UNIX timestamp with 9 decimal places after created_at
    • source (string): The particular logbook this was found in
    • log (string): The actual log message
    • node_id (pubkey, optional): The peer this is associated with

    If type is “IO_IN” or “IO_OUT”:

    • time (string): Seconds after created_at, with 9 decimal places
    • source (string): The particular logbook this was found in
    • log (string): The associated log message
    • data (hex): The IO which occurred
    • node_id (pubkey, optional): The peer this is associated with

On failure, one of the following error codes may be returned:

  • -32602: Error in given parameters.

EXAMPLE JSON RESPONSE

{
   "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 comment: # ( SHA256STAMP:155507c9105521bb4c113232d9bc6fd585cce269303ee8e7e27ea803ca8405cf)