We are making an effort to offer the XRP Ledger Dev Portal in a variety of languages, but not all pages are available in all languages. If you'd like to help, please contribute!
rippled can export health and behavioral information about itself in StatsD format. Those metrics can be consumed and visualized through
rippledmon or any other collector that accepts StatsD formatted metrics.
To enable StatsD on your
rippled server, perform the following steps:
Set up a
rippledmoninstance on another machine to receive and aggregate stats.
$ git clone https://github.com/ripple/rippledmon.git $ cd rippledmon $ docker-compose up
[insight]stanza to your
rippled's config file.
[insight] server=statsd address=192.0.2.0:8125 prefix=my_rippled
- For the
address, use the IP address and port where
rippledmonis listening. By default, this port is 8125.
- For the
prefix, choose a name that identifies the
rippledserver you are configuring. The prefix must not include whitespace, colons ":", or the vertical bar "|". The prefix appears on all of the StatsD metrics exported from this server.
The recommended installation uses the config file
/etc/opt/ripple/rippled.cfgby default. Other places you can put a config file include
$HOMEis the home directory of the user running
$HOME/.local/ripple/rippled.cfg, or the current working directory from where you start
- For the
$ sudo systemctl restart rippled
Check that the metrics are being exported:
$ tcpdump -i en0 | grep UDP
en0with the appropriate network interface for your machine. For a complete list of the interfaces on your machine use
$ tcpdump -D.
00:41:53.066333 IP 192.0.2.2.63409 > 192.0.2.0.8125: UDP, length 196
You should periodically see messages indicating outbound traffic to the configured address and port of your
For descriptions of each StatsD metric, see the
rippledmon repository .