mrtazz/yagd

Yet another graphite dashboard

yagd

, _(*1)

Overview

Yet Another Graphite Dashboard - because why not? It's heavily inspired by the Etsy dashboard framework but only provides a very small subset of features. If you have a lot of hosts or need advanced features I'd recommend checking that out., _(*2)

Look

, _(*3)

Requirements

• PHP >= 5.5
• Graphite

Installation

• in your dashboards repo, run: composer require mrtazz/yagd
• copy config.example.php to config.php and adapt it
• write php to create your dashboards

Usage examples

Generic dashboards

There is a generic Page.php class included which can just include all Graphite graphs you have in an array called $metrics like this:, _(*4)

<?php

$metrics = array(
    'carbon.agents.foo_example_com-a.committedPoints',
    'carbon.agents.foo_example_com-a.cpuUsage',
    'carbon.agents.foo_example_com-a.avgUpdateTime',
    'carbon.agents.foo_example_com-a.creates',
    'carbon.agents.foo_example_com-a.errors',
    'carbon.agents.foo_example_com-a.metricsReceived',
    'carbon.agents.foo_example_com-a.pointsPerUpdate',
    'carbon.agents.foo_example_com-a.updateOperations',
);

$page = new Page($CONFIG);
$page->renderFullPageWithMetrics($metrics);

Display CollectD host data

If you are using collectd to gather system level graphs you can draw basic information onto a dashboard like this:, _(*5)

Configure hosts in your config.php, _(*6)

$CONFIG['hosts'] = [
        "foo.example.com" => [
            "cpus" => 2,
            "filesystems" => [ 'root', 'var', ]
            ],
            "additional_metrics" => [
                "disk temp" => [
                "disk temperature" => "collectd.foo_example_com.disktemp-ada*.current",
                ]
            ],
        ]
    ];

And then drop something like this into e.g. htdocs/hosts.php:, _(*7)

<?php

require __DIR__ . '/../vendor/autoload.php';

include_once("../config.php");

use Yagd\CollectdHost;
use Yagd\Page;

$page = new Page($CONFIG);
echo $page->getHeader($CONFIG["title"],
    $CONFIG["navitems"]);

foreach($CONFIG["hosts"] as $host => $data) {

    $fss = empty($data["filesystems"]) ? [] : $data["filesystems"];

    $server = new CollectdHost($host, $data["cpus"], $fss,
                               $data["interfaces"]);
    $server->setGraphiteConfiguration($CONFIG["graphite"]["host"]);
    echo "<h2> {$host} </h2>";
    $server->render();
}

echo $page->getFooter();

Inject a select box into the navbar

For the host page for example you might wanna have an easy way to only show one host. For that you can inject a select box into the header navbar like this:, _(*8)

<?php

$selectbox = "";
$selectbox .= "

This will show the content of $selectbox in the header and only show the actually selected host (if one was selected) on the page., _(*9)