<commit_before># Riepete - Riemann Repeater

Receives [statsd](https://github.com/etsy/statsd/) packets and repeats
them to [riemann](http://riemann.io/).

[![Build Status](https://travis-ci.org/simao/riepete.png?branch=master)](https://travis-ci.org/simao/riepete)
 
## Supported metrics

Currently riepete supports as subset of statsd metrics as defined in
https://github.com/etsy/statsd/blob/master/docs/metric_types.md.

In particular, riepete does not support:

- [sets](https://github.com/etsy/statsd/blob/master/docs/metric_types.md#sets)

- gauges with `-`/`+` modifiers.

  Gauges will still be parsed and accepted by riepete, but they will
  be mapped into metrics with the received positive/negative value and
  sent to riemann.

## Metrics send to riemann

For each metric received by riepete a new event is sent to riemann.

The event sent to riemann has:

- Its `status` set to `ok`
- Its `hostname` set to the hostname where riepete is running
- Its `description` and `service` set to the key name used in the statsd metric
- Its `tags` set to `statsd, riepete, <metric_type>` where
  `<metric_type>` is one of `Counter`, `Gauge` or `Timer`.

## Caveats

Metrics are repeated to riemann without any type of aggregation. Each
statsd UDP packet will result in a metric being sent to riemann. If
you need some kind of aggregation you will need to do it in
riemann. See the next section for an example on how to do this.

## Installing

The latest version is available at
https://github.com/simao/riepete/releases/latest

You can extract this file into a directory and just run
`bin/start`. This will start riepete in the foregrou with the default
settings. Here is one liner if you just want to try running it:

```<commit_msg>more than one line is not one liner<commit_after># Riepete - Riemann Repeater

Receives [statsd](https://github.com/etsy/statsd/) packets and repeats
them to [riemann](http://riemann.io/).

[![Build Status](https://travis-ci.org/simao/riepete.png?branch=master)](https://travis-ci.org/simao/riepete)
 
## Supported metrics

Currently riepete supports as subset of statsd metrics as defined in
https://github.com/etsy/statsd/blob/master/docs/metric_types.md.

In particular, riepete does not support:

- [sets](https://github.com/etsy/statsd/blob/master/docs/metric_types.md#sets)

- gauges with `-`/`+` modifiers.

  Gauges will still be parsed and accepted by riepete, but they will
  be mapped into metrics with the received positive/negative value and
  sent to riemann.

## Metrics send to riemann

For each metric received by riepete a new event is sent to riemann.

The event sent to riemann has:

- Its `status` set to `ok`
- Its `hostname` set to the hostname where riepete is running
- Its `description` and `service` set to the key name used in the statsd metric
- Its `tags` set to `statsd, riepete, <metric_type>` where
  `<metric_type>` is one of `Counter`, `Gauge` or `Timer`.

## Caveats

Metrics are repeated to riemann without any type of aggregation. Each
statsd UDP packet will result in a metric being sent to riemann. If
you need some kind of aggregation you will need to do it in
riemann. See the next section for an example on how to do this.

## Installing

The latest version is available at
[releases/latest](https://github.com/simao/riepete/releases/latest)

You can extract this file into a directory and just run
`bin/start`. This will start riepete in the foregrou with the default
settings. Here a simple way to start:

```
{'fraction_non_alphanumeric': 0.09304322931577441, 'fraction_numerical': 0.0, 'mean_word_length': 4.161004431314623, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 12, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '584945', 'n_tokens_mistral': 1132, 'n_tokens_neox': 1075, 'n_words': 451}