Skip to content
This repository
branch: master

Merge pull request #42 from g76r/c4

dashboard fixes and enhancement
latest commit 007a2587dd
Dan Rowe draco2003 authored
Octocat-spinner-32 ajax variable/include path cleanup. added .gitignore. allow config.overide… November 04, 2011
Octocat-spinner-32 assets Add classical values of "from" on the dashboard May 17, 2013
Octocat-spinner-32 bootstrap Remove PHP5.3 requirement, improve portability/install ability. Inclu… October 29, 2011
Octocat-spinner-32 inc Patch for the fix of broken links with id > 1000 May 29, 2013
Octocat-spinner-32 js_cache create empty js_cache/images November 05, 2011
Octocat-spinner-32 plugins Adding initial POC plugin for irccat integration January 18, 2013
Octocat-spinner-32 screenshots Add ini[Ctial pass at screenshots March 14, 2013
Octocat-spinner-32 .gitignore ignoring the logs folder December 11, 2012
Octocat-spinner-32 .htaccess Update .htaccess October 09, 2012
Octocat-spinner-32 README.md Add ini[Ctial pass at screenshots March 14, 2013
Octocat-spinner-32 check.php Implemented Predictive Analytics based Check jpatapoff@a6b07c1 December 11, 2012
Octocat-spinner-32 dashboard.php Add classical values of "from" on the dashboard May 17, 2013
Octocat-spinner-32 graphite_tattle_schema_alpha.sql removing unique index on lines(graph_id,alias) May 17, 2013
Octocat-spinner-32 graphs.php more reverse-proxy-friendly urls May 17, 2013
Octocat-spinner-32 index.php fixing issue #29 December 12, 2012
Octocat-spinner-32 lines.php more reverse-proxy-friendly urls May 17, 2013
Octocat-spinner-32 login.php variable/include path cleanup. added .gitignore. allow config.overide… November 04, 2011
Octocat-spinner-32 processor.php Moving processor path to the config file and throwing an error during… January 17, 2013
Octocat-spinner-32 result.php Issue #5 - adding pagination to alert view & front page. Also added p… May 13, 2012
Octocat-spinner-32 setting.php Include Setting Class and files November 18, 2011
Octocat-spinner-32 statistical_functions.php Implemented Predictive Analytics based Check jpatapoff@a6b07c1 December 11, 2012
Octocat-spinner-32 subscription.php Issue #5 - adding pagination to alert view & front page. Also added p… May 13, 2012
Octocat-spinner-32 user.php Might want to hold off from updating till things stabilize later toni… November 12, 2011
README.md

Tattle (formely Graphite-Tattle)

A self service alerting and dashboard frontend for graphite and ganglia

This tool was first presented at EscConf during a presentation by drowe from Wayfair

Concepts

Checks

A Check is a graphite or ganglia target in combination with a user defined Error and Warning threshold.

Subscriptions

A Subscription is a users signing up for to be alerted by a plugin if the Check reaches the Error or Warning state. A user can have multiple subscriptions to an alert based on different threshold and plugins. (Example : SMS for Error, and Email for Warning)

Alerts

An Alert is the signal that the Check either passed it's defined Error or Warning threshold, or it's returned to the OK state from being in a bad state. The frequency of Alerts is defined by the Repeat Delay (in minutes), which can't be less than the frequency of the processing cronjob.

Dashboards

A Dashboard is a collection of pre-defined graphs that allows for self service creation and has a fullscreen option.

Graph

A Graph in Tattle is a combination of "lines" which make up the graph. A graph can have one or more lines, and can set the display type of the graphs (Stacked or Not) and has a weight for ordering on the dashboard.

Lines

Lines are a combination of an Alias, a graphite Target, and a color.

Screen Shots

Installation Requirements

Installation and Configuration

  • Import .sql file to create database and tables

  • Create a session storage folder for flourishlib

  • Create a file called inc/config.override.php so that upgrades don't blow away your config

    <?
    $GLOBALS['DATABASE_HOST'] = '127.0.0.1';
    $GLOBALS['DATABASE_NAME'] = 'tattle';
    $GLOBALS['DATABASE_USER'] = 'dbuser';
    $GLOBALS['DATABASE_PASS'] = 'dbpass';
    $GLOBALS['GRAPHITE_URL'] = 'http://graph';
    
  • Edit inc/config.php with the correct settings (Examples db password)

  • Create a logs folder which is writable by your webserver user

  • Setup cronjob to to run processor.php. This file can be run either as a cli or through the web server. (cli maybe required depending on your plugins and their required permissions)

  • Register via the web interface. (The first user registered is the admin currently prior to us implementing any roles, and other permissions)

If you are on EL6 or a recent Fedora , make sure your php.ini has short_open_tag = off commented or you will get bogus output.

Dashboard Cleanurls

If you have apache, with mod_rewrite enabled and allow .htaccess files you can try the new Clean Dashboard urls. Initial urls look like this:

http://localhost/dash/1/500/300

The second parameter should be replaced with the dashboard id you want to see. The third parameter represents the heigt of the individual graphs. The fourth parameter represents the width of the individual graphs

HTTP Auth Based User Accounts

If you are already using Web Server based authentication, then you can tell Tattle to use those credentials instead of keeping two sets of user accounts.

just set the following config variable to true in your config.override.php file:

$GLOBALS['ALLOW_HTTP_AUTH'] = true;

Reason for creation

StatsD from the team over at Etsy added a simple Dev and Ops friendly way to send metrics to graphite. graphite makes graphing metrics and data self serve and simple for anyone.

With this tag team in our environment alerting seemed to be the weakest link from an adhoc/self service perspective which is where the idea for Tattle came from.

Caution!

This project is still in an Alpha status and not feature complete or ready for full production use yet. Any help smoothing out the edges and adding additional features / functions would be greatly appreciated!

If you're having strange SQL issues, make sure you are using the most recent schema

How to Contribute

You're interested in contributing to Tattle? Sweet!

fork Tattle from here: http://github.com/wayfair/Graphite-Tattle

  1. Clone your fork
  2. Hackit up
  3. Push the branch up to GitHub
  4. Send a pull request to the wayfair/Graphite-Tattle project.

We'll do our best to get your changes in as soon as possible!

Contributors

In lieu of a list of contributors, check out the commit history for the project: https://github.com/wayfair/Graphite-Tattle/graphs/contributors Though special shout out to jpatapoff since he helped a lot, but his commits weren't attributed due to manually merging

Something went wrong with that request. Please try again.