📊 statsd to Levitate
This document describes the ways in which a user can send ship metrics via statsd to Levitate.
Introduction
statsd is one of the oldest and most common ways to ship your application or infra metrics to a backend time series database like Graphite, InfluxDB, etc.
statsd comprises 3 basic concepts :
- client: usually a client library that instruments an application to send metrics e.g. statsd-kafka
- server: the statsd daemon accepting metrics from the
client
- backend:- TSDB accepting metrics from the
server
Pre-requisites
- You have created a Levitate cluster by following the getting started guide and have the following info:
- Remote write endpoint URL = $LEVITATE_REMOTE_WRITE_URL
- Remote write username = $LEVITATE_REMOTE_WRITE_USERNAME
- Remote write password = $LEVITATE_REMOTE_WRITE_PASSWORD
- Clone last9-integrations GitHub repo which contains the sample code.
statds graphite backend method (recommended)

statsd Graphite backend method
statsd_client_application
pushes metrics tostatsd_server
statsd_server
has enabled built in backend Graphite.vmagent
listens on port 2003 to accept metrics in Graphite format.vmagent
remote writes these metrics to Levitate/
A complete example using this approach can be found here.
This is our recommended approach for pushing statsd metrics to Levitate.
Relay method

Relay method
statsd_client_application
pushes metrics tostatsd_exporter
.statsd_exporter
transparently relays the metrics to existingstatsd_server
, which writes them to thestatsd_backend
e.g. Graphite, InfluxDb.statsd_exporter
exposes the metrics on a/metrics
portvmagent
scrapes these metrics and remote writes them to Levitate.
A complete example using this approach can be found here
Repeater method

Repeater method
- statsd_application pushes metrics to statsd_server
- statsd_server enables repeater mode to push metrics to existing
statsd_backend
andstatsd_exporter
statsd_exporter
exposes metrics on/metrics
vmagent
scrapes these metrics and remote writes them to Levitate.
A complete example using this approach can be found here
Comparison
Approach | Pros | Cons |
---|---|---|
Graphite backend | vmagent can push metrics to Levitate, no config changes to the applicaiton | Requires changing statsd config |
Relay | No config changes to the statsd. | Requires changing application config. |
Repeater | No config changes to the application. | Requires changing statsd config. |
Next steps
Create a read token for your Levitate Cluster and follow our guide to Configure Grafana to visualize the time series data getting sent to Levitate.
Troubleshooting
Please get in touch with us on Discord or Email if you have any questions.
Updated 7 months ago