Cacti (home)ForumsDocumentation

nectar

type:
plugin
plugin:
nectar
author:
gandalf
description:
Cacti Graphical Email Reports
version:
N/A
statu:
core
cacti:
N/A
homepage:
http://docs.cacti.net/plugin:nectar
date:
N/A
license:
GPL v2
plugins:
nectar,
graph,
mail,
report

Please note that this plugin has been merged into the base of Cacti 1.x on GitHub. Older versions of this plugin are maintained here for reference only.

Download

Archive (Cacti 0.8.8): nectar-v0.35a.tgz

Archive (Cacti 0.8.8): nectar-v0.34-1.tgz

Purpose

Please note that this plugin has been merged into the base of Cacti 1.x on GitHub. Older versions of this plugin are maintained here for reference only.

This plugin allows you to email graphs on a given and selectable interval

Features

  • allow both users and admins to create reports
  • include tree's, text, horizontal rules, and graphs into reports
  • allows filtering of tree and host content on trees by regular expression
  • allow basic formmatting
  • allow custom css and html to be integrated into the reports
  • specify different timespans for graphs
  • schedule reports using different scheduling intervals
  • basic png2jpeg conversion using php-gd, verified with linux only

Prerequisites

  • PIA 2.x based installation required
  • NOTE: You must patch the settings plugin using the attached patch
  • NOTE: You must update the ./lib/html_utility.php file if running Cacti versions less than or equal to 0.8.7e

Installation

Like any other PIA 2.x plugin.

Usage

Nectar provides for creating simple report output. However, in the 'formats' directory, you can include custom html and css files to control the look and feel of the e-mail message.

In the case you choose to include not only css, but wrap the report in html, you must either place a special <REPORT> tag inside the report, or be prepared for the report contents to immediately follow the content of your special file.

The format files must exist in the 'formats' directory and have a 'format' file extension. No other files in this directory will be processed. In addition, they need to include a “Description:” comment line that will be used inside of the Nectar UI to describe the format file.

# Description: Minimal Format
<style type='text/css'>
.report_table {
    background-color:#F9F9F9;
    align: center;
    border:0;
    width:100%;
}
</style>
<table><tr><td>My Report</td></tr></table>

Any image data that you include, must be fully addressable by url as currently Nectar will not process that image data into attachments.

Additional Help?

If you need additional help, please goto http://forums.cacti.net There is no specific documentation at this time.

Possible Bugs?

Screenshots






Personal Tools