#metrics #proxy #route #processor #traffic #file #read #forwarder #accept

app syphon

Versatile metrics processor, proxy and forwarder” syphon is designed to accept and route metrics traffic. Metrics can be received from socket, snooped from live traffic or read from file or grpc. Metrics can be exportered via file, grpc or udp/tcp

1 unstable release

0.1.0 Apr 6, 2020

Custom license

30KB
830 lines

Welcome to syphon 👋

Version License: Apache License 2.0 Twitter: cianbutlerx

Versatile metrics processor, proxy and forwarder

Install

git clone github.com/butlerx/syphon
cd syphon
cargo Install

Usage

$ syphon -h
syphon 0.1.0
butlerx <butlerx@notthe.cloud>
Versatile metrics processor, proxy and forwarder
syphon is designed to accept and route metrics traffic.
Metrics can be received from socket, snooped from live traffic or read from file or grpc.
Metrics can be exportered via file, grpc or udp/tcp

USAGE:
    syphon [FLAGS] [OPTIONS]

FLAGS:
    -h, --help       Prints help information
    -p, --print      Print default config
    -q               Silence all output
    -V, --version    Prints version information
    -v               Increase message verbosity

OPTIONS:
    -c, --config <CONFIG>    Config file to load (default: configs/config.toml)

Configuration

[metric]
# Endpoint for store internal carbon metrics.
# Valid values: "" or "local", "tcp://host:port", "udp://host:port"
endpoint = "local"
# Interval of storing internal metrics. Like CARBON_METRIC_INTERVAL
interval = "1m0s"

[[uploader.udp]]
enabled = false
host = "127.0.0.1"
port = 2004

[[uploader.tcp]]
enabled = false
host = "127.0.0.1"
port = 2004

[[uploader.file]]
enabled = true
path = "metrics_received.txt"
# RegEx pattern to use to Determine if metric should be sent
# Supports  full regex from https://docs.rs/regex/1.3.6/regex/
pattern="metric.path*"

# Designed for use with carbon-clickhouse
# https://github.com/lomik/carbon-clickhouse/blob/master/grpc/carbon.proto
[[uploader.grpc]]
enabled = false
host = "127.0.0.1"
port = 2005

[file]
enabled = true
path = "metrics.txt"

[udp]
enabled = true
listen = "127.0.0.1:2003"
# Setting mode to promiscuous sets the interface to promiscuously listen
# Allows to see traffic on a port already in use
# mode = "promiscuous"

[tcp]
enabled = true
listen = "127.0.0.1:2003"

[prometheus]
enabled = true
listen = "127.0.0.1:2006"

Run tests

cargo check
cargo clippy
cargo test

Author

👤 Cian Butler

🤝 Contributing

Contributions, issues and feature requests are welcome!

Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2020 Cian Butler.

This project is Apache License 2.0 licensed.

Dependencies

~13MB
~244K SLoC