---
html: configure-statsd.html
parent: configure-rippled.html
seo:
    description: Monitor your rippled server with StatsD metrics.
labels:
  - Core Server
---
# Configure StatsD

`rippled` can export health and behavioral information about itself in [StatsD](https://github.com/statsd/statsd) format. Those metrics can be consumed and visualized through [`rippledmon`](https://github.com/ripple/rippledmon) or any other collector that accepts StatsD formatted metrics.

## Configuration Steps

To enable StatsD on your `rippled` server, perform the following steps:

1. Set up a `rippledmon` instance on another machine to receive and aggregate stats.

    ```
    $ git clone https://github.com/ripple/rippledmon.git
    $ cd rippledmon
    $ docker-compose up
    ```

    Make sure [Docker](https://docs.docker.com/) and [Docker Compose](https://docs.docker.com/compose/install/) are installed on your machine when performing the steps above. For more information about configuring `rippledmon`, see the [`rippledmon` repository](https://github.com/ripple/rippledmon).

0. Add the `[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 `rippledmon` is listening. By default, this port is 8125.
    - For the `prefix`, choose a name that identifies the `rippled` server 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.

    {% partial file="/docs/_snippets/conf-file-location.md" /%}

0. Restart the `rippled` service.

    ```
    $ sudo systemctl restart rippled
    ```

0. Check that the metrics are being exported:

    ```
    $ tcpdump -i en0 | grep UDP
    ```

    Replace `en0` with the appropriate network interface for your machine. For a complete list of the interfaces on your machine use `$ tcpdump -D`.

    Sample Output:

    ```
    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 `rippledmon` instance.

For descriptions of each StatsD metric, see the [`rippledmon` repository](https://github.com/ripple/rippledmon).



## See Also

- **Concepts:**
    - [XRP Ledger Overview](/about/)
    - [The `rippled` Server](../../concepts/networks-and-servers/index.md)
- **Tutorials:**
    - [Install `rippled`](../installation/index.md)
    - [Capacity Planning](../installation/capacity-planning.md)
- **References:**
    - [server_info method](../../references/http-websocket-apis/public-api-methods/server-info-methods/server_info.md)
    - [print method](../../references/http-websocket-apis/admin-api-methods/status-and-debugging-methods/print.md)