Cacti (home)ForumsDocumentation

autom8

type:
plugin
plugin:
autom8
author:
gandalf
description:
This Plugin automates Creation of Graphs and Tree Entries
version:
N/A
statu:
core
cacti:
N/A
date:
N/A
license:
GPL v2
plugins:
automation,
graph,
tree

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.x): autom8-v0.35.tgz

Archive (Cacti 0.8.x): autom8-v0.33.tgz

Archive (Cacti 0.8.x): autom8_v031.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.

Maintaining a quite decent Cacti installation with lots of devices, graphs and tree items may result in quite a huge amount of administrative work.

Using the cli scripts allows you to write your own scripts to e.g. create Cacti device entries, graphs, tree items and more. This helps e.g. interfacing a CMDB or some other repository that holds information about devices that shall be monitored.

Features

  1. create new graphs automatically
  2. create new tree entries automatically
  3. Rules are executed in following cases:
    1. a cli script is called (e.g. add_device.php, add_graph.php, …)
    2. a Re-Index is performed on a Data Query. This includes poller_reindex_hosts.php
    3. A new Host is created. In this case, Rules for _ALL_ associated Data Queries are executed one after the other
  4. Simple Graph Templates will be evaluated to create those graphs in any event.

Prerequisites

Before you install AUTOM8, you need to have met the following pre-requisites:

  1. Cacti 0.8.7x using Plugin Architecture V2.x. Tested using PIA 2.4
  2. Install all patches provided with this plugin:
    1. cli.patch
    2. lib_api_automation_tools.php.patch
    3. lib_api_tree.php.patch
    4. host.php.patch
    5. lib_api_device.php.patch
    6. lib_data_query.php.patch

To do so, please go to main Cacti directory. Then, please run

       patch -p1 -N --dry-run < plugins/autom8/<version>/cli.patch

If everything looks fine, omit the –dry-run

       patch -p1 -N < plugins/autom8/<version>/cli.patch

Do this for all patch files. <version> is either “patches-087d”, “patches-087e” or “patches-087g”.
When using Plugin Architecture 2.9 there's no need for patching. This procedure will as well be obsolete with Cacti 088.

Installation

Install prereqs. Gunzip and untar as usual. See Installation Manual for in-depth description of everything.

Usage

Please find a full featured 30 page manual attached as a pdf: Automate Manual (as of v0.35). This manual is as well part of the downloadable code!

Additional Help?

If you need additional help, please goto http://forums.cacti.net

Possible Bugs?

Screenshots

Default Graph Rules provided by this Plugin as an Example

Graph Rule

The Plugin provides means to test the rules

Matching Hosts

Default Tree Rule

Tree Rule






Personal Tools