icingaweb2-module-graphite/library/Graphite/Web/Widget/Graphs.php
Alexander A. Klimov 369e39382b Remove all kinds of flickering
refs #72
2017-11-16 18:34:32 +01:00

451 lines
12 KiB
PHP

<?php
namespace Icinga\Module\Graphite\Web\Widget;
use Icinga\Application\Icinga;
use Icinga\Module\Graphite\Forms\TimeRangePicker\TimeRangePickerTrait;
use Icinga\Module\Graphite\Graphing\GraphingTrait;
use Icinga\Module\Graphite\Graphing\Template;
use Icinga\Module\Graphite\Web\Widget\Graphs\Host as HostGraphs;
use Icinga\Module\Graphite\Web\Widget\Graphs\Service as ServiceGraphs;
use Icinga\Module\Monitoring\Object\Host;
use Icinga\Module\Monitoring\Object\MonitoredObject;
use Icinga\Module\Monitoring\Object\Service;
use Icinga\Web\Request;
use Icinga\Web\Url;
use Icinga\Web\View;
use Icinga\Web\Widget\AbstractWidget;
abstract class Graphs extends AbstractWidget
{
use GraphingTrait;
/**
* Graph image width
*
* @var string
*/
protected $width = '300';
/**
* Graph image height
*
* @var string
*/
protected $height = '150';
/**
* Graph range start
*
* @var string
*/
protected $start;
/**
* Graph range end
*
* @var string
*/
protected $end;
/**
* Whether to render as compact as possible
*
* @var bool
*/
protected $compact = false;
/**
* The check command of the monitored object we display graphs for
*
* @var string
*/
protected $checkCommand;
/**
* The "real" check command (if any) of the monitored object we display graphs for
*
* E.g. the command executed remotely via check_by_ssh
*
* @var string|null
*/
protected $obscuredCheckCommand;
/**
* Additional CSS classes for the <div/>s around the images
*
* @var string[]
*/
protected $classes = [];
/**
* The amount of graphs to show
*
* @var int
*/
protected $maxVisibleGraphs;
/**
* Whether to serve a transparent dummy image first and let the JS code load the actual graph
*
* @var bool
*/
protected $preloadDummy = false;
/**
* Factory, based on the given object
*
* @param MonitoredObject $object
*
* @return static
*/
public static function forMonitoredObject(MonitoredObject $object)
{
switch ($object->getType()) {
case 'host':
/** @var Host $object */
return new HostGraphs(
$object->getName(),
$object->host_check_command,
$object->_host_check_command
);
case 'service':
/** @var Service $object */
return new ServiceGraphs(
$object->getHost()->getName(),
$object->getName(),
$object->service_check_command,
$object->_service_check_command
);
}
}
/**
* Constructor
*
* @param string $checkCommand The check command of the monitored object we display graphs for
* @param string|null $obscuredCheckCommand The "real" check command (if any) of the monitored object
* we display graphs for
*/
public function __construct($checkCommand, $obscuredCheckCommand)
{
$this->checkCommand = $checkCommand;
$this->obscuredCheckCommand = $obscuredCheckCommand;
}
/**
* Process the given request using this widget
*
* @param Request $request The request to be processed
*
* @return $this
*/
public function handleRequest(Request $request = null)
{
if ($request === null) {
$request = Icinga::app()->getRequest();
}
$params = $request->getUrl()->getParams();
list($this->start, $this->end) = $this->getRangeFromTimeRangePicker($request);
$this->width = $params->shift('width', $this->width);
$this->height = $params->shift('height', $this->height);
return $this;
}
public function render()
{
/** @var View $view */
$view = $this->view();
$result = []; // kind of string builder
$filter = $this->getMonitoredObjectFilter();
$imageBaseUrl = $this->preloadDummy ? $this->getDummyImageBaseUrl() : $this->getImageBaseUrl();
$templates = static::getAllTemplates()->getTemplates();
$checkCommand = $this->obscuredCheckCommand === null ? $this->checkCommand : $this->obscuredCheckCommand;
$limit = $this->maxVisibleGraphs;
$classes = $this->classes;
$classes[] = 'images';
$div = '<div class="' . implode(' ', $classes) . '">';
$concreteTemplates = [];
$defaultTemplates = [];
foreach ($templates as $templateName => $template) {
if ($this->designedForMyMonitoredObjectType($template)) {
$templateCheckCommand = $template->getCheckCommand();
if ($templateCheckCommand === $checkCommand) {
$concreteTemplates[$templateName] = $template;
} elseif ($templateCheckCommand === null) {
$defaultTemplates[$templateName] = $template;
}
}
}
$renderedGraphs = 0;
foreach ((empty($concreteTemplates) ? $defaultTemplates : $concreteTemplates) as $templateName => $template) {
$charts = $template->getCharts(static::getMetricsDataSource(), $filter, $this->checkCommand);
if (! empty($charts)) {
foreach ($charts as $chart) {
if (empty($result)) {
$result[] = $div;
} elseif ($limit && $renderedGraphs === $limit) {
$result[] = sprintf(
'<input type="checkbox" id="toggle-%1$s" class="collapsible-toggle">'
. '<label for="toggle-%1$s" class="link-button">'
. '<span class="collapsible-show">%2$s</span>'
. '<span class="collapsible-hide">%3$s</span>'
. '</label>'
. '<div class="collapsible">',
$view->protectId($this->getMonitoredObjectIdentifier()),
$view->translate('Show More'),
$view->translate('Show Less')
);
}
$imageUrl = $this->filterImageUrl($imageBaseUrl->with($chart->getMetricVariables()))
->setParam('template', $templateName)
->setParam('start', $this->start)
->setParam('end', $this->end)
->setParam('width', $this->width)
->setParam('height', $this->height)
->setParam('cachebuster', time() * 65536 + mt_rand(0, 65535));
if (! $this->compact) {
$imageUrl->setParam('legend', 1);
}
$result[] = '<img id="graphiteImg-';
$result[] = md5((string) $imageUrl->without('cachebuster'));
$result[] = '" src="';
$result[] = (string) $imageUrl;
$result[] = '" class="detach graphiteImg" alt="" width="';
$result[] = $this->width;
$result[] = '" height="';
$result[] = $this->height;
$result[] = '">';
$renderedGraphs++;
}
}
}
if (! empty($result)) {
if ($limit && $renderedGraphs > $limit) {
$result[] = '</div>';
}
$result[] = '</div>';
return implode($result);
} else {
return "<p>{$view->escape($view->translate('No graphs found'))}</p>";
}
}
/**
* Get time range parameters for Graphite from the URL
*
* @param Request $request The request to be used
*
* @return string[]
*/
protected function getRangeFromTimeRangePicker(Request $request)
{
$params = $request->getUrl()->getParams();
$relative = $params->get(TimeRangePickerTrait::getRelativeRangeParameter());
if ($relative !== null) {
return ["-{$relative}s", null];
}
$absolute = TimeRangePickerTrait::getAbsoluteRangeParameters();
return [$params->get($absolute['start'], '-1hours'), $params->get($absolute['end'])];
}
/**
* Return whether the given template is designed for the type of the monitored object we display graphs for
*
* @param Template $template
*
* @return bool
*/
abstract protected function designedForMyMonitoredObjectType(Template $template);
/**
* Return a identifier specifying the monitored object we display graphs for
*
* @return string
*/
abstract protected function getMonitoredObjectIdentifier();
/**
* Return a filter specifying the monitored object we display graphs for
*
* @return string[]
*/
abstract protected function getMonitoredObjectFilter();
/**
* Get the base URL to a graph specifying just the monitored object kind
*
* @return Url
*/
abstract protected function getImageBaseUrl();
/**
* Get the base URL to a dummy image specifying just the monitored object kind
*
* @return Url
*/
abstract protected function getDummyImageBaseUrl();
/**
* Extend the {@link getImageBaseUrl()}'s result's parameters with the concrete monitored object
*
* @param Url $url The URL to extend
*
* @return Url The given URL
*/
abstract protected function filterImageUrl(Url $url);
/**
* Get {@link compact}
*
* @return bool
*/
public function getCompact()
{
return $this->compact;
}
/**
* Set {@link compact}
*
* @param bool $compact
*
* @return $this
*/
public function setCompact($compact = true)
{
$this->compact = $compact;
return $this;
}
/**
* Get the graph image width
*
* @return string
*/
public function getWidth()
{
return $this->width;
}
/**
* Set the graph image width
*
* @param string $width
*
* @return $this
*/
public function setWidth($width)
{
$this->width = $width;
return $this;
}
/**
* Get the graph image height
*
* @return string
*/
public function getHeight()
{
return $this->height;
}
/**
* Set the graph image height
*
* @param string $height
*
* @return $this
*/
public function setHeight($height)
{
$this->height = $height;
return $this;
}
/**
* Get additional CSS classes for the <div/>s around the images
*
* @return string[]
*/
public function getClasses()
{
return $this->classes;
}
/**
* Set additional CSS classes for the <div/>s around the images
*
* @param string[] $classes
*
* @return $this
*/
public function setClasses($classes)
{
$this->classes = $classes;
return $this;
}
/**
* Get the amount of graphs to show
*
* @return int
*/
public function getMaxVisbileGraphs()
{
return $this->maxVisibleGraphs;
}
/**
* Set the amount of graphs to show
*
* @param int $count
*
* @return $this
*/
public function setMaxVisibleGraphs($count)
{
$this->maxVisibleGraphs = (int) $count;
return $this;
}
/**
* Get whether to serve a transparent dummy image first and let the JS code load the actual graph
*
* @return bool
*/
public function getPreloadDummy()
{
return $this->preloadDummy;
}
/**
* Set whether to serve a transparent dummy image first and let the JS code load the actual graph
*
* @param bool $preloadDummy
*
* @return $this
*/
public function setPreloadDummy($preloadDummy = true)
{
$this->preloadDummy = $preloadDummy;
return $this;
}
}