Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LIGHTNING-LISTNETWORKEVENTS(7)			LIGHTNING-LISTNETWORKEVENTS(7)

NAME
       listnetworkevents -- Command for	querying network events

SYNOPSIS
       listnetworkevents [id] [index] [start] [limit]

DESCRIPTION
       Command added in	v25.12.

       The  listnetworkevents  RPC  command  retrieves the log of connections,
       disconnections and pings	on the network.	 This can be analyzed to eval-
       uate node reliability and latency.  Note: the autoclean plugin  deletes
       network	events	older  than  30	 days;	you  can adjust	autoclean-net-
       workevents-age to change	this

         id (string, optional): A node	id: if set, only  network  events  for
	  this peer are	returned
         index	 (string,  optional) (always "created"): This controls the or-
	  dering of results. The default is created.
         start	(u64, optional): If index is specified,	start may be specified
	  to start from	that value, which is generally	returned  from	light-
	  ning-wait(7).
         limit	 (u32,	optional): If index is specified, limit	can be used to
	  specify the maximum number of	entries	to return.

RETURN VALUE
       On success, an object containing	networkevents is returned.  It	is  an
       array of	objects, where each object contains:

         created_index	 (u64):	 1-based  index	 indicating order this network
	  event	was created in.
         timestamp (u64): Time	this event was recorded, in seconds since Jan-
	  uary 1 1970 UTC
         peer_id (pubkey): The	node the network connection was	talking	to.
         type (string): The type of  event  (currently	 ping,	connect,  con-
	  nect_fail or disconnect)
         reason (string, optional): The cause of the event (if	known)
         duration_nsec	 (u64,	optional):  The	 time taken (for ping, the la-
	  tency, for connect / connect_fail, the time taken to get  a  result,
	  for disconnect, the time we were connected)

       If  type	 is  "connect_fail": - connect_attempted (boolean): True if we
       found an	address	we could attempt to connect to,	e.g. ignoring Tor  ad-
       dresses	if  we	don't  have a proxy, and ignoring IPv6 addresses if we
       don't have IPv6 support.

AUTHOR
       Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.

SEE ALSO
       lightning-autoclean(7), lightning-listpeers(7)

RESOURCES
       Main web	site: <https://github.com/ElementsProject/lightning>

Core Lightning v25.12.1				LIGHTNING-LISTNETWORKEVENTS(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lightning-listnetworkevents&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help