/fleximon

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

Fleximon

A fully customizable UI for Sensu

What is Fleximon

Fleximon is a dashboard creating using dashing. After looking at several other dashboards we couldn't find the features that were required for a multi-team fully customizable dashboard, so we set out to build our own.

Features

  • Able to filter by team
  • Able to customize columns depending on team
  • able to sort and filter by any column
  • able to change the order of the columns in team-view
  • Clear how many alarms of each type are currently active in the selected view
  • Ability to add new columns that are currently not available in sensu (custom tags etc)
  • Supports multi-environment, multi-datacenter
  • Supports multiple sensu API endpoints and data aggregation
  • Easily customizable

Requirements

As fleximon is a dashing dashboard, it is ruby/sinatra with some JavaScript/Coffeescript. Running bundle install in the root fleximon directory will download and install all required ruby gems. You will also need to install NodeJS or some other JS interpreter. Ubuntu is the recommended distribution, although it has been tested on numerous Linux distributions

Running Locally

Vagrant can be used for running an testing locally. First install vagrant, and virtualbox then install the vagrant-vbguest plugin if you don't have it already installed.

vagrant plugin install vagrant-vbguest

Next clone this repository and run vagrant up fleximon in the root of the directory you just cloned.

Then run vagrant up from the fleximon directory. You will then be able to ssh into the virtualbox guest and see fleximon running with some dummy alerts.

Sensu is configured in the environment and test alerts are created for different teams and severities.

You can then access the fleximon UI from both inside and outside the VM by going to http://localhost:8080/sensu Note: if port 8080 is already in use on your host machine then vagrant will assign the next available port.

Running in Production

to do

License

This code is open source software licensed under the GNU General Public License, version 2.