gelffy is a UDP-based GELF (Greylog Extended Log Format) aggregator with an HTTP POST hook to the LaaS - (Loggly).
gelffy is supposed to be used in the context of Docker. A Docker container (including a service in Docker Swarm mode) can configured to do logging using various drivers. Whenever anything is written to the stdout or stderr of a Docker container, the Docker Engine captures the log entries and processes them using the configured driver.
gelffy uses gelf Docker log driver.
gelffy runs on port 12123.
When a Docker container or a Docker Swarm service is configured to use gelf as its logging driver with gelffy as the endpoint for the GELF log entries, the Docker Engine sends the log entries to the gelffy's UDP endpoint. gelffy processes the log entries and does an HTTP POST to Loggly.
- Clone the repository
git clone https://github.com/younisshah/gelffy.git-
Change your working directory to gelffy
-
Edit the Dockerfile and update the value of LOGGLY_CUSTOMER_TOKEN Env variable to your Loggly Customer Token.
-
Run
dep ensure- Next, run
make build-bin- Then, do a
make build- Finally,
make run- Get the container IP address of gelffy
docker inspect --format '{{ .NetworkSettings.IPAddress }}' gelffy- Run your Docker container (or Docker Swarm service) which gelf log driver and gelffy configured
docker run -p IN_PORT:OUT_PORT --rm --log-driver=gelf --log-opt gelf-address=udp://GELFFY_CONTAINER_IP_ADDRESS:12123 --log-opt gelf-compression-type=none IMAGE_NAME:TAGThat's it!
Now all the logs of your Docker container (or Docker Swarm service) will be pushed to gelffy which POSTs to Loggly.
- Support additional drivers
MIT