Skip to content

sascha-andres/go-logsink

Repository files navigation

go-logsink

Go Report Card codebeat badge Code Climate FOSSA Status

What is go-logsink

go-logsink is a client and server application to aggregate multiple streams into one.

It does so by sending all data piped into the client to the server.

Usage

To start a server just type go-logsink listen. By default the server listens on port 50051. You can change the default binding definition using the bind flag:

go-logsink listen --bind ":55555"

In this sample, the server would listen on port 55555.

To send data to the server you have to start at least one client. For example to send the syslog to the server:

sudo tail -f /var/log/syslog | go-logsink connect --address "localhost:55555"

Using the address flag it is possible to send data to the non default destination (localhost:50051)

An advanced usage would be to forward all logs from running docker containers:

for cont in `docker ps -q`; do
    docker logs -f $cont | go-logsink connect &
done

This assumes a running go-logsink server at localhost:50051

You can even start a webserver using

go-logsink web

More usage: See go-logsink documentation

Develop

The application uses a very simple protocol buffer based RPC service to communicate. You should install Protocol Buffers v3.1.0 from https://github.com/google/protobuf/releases/tag/v3.1.0 ( used to create this project initially ).

The Makefile contains a protobuf target which creates the implementation from the specification ( located in logsink/logsink.proto ).

The project uses go modules

Cross compiling Windows

current state: untested binary

You have to go get github.com/inconshreveable/mousetrap before you can crosscompile.

OSX

You can crosscompile OSX or download the darwin.tgz from the releases. Rudimentary tests were done, no in depth testing, though

History

Version Description
v2.1.0 refactored to improve overall quality
(BETA) Serilog sink
colored console output
streaming gRPC
v2.0.0 new ui based on vue.js
removed options for client side code
add option to load ui from local path
v1.3.0 update to go-modules
v1.1.0 Web included in binary
Deprecated relaying
Added prometheus metrics
v1.0.2 Graceful shutdown
v1.0.1 go-ps
v1.0.0 New versioning scheme
Lockfile support
go-releaser
Added .editorconfig
20170124 Forcing display space usage
Allow toggling of scroll
Add a --break switch to connect
Enabling CORS
Supporting SSL behind a proxy
Added --pass-through switch on connect to pass text to stdout
Allow changing the line limit in web
Breaking on web for pre element
Filtering in web
20170117 Web endpoint
doc command
version command
Allow providing a prefix
20170110 Initial version