Files
Cactidocumentation/Device-Templates.md
Thomas Vincent 57b8088e13 docs: comprehensive validation audit, Spine poller overhaul, and technical refactor (#229)
* docs: comprehensive audit, Spine poller overhaul, and technical refactor

- Overhaul Spine documentation (Spine.md) with complete end-to-end guide: architecture, prerequisites for modern distros (EL8/9 CRB, Ubuntu 22/24, Debian 11/12, FreeBSD), SUID root permissions, secure spine.conf setup (0640), Web UI configuration (Paths, Poller type, Data Collectors tuning), MySQL max_connections sizing, and troubleshooting.
- Fix broken links and anchors (Hardening, SNMP data queries, Hook API references).
- Fix broken image reference in Sites.md (add-site.JPG -> add-site.png).
- Fix syntax errors in documentation PHP code blocks, including invalid parenthesization, missing SQL execute quotes, and malformed comments in FAQ.
- Fix DevOps installation commands: use config.php.dist, correct systemctl service names for MySQL/MariaDB/PHP-FPM, remove nonexistent php-json, add missing composer install, and correct Debian/Ubuntu systemd environment path.
- Correct grammatical errors, repeated words, and typos across all markdown documents.
- Remove obsolete unreferenced duplicate installation guides.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct reviewed examples and guidance

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct guidance that disagrees with the Cacti source

Verified each claim against include/global_arrays.php, lib/auth.php,
lib/functions.php, host_templates.php and the Spine config parser. The
notable ones: api_plugin_safe_exec() does not exist on either branch,
Spine reads DB_Pass rather than DB_Password, and the CDEF special data
source table was missing five entries and renamed four others.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: wrap Spine prose and fence the connection sizing formula

The formula's bare asterisks rendered as emphasis, dropping the multiplication signs.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* chore: refresh copyright year in scripts and issue templates

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

---------

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
2026-09-08 09:41:21 -04:00

2.6 KiB

Device Templates

Device Templates are Cacti objects that allow you to define classes of Devices that include one or more Graph Templates, Data Queries and other Plugin related object types.

The purpose of Device Templates is to simplify the Automation process by pre-defining the Graphs that should be created for every Device that is added to Cacti. They work in conjunction with Automation Templates so that when Cacti discovers a Network it knows what Graphs to create for each Device.

The Device Templates main screen looks like the image below:

Device Templates Page

From this page, you can see the title of each Device Template, and its ID, which is important for the Cacti CLI scripts. You can see if the Device Template can be removed, and the number of Devices using the Device Template. Templates that are used by Devices can not be removed and therefore if you attempt to remove one of these Templates, you will receive an error message.

From the drop down there are the following options:

Option Description
Delete Remove the Device Template if it's Deletable
Duplicate Make an exact copy of the Device Template.
Sync Devices Update all Devices using this Device Template with the latest definition, adding, but not removing Graph Templates, and Data Queries.
Archive Store a copy of the current Device Template definition with an optional Archive Note. Archives are listed on the Archives tab of the same page.
Download Download the Device Template as a Cacti Package.

Archive and Download were added in Cacti 1.3; Cacti 1.2.x offers only the first three options. They appear only once the package signing keys exist, which cli/genkey.php creates.

When editing a Device Template, you will see the page as displayed below. From this page, you can add and remove Graph Templates, Data Queries, and other Plugin objects. In the image below, you can see that the Cisco Router has one Graph Template, Cisco - CPU Usage, and one Data Query, SNMP - Interface Statistics. There are no Threshold Templates defined on the system, so there is no way to select one.

Device Template Edit Page

To add a Graph Template or Data Query to the Device Template, simply select it from the drop down, and press the Add button. There is no need to Save afterwards. To remove one of these items, simply press the x glyph to the right of the desired Graph Template or Data Query.


Copyright (c) 2004-2026 The Cacti Group