korservick / g2mt Goto Github PK

This project provides a relay that can accept metrics in various formats (initially Graphite Line protocol) and send them through various ways.

Early Proof of Concept. Compiles, but not tested extensively

General:

• Don't store metrics forever in queues in case destination is unavailable
• Offload queue overflows to disk
• Internal stats
• Extended stats

Config:

• Override key for Transport distribution

Calculator:

• Calculate real metric frequency
• Detect semi-frequent metrics

Input:

• TCP
• UDP
• Unix Socket
• TLS
• Configurable encoding

Input Encoders:

• Graphite Line Protocol
• Graphite Line Protocol with tags
• Metrics 2.0
• InfluxDB Line Protocol

Output Encoders:

• Graphite Line Protocol
• JSON
• Protobuf
• kafkamdm

Output:

• Kafka
• TCP
• UDP
• Unix Socket

Routing:

• Regexp matching (Re2-based)
• Rewrites
• Prefix Matching
• Blackhole sender
• Log on receive
• PCRE Regexp Matching
• Separate tool to show where metric will lend

LoadBalancing:

• fnv1a
• jump hash fnv1a
• round robin with sticking
• graphite consistent hash

Documentation:

• At least some docs
• Design documentation
• Extended docs

• Some internal queues (if you can call it queues) have no limit so malformed or unthrottled input might lead to OOM issues
• If backend go down, first point in queue will be lost
• Performance is far from optimal.
• Config format is far from perfect (readability, easy of modification, easy of generation)
• Unstable config format

This program was originally developed for Booking.com. With approval from Booking.com, the code was generalised and published as Open Source on GitHub, for which the author would like to express his gratitude.

This code is licensed under the Apache2 license.