StatsD Instructions

java.md

Java Install Instructions

These instructions are for Java language bindings. If you are looking to monitor the JVM, we recommend using our JVM integration.

If use the Dropwizard framework please use our Dropwizard Plugin.

1. Using Maven.

<dependency>
    <groupId>com.librato.metrics</groupId>
    <artifactId>librato-java</artifactId>
    <version>2.0.5</version>
</dependency>

2. Initialize the client:

LibratoClient client = LibratoClient.builder(customer-email@example.com, CUSTOMER_API_KEY)
    // these are optional
    .setConnectTimeout(new Duration(5, SECONDS))
    .setReadTimeout(new Duration(5, SECONDS))
    .setAgentIdentifier("my app name")
    // and finally build
    .build();

3. Quick Start for sending metrics.

PostMeasuresResult result = client.postMeasures(new Measures()
    .add(new TaggedMeasure(name, value, tag, tag))
    .add(new TaggedMeasure(name, sum, count, min, max, tag, tag ,tag)));

for (PostResult postResult : result.results) {
    if (result.isError()) {
        log.error(result.toString);
    }
}

Librato.json

{
    "event": "librato_",
    "url": "https://metrics-api.librato.com/v1/measurements",
    "requestType": "POST",
    "auth": {
        "username": "YOUR_LIBRATO_USERNAME",
        "password": "YOUR_LIBRATO_API_TOKEN"
    },
    "json": {
        "tags": {
            "device": "{{PARTICLE_DEVICE_ID}}"
        },
        "measurements": [{
            "name": "{{PARTICLE_EVENT_NAME}}",
            "value": "{{PARTICLE_EVENT_VALUE}}"
        }]
    },
    "noDefaults": true
} 

particle.md

Particle Install Instructions

Full Instructions availble at docs.particle.io

1. Download librato.json
2. Using the Particle CLI. Create a new webhook.

$particle webhook create librato.json

3. Restart your application.

python.md

Python Install Instructions

Full Instructions availble at the Librato StatsD Github Readme.

1. Install via pip

$ pip install librato-metrics or from your application or script: import librato

2. Setup Authentication

api = librato.connect('customer-email@example.com"', 'CUSTOMER_API_KEY')

3. Quick Start for sending metrics.

api.submit("temperature", 22, tags={'city': 'austin', 'station': '27'})

Ruby.md

Ruby Install Instructions

Full Instructions availble at the Librato Metrics Github Readme.

1. Install Librato Metrics into your application. $gem install librato-metrics

2. Include Librato into your application. require 'librato/metrics'

3. Quick Start for sending metrics.

Librato::Metrics.authenticate 'customer-email@example.com', 'CUSTOMER_API_KEY'
Librato::Metrics.submit my_metric: 42, my_other_metric: 1002

statsd.md

StatsD Install Instructions

Full Instructions availble at the Librato StatsD Github Readme.

1. Install StatsD into your application.

$ cd /path/to/statsd
$ npm install statsd-librato-backend

2. Add the following to your StatsD config file.

librato:{ 
  email: "customer-email@example.com",
  token: "CUSTOMER_API_KEY"
}

3. Restart your application.