patsoo08/surikator repository overview

⁠Surikator

Surikator is middleware⁠ written in Go language, that you run in CLI⁠ to capture events from orchestrators (docker containers) of operational data (docker events are structured as ID and LABEL). These events are formated, parsed then send the operational data to Elasticsearch, so it can be visualized with Kibana.

⁠Documentation and Getting Started

You can find all about Docker from here⁠ .

You can find the documentation and getting started guides for each of the Beats on the elastic.co site⁠:

• Logstash⁠
• Metricbeat⁠

⁠Setting up your GoLang dev environment

Current Go version used for development is Golang 1.8.1. The location where you clone is important. Please clone under the source directory of your GOPATH. If you don't have GOPATH already set, you can simply set it to your home directory (export GOPATH=$HOME).

$ mkdir -p ${GOPATH}/src/github.com/sebastienmusso $ cd ${GOPATH}/src/github.com/sebastienmusso $ git clone https://github.com/sebastienmusso/infradatamgmt.git⁠

⁠Setting up your Docker environment

You can download docker compose file to set up a default configuration for Surikator, from here⁠.

⁠Run Surikator

• Windows: $ docker run -v //var/run/docker.sock:/var/run/docker.sock patsoo08/surikator

• Linux: $ docker run patsoo08/surikator

⁠Backend ELK

-> use docker-compose file ELK-backEnd.yml

⁠Using Surikator with CLI

You have to add options with flag -l to use Surikator. The options of Surikator with Docker command are: monitor = enabled metric = enabled logging = enabled stdout = enabled application_type=

samples:

$docker run -d -l monitor=enabled -l metric=enabled -l stdout=enabled -l application_type=nginx nginx

$docker run -l monitor=enabled -l metric=enabled -l logging=enabled -l application_type=apache -l stdout=enabled -d httpd

$docker run -d -l monitor=enabled -l metric=enabled -l stdout=enabled -l application_type=php -p 80:80 --name php7apache php:7.0-apache

⁠Contributing

We'd love working with you! You can help make this programme better in many ways: report issues, help us reproduce issues, fix bugs, add functionality, or even create your own Beat.

Please start by reading our CONTRIBUTING⁠ file.

⁠Crédits

Send ideas and questions to @Treeptik request features and report bugs using the GitHub Issue Tracker.

To find all Treeptik's github project here⁠.

Developed by Treeptik⁠'s team @2017.