grayproxy

command module
v0.0.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 15, 2023 License: MIT Imports: 15 Imported by: 0

README

grayproxy

A simple forwarding proxy for Graylog GELF messages. Can be used as load-balancer in front of multiple Graylog server nodes. Also helps if the Graylog server or logging application is behind a firewall and direct logging to UDP is not viable.

NEW: Support of streaming logs into loki log aggregator.

Usage

The basic usage for single UDP input and single GELF HTTP output is:

docker run --rm -p 12201:12201/udp -it andviro/grayproxy -out http://some.host/gelf

By default grayproxy configures the input at udp://0.0.0.0:12201 and no outputs. Outputs are added using -out flag and may be specified multiple times. Outputs may use HTTP, HTTPS, TCP, UDP and WebSocket protocol and are tried in round-robin fashion. If message was not sent to any output, it will be silently dropped unless disk buffer directory is configured. To listen on multiple TCP, HTTP or UDP inputs, -in flag can be used.

Loki output

To send logs into loki endpoint, HTTP or HTTPS output URL should end with "/api/prom/push".

WebSocket output

-out ws://MyToken@127.0.0.1:20222

Emits all incoming messages to all connected WebSocket clients. Message is firstly converted to flattened json structure. Server side filtering of message is possible by specifying filters in query string.

curl --include \
     --no-buffer \
     --header "Connection: Upgrade" \
     --header "Upgrade: websocket" \
     --header "Host: 127.0.0.1:20222" \
     --header "Origin: http://127.0.0.1:20222" \
     --header "Sec-WebSocket-Key: SGVabG8sIHOvcmxDIQ==" \
     --header "Sec-WebSocket-Version: 13" \
     "http://127.0.0.1:20222/filter?token=MyToken&container_name=mycontainer"

or use Graytail

Command-line options

  -dataDir string
    	buffer directory (defaults to no buffering)
  -in value
    	input address in form schema://address:port (may be specified multiple times). Default: udp://:12201
  -out value
    	output address in form schema://address:port (may be specified multiple times)
  -sendTimeout int
    	maximum TCP or HTTP output timeout (ms) (default 1000)

Credits

The idea of a pipelined GELF dechunker borrowed from timtkachenko/gelf-go.

License

This code is released under MIT license.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg
tcp
tls
udp
ws

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL