openshift/eventrouter

Name: eventrouter

Owner: OpenShift

Description: A simple introspective kubernetes service that forwards events to a specified sink.

Forked from: heptiolabs/eventrouter

Created: 2017-09-05 15:02:59.0

Updated: 2017-09-05 15:03:14.0

Pushed: 2017-09-26 15:17:50.0

Homepage: null

Size: 3183

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Eventrouter

This repository contains a simple event router for the Kubernetes project. The event router serves as an active watcher of event resource in the kubernetes system, which takes those events and pushes them to a user specified sink. This is useful for a number of different purposes, but most notably long term behavioral analysis of your workloads running on your kubernetes cluster.

Goals

This project has several objectives, which include:

• Persist events for longer period of time to allow for system debugging
• Allows operators to forward events to other system(s) for archiving/ML/introspection/etc.
• It should be relatively low overhead
• Support for multiple sinks should be configurable

NOTE:

By default, eventrouter is configured to leverage existing EFK stacks by outputting wrapped json object which are easy to index in elastic search.

Non-Goals:

• This service does not provide a querable extension, that is a responsibility of the sink
• This service does not serve as a storage layer, that is also the responsibility of the sink

Building

You can build and test either as a standalone go application or as a Docker container.

Standalone:

 get github.com/heptio/eventrouter

Containerized:

do make all 

Configure and Execute

Standalone:

Assuming your testing on a local cluster, it will use the local config.json, which you can override.

eventrouter -v 3 -logtostderr 

On the cluster

Standup:

bectl create -f yaml/

Teardown:

bectl delete -f yaml/