https://github.com/mindreframer/vagrant-puppet-riemann

https://github.com/mindreframer/vagrant-puppet-riemann

Last synced: 9 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/mindreframer/vagrant-puppet-riemann
• Owner: mindreframer
• Created: 2013-03-10T23:25:32.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2013-05-18T17:08:08.000Z (almost 13 years ago)
• Last Synced: 2025-03-25T08:42:34.259Z (about 1 year ago)
• Language: Puppet
• Size: 1.5 MB
• Stars: 10
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

          
# Sandbox with traffic simulator to play with [Riemann] in [VirtualBox] with [Vagrant]

![Dashboard Screenshot](https://raw.github.com/mindreframer/vagrant-puppet-riemann/master/pics/dashboard_screenshot.png)

### This will install and configure for you:

  - Java 7 (Oracle)

  - Riemann server with basic configuration

  - Riemann Dashboard with some pre-configured graphs

  - Riemann Tools

  - Riemann Health Daemon, that will send every 10 seconds cpu/memory/load/disk status to Riemann server

  - Ports 5555 (riemann-server), 5556(UDP for riemann) and 4567 (dashboard) will be forwarded

  - Mailcatcher to inspect the mails from Riemann (on localhost)

## Requirements

  - [VirtualBox]

  - min. [Vagrant] 1.1

## Installation

    $ git clone git://github.com/mindreframer/vagrant-puppet-riemann.git

    $ cd vagrant-puppet-riemann

    # start vagrant

    # java installation could take a while, it is bigger than 100MB

    $ vagrant up

    # ssh into your VM

    $ vagrant ssh

    # open browser at http://localhost:1080/ (mailcatcher)

    # open browser at http://localhost:4567/ (dashboard)

## Run Puppet, after you have changed modules

    $ runpuppet

## Generate some events for Riemann (a rather naive approach, but you'll have some data to play with)

    # open localhost:4567 in your browser

    # simulate health checks reports

    $ riemann-simulator -s health

    # simulate traffic

    $ riemann-simulator -s web

    # simulate all traffic

    $ riemann-simulator

![Dashboard Blinking](https://raw.github.com/mindreframer/vagrant-puppet-riemann/master/pics/dashboard_blinking.gif)

## Playing with Dashboard

    # press `?` to have the overview of available shortcuts

![Help Screenshot](https://raw.github.com/mindreframer/vagrant-puppet-riemann/master/pics/help_screenshot.png)

## Important files to play with:

  - [server/riemann.config.erb](https://github.com/mindreframer/vagrant-puppet-riemann/blob/master/puppet/modules/riemann/templates/server/riemann.config.erb) -> riemann server

  - [dashboard/config.json.erb](https://github.com/mindreframer/vagrant-puppet-riemann/blob/master/puppet/modules/riemann/templates/dashboard/config.json.erb) -> dashboard

  - [simulators/riemann-simulator.erb](https://github.com/mindreframer/vagrant-puppet-riemann/blob/master/puppet/modules/riemann/templates/simulators/riemann-simulator.erb) -> simulator script

## Credits

  - Kyle Kingsbury - the Riemann author

  - Yukihiro Matsumoto - for Ruby

  - Rich Hickey - for Clojure

  - Linus Torvalds - for Linux

  - Mitchell Hashimoto - the Vagrant author

  - Luke Kanies - the Puppet author

  - Oracle *cough*, for keeping VirtualBox opensource

  - Oracle *cough*, for keeping Java 7 free

  - Alex Dergachev - GIF-Screencast for free on OSX: https://gist.github.com/dergachev/4627207

[Vagrant]: http://vagrantup.com

[VirtualBox]: https://www.virtualbox.org/

[Riemann]: http://riemann.io

## Resources

  **Riemann-Users Group**

    - https://groups.google.com/forum/#!forum/riemann-users

  **riemann.config documentation**

    - http://aphyr.github.com/riemann/api/riemann.config.html

  **Riemann HowTo**

    - http://riemann.io/howto.html

    

  **Riemann streams intro**

    - http://rrees.me/2013/04/20/getting-started-with-riemann-stream-processing/

  **Amara metrics server - a similar Vagrant repo**

    - https://github.com/pculture/amara-metrics

    - http://labs.amara.org/2012-07-16-metrics.html

  **Application specific host grouping in Riemann-dash**

    - https://gist.github.com/aaronfeng/4583640

  **Guardians Config**

    - https://github.com/guardian/riemann-config