Dockerized Sumologic File Collector

Sumologic log file collector with dockerization based on original sumologic repo

Will grab specified logfiles and continuously push to sumo collector

Many configuration options available

Prerequisites

You must have Docker and Make (brew install make)

Install

Clone this repo. Then run:

make build

which will build the docker image xogroup/sumologic-file-collector:latest

Usage

Run the image on a container, preferably on detached mode.

see example under starts.sh

It will capture all changes to specified log files and push them to sumologic.

You must pass these config values via env variables:

Variable	Description
SUMO_ACCESS_ID	Your Sumologic access ID
SUMO_ACCESS_KEY	Your Sumologic access key
SUMO_COLLECTOR_NAME	Name of collector for this source. Will create if it doesn't exist.
SUMO_SOURCE_NAME	Name of the source (tipically associated with app name
SUMO_SOURCE_CATEGORY	Type of source (eg: file-log-collector)

Log files location

The Collector expects log files to be placed on the tmp/clogs path (in the container). It is recommended to mount a docker volume to the tmp/clogs path and share it with the logging app.

Pre-packaged commands

We've included some commands for most common operations:

Build docker image

make build

Run collector on background

Runs the collector in background. Assumes that logging app has a docker volume mounted to log files path.

make start namespace=babytechj application=qa-avatars-api sumo_access_key={your_key} sumo_access_secret={your_secret} volumes_from={docker container with shared mounted volume}

Stop collector

make kill

Tag image

make tag

Push to dockerhub

(requires the DOCKER_USERNAME and DOCKER_PASSWORD env variables for authenticating in dockerhub)

make push