Cacti

Version 1 by Bren Eckles
on Oct 05, 2017 18:47.

compared with
Current by Bren Eckles
on Oct 05, 2018 12:48.

Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (40)

View Page History
h6. Overview

Cacti is an open source toolkit for graphing network resources and is integrated into GroundWork Monitor. 

In simple terms, Cacti periodically measures the resource utilization levels of selected network devices and then publishes dynamic, user-defined graphs from that data. Whereas most of the components in GroundWork Monitor are designed for the purpose of monitoring the devices on a network (such as measuring the available resources on a host and then generating alarms when conditions require it), Cacti is primarily designed to help administrators visualize the resource utilization of the network devices.{section}
* [RAPID-based Feeders|RAPID-based Feeders]
* [cacti.net|https://www.cacti.net/]
{column}{column}{color:#333333}WAS THIS PAGE HELPFUL?{color}
{column}{column}WAS THIS PAGE HELPFUL?

* {html}<a href="mailto:training@gwos.com?subject=Cacti Network Graphing">Leave Feedback</a>{html}{column}{section}

{note:title=Best Practice}
A GroundWork Monitor system user with membership based access to Cacti should be pre-created as a user in Cacti with the same username and correct Cacti realm permissions (access privileges)&nbsp;+prior+&nbsp;to privileges) +prior+ to the user logging into Cacti from the GroundWork portal.
{note}

To create the user accounts, click on the "User Management" menu item in the left navigation bar. You will then be presented with a screen that lists the currently defined user accounts, similar to the following:

Figure: User Aaccounts
!bookshelf_cacti_01.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_01.gif|alt="User accounts",title="User accounts"!

To create a new user account with the default settings, click the "Add" hyperlink in the top right corner. A new screen will be displayed that allows you to specify the account name, the user's full name, the user's password, and so forth, similar to the following:

Figure: New User Accounts
!bookshelf_cacti_02.gif|hspace=5px|align=left,border=1!
Figure: New user accounts
!bookshelf_cacti_02.gif|alt="New user accounts",title="New user accounts"!

Once you are finished setting the account details, click the "create" button in the bottom right corner.
To configure the discovery plugin global settings, click on the "Settings" menu item in the left navigation bar, and then click on the "Misc" tab of the resulting screen. You should see a "Discover" section of the screen similar to the following:

Figure: Cacti Ssettings
!bookshelf_cacti_03.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_03.gif|alt="Cacti settings",title="Cacti settings"!

Set the fields to appropriate values, and then click the "Save" button at the bottom of the screen to continue.
To configure the threshold plugin settings, click on the "Settings" menu item in the left navigation bar, and then click on the "Alerting/Thold" tab of the resulting screen. A new screen should be displayed, similar to the following:

Figure: Configuring Tthresholds
!bookshelf_cacti_04.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_04.gif|alt="Configuring thresholds",title="Configuring thresholds"!

{note}Activating the "Dead Hosts Notification" checkbox will cause Cacti to send notification email messages for every host that is in a "down" state. This is a global on-off switch, and there is no way to override this setting on per-host basis. As such, this option should only be used if all of the hosts that are monitored by Cacti are critical.{note}
To configure the weathermap plugin settings, click on the "Settings" menu item in the left navigation bar, and then click on the "Misc" tab of the resulting screen. You should see a "Network Weathermap" section of the screen similar to the following:

Figure: Weathermap Plugin Settings
!bookshelf_cacti_05.gif|hspace=5px|align=left,border=1!
Figure: Weathermap plugin settings
!bookshelf_cacti_05.gif|alt="Weathermap plugin settings",title="Weathermap plugin settings"!

The most important option in this dialog is the "Map Rendering Interval" value, which determines how frequently the plugin generates the map output. Since the plugin is executed by the Cacti poller, setting this value to "Every Poller Cycle" will result in the maps being generated every time the poller runs (every five minutes, by default). If you need to have the maps generated more frequently, you will need to alter the poller's scheduled interval (refer to the Configuring the Polling Engine section above for more information on this process).
To manage the Cacti device entries, click on the "Devices" menu item in the left navigation bar. You will then be presented with a screen that lists the currently defined host devices, similar to the following:

Figure: Cacti Ddevices
!bookshelf_cacti_06.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_06.gif|alt="Cacti devices",title="Cacti devices"!

To edit an existing device entry, click on the hyperlinked name of the device.
To add a new device, click on the "Add" hyperlink in the upper right corner of the screen. A new screen will be displayed which allows you to specify the device details, similar to the following:

Figure: New Ddevices
!bookshelf_cacti_07.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_07.gif|alt="New devices",title="New devices"!

The top section of the screen contains the basic identifying data for the device. Specifically, the "Description" field is used for the device' friendly host name, which will appear in various lists and graphs throughout Cacti (this field is also used as the primary key when Cacti graphs are linked with a host device in GroundWork Monitor, and must be identical to the Nagios device name). Meanwhile, the "Hostname" field is the specific identifier that will always be used to link the device entry with the device itself (generally speaking, a full domain is the best choice for the latter field, since it allows for better mobility than IP addresses).

Figure: Device Definition - Graph Templates and Data Queries
!bookshelf_cacti_08.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_08.gif|alt="Device Definition - Graph Templates and Data Queries",title="Device Definition - Graph Templates and Data Queries"!

New graph templates can be added from the device definition screen or by clicking on the "Create Graphs for this Host" hyperlink at the top of the screen. To add a graph template to a device from the definition screen, choose the desired graph template from the "Add Graph Template" drop-down list in the "Associated Graph Templates" section, and then click the "add" button next to it. To add a graph template from the "Create Graphs" screen, choose the desired graph template from the "Create:" drop-down list in the "Graph Templates" section, and then click the "create" button in the lower right corner. In either case, the current screen will reload with the selected graph being listed in the appropriate section.
The discovery templates use rudimentary pattern matching, and are simple to create. Essentially, each discovery template identifies a substring that should appear in the SNMP system identification text, and the host template that should be used to automatically create the device definition when this occurs. Discovery templates are managed by clicking the "Discovery Templates" menu item in the left navigation bar. A new screen will be shown that lists all of the discovery templates, similar to the following (the default screen will be empty, since no discovery templates are defined by default):

Figure: Managing Discovery Templates
!bookshelf_cacti_09.gif|hspace=5px|align=left,border=1!
Figure: Managing discovery templates
!bookshelf_cacti_09.gif|alt="Managing discovery templates",title="Managing discovery templates"!

To add a new discovery template, click the "Add" hyperlink in the top right corner. A new screen will be displayed, similar to the following:

Figure: New Discovery Templates
!bookshelf_cacti_10.gif|align=left|hspace=5px!
Figure: New discovery templates
!bookshelf_cacti_10.gif|alt="New discovery templates",title="New discovery templates"!

As can be seen, this dialog allows you to specify the host template to use, the version of SNMP to assign to the resulting device definition, and the matching string to be compared against the SNMP system information string. Once you are finished setting the discovery template details, click the "create" button in the bottom right corner. The next time the discovery process runs, the discovered devices will be compared against the new template. If any matches are detected, the matching device will be added to Cacti, using the specified device template.
To apply thresholds to an existing data source, click on the "Data Sources" menu item in the left navigation bar, locate the data source that you want to modify, and click on the hyperlinked "Template Name" column item on the right of the row. If the threshold plugin has been configured properly, a new screen will be displayed with information about the specific data source, followed by a large thresholds form similar to the following:

Figure: Applying Tthresholds
!bookshelf_cacti_11.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_11.gif|alt="Applying thresholds",title="Applying thresholds"!

As can be seen, this dialog allows you to specify the high and low marks to use, information related to automatic baselining, and some options that are derived from the global preferences. Once you are finished setting the threshold details, click the "save" button in the bottom right corner, and the screen will be reloaded with the specified details. The next time the threshold process runs, all of the data sources with defined thresholds will be examined for their high and low values, with alert notifications being sent out for every network resource that meets the specified criteria.
As an alternative to defining thresholds on a one-by-one basis, you can also define a threshold template which can then be applied to a device entry, with thresholds being automatically created for the matching data sources. Threshold templates are managed by clicking on the "Threshold Templates" menu item in the left navigation bar. A new screen will be displayed that lists all of the defined threshold templates, similar to the following (the default screen will be empty, since no threshold templates are defined by default):

Figure: Threshold Ttemplates
!bookshelf_cacti_12.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_12.gif|alt="Threshold templates",title="Threshold templates"!

To create a new threshold template, click the "Add" hyperlink in the top right corner. A walk-through wizard will be displayed that allows you to specify the data source template and the data field within that template which should be used for triggering high and low threshold values. After you have made your choices, a large thresholds form will be displayed similar to the one shown above. Once you are finished setting the threshold template details, click the "save" button in the bottom right corner, and you will be returned to the main templates list screen.

Figure: Managing Weathermaps
!bookshelf_cacti_13.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_13.gif|alt="Managing Weathermaps",title="Managing Weathermaps"!

From this screen, you can choose which of the map files that you want to make visible to Cacti users. To add a new map file, click the "Add" hyperlink in the upper right corner of the screen. A new screen will be displayed which allows you to choose a map configuration file, similar to the following:

Figure: Selecting Mmaps
!bookshelf_cacti_14.gif|hspace=5px|align=left,border=1!
!bookshelf_cacti_14.gif|alt="Selecting maps",title="Selecting maps"!

Click the "Add" hyperlink next to a map to add that map to the Cacti plugin. You will then be returned to the main weathermap management page.