Project

recognizer

0.01
No commit activity in last 3 years
No release in over 3 years
A drop-in replacement for Graphite Carbon (TCP & AMQP), sending metrics to Librato Metrics.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

= 0.8.0
>= 0
= 1.2.2
 Project Readme

Welcome to Recognizer

A Graphite Carbon impostor, sending metrics to Librato Metrics.

TCP plain text & AMQP support.

https://secure.travis-ci.org/portertech/recognizer.png

https://github.com/portertech/recognizer/raw/master/recognizer.gif

Install

Executable Java JAR

wget http://portertech.s3.amazonaws.com/recognizer/recognizer.jar

Configure

Example: config.json

{
  "librato": {
    "email": "email@example.com",
    "api_key": "706325cf16d84d098127e143221dd180706325cf16d84d098127e143221dd180"
  },
  "amqp": {
    "host": "localhost"
  },
  "tcp": {
    "port": 2003
  }
}

Usage

Executable Java JAR

java -jar recognizer.jar -h

Usage: recognizer (options)
 -c, --config CONFIG              The config file path
 -h, --help                       Show this message

More

By default, Recognizer flushes metrics to Librato every 10 seconds

Set the interval to flush to Librato

{
  "librato": {
    "flush_interval": 5
By default, Recognizer uses recognizer as the metric source

Example metric path: production.i-424242.cpu.user

Extract the metric source from the metric path using a regular expression

{
  "librato": {
    "metric_source": "/i-.*/"

Or using an index

{
  "librato": {
    "metric_source": 1

Or set a static source

{
  "librato": {
    "metric_source": "example"
By default, The Recognizer TCP server uses 20 threads

Set the number of threads the TCP server uses

{
  "tcp": {
    "threads": 30
By default, The recognizer TCP server binds to 0.0.0.0

Make the TCP server listen only on local interface.

{
  "tcp": {
  "address": "127.0.0.1"
By default, Recognizer binds the AMQP queue recognizer to the topic exchange graphite with the routing key #

Use a custom AMQP exchange

{
  "amqp": {
    "exchange": {
      "name": "metrics",
      "type": "topic",
      "durable": true,
      "routing_key": "#"

License

Recognizer is released under the MIT license.