mirror of
https://github.com/Cacti/documentation.git
synced 2026-10-23 03:26:44 +09:00
Thomas Vincent
57b8088e13
* 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>
126 lines
4.8 KiB
Markdown
126 lines
4.8 KiB
Markdown
# Visual Settings
|
|
|
|
## Overview
|
|
|
|
Cacti's Visual settings page is where you can go to globally control the
|
|
behavior of Cacti's GUI. Settings like the default Theme, the maximum allowed
|
|
size of a Graph Title, auto-complete settings, as well as a myriad of other
|
|
settings can be found here.
|
|
|
|
The Visual page is broken down into several sub-sections. We will cover them and
|
|
the meaning of the various settings here.
|
|
|
|
> **NOTE**: This is a popular page for Plugin developers to augment. Therefore,
|
|
> if you have installed Plugins, your Settings page may look different than the
|
|
> default page.
|
|
|
|
## Theme, Table, Tree, and Filter Settings
|
|
|
|
The image below shows the default layout for these sub-sections.
|
|
|
|
|
|
|
|
Those settings include:
|
|
|
|
- **Theme** - The default theme that users logging into Cacti receive
|
|
|
|
- **Rows Per Page** - For all standard Cacti tables, the number of rows to show
|
|
per page.
|
|
|
|
- **Auto-complete Enabled** - Many drop-downs do not scale well with thousands
|
|
of items. In those cases, Cacti has enabled a drop-down auto-complete feature
|
|
most large installs should leverage it. However, if you are a small install
|
|
you can choose to disable auto-complete.
|
|
|
|
- **Auto-complete Rows** - The maximum rows to show in an auto-complete
|
|
response.
|
|
|
|
- **Minimum Tree Width** - The minimum width of the Tree panel in Cacti
|
|
|
|
- **Maximum Tree Width** - The maximum width of the Tree panel in Cacti. Above
|
|
this width, tree items will scroll into the panel.
|
|
|
|
- **Strip Domains from Device Drop-downs** - Strip domain names from Device
|
|
drop-downs to save horizontal filter space.
|
|
|
|
## Graph, Data Source, Data Query, Log Settings
|
|
|
|
The image below shows the default layout for these sub-sections.
|
|
|
|
|
|
|
|
Those settings include:
|
|
|
|
- **Maximum Title Length** - The maximum length of a Graph or Data Source title.
|
|
Titles above this length will be clipped.
|
|
|
|
- **Data Source Field Length** - When applying |query\_\*| replacement values,
|
|
the maximum supported length of those variables. Variables longer than this
|
|
will be clipped.
|
|
|
|
- **Default Graph Type** - When on the **New Graphs** page, which **Graph Type**
|
|
filter should be the default. With **Device Templates** with many **Data
|
|
Queries** or **Graph Templates**, this page can become very long. Allowing you
|
|
to select your preferred **Graph Type** makes navigating the page easier.
|
|
|
|
- **Default Log Tail Lines** - When viewing the Cacti Log, how many lines should
|
|
appear per page.
|
|
|
|
- **Maximum number of rows per page** - The maximum number of regular expression
|
|
search matches to display, when searching.
|
|
|
|
- **Log Tail Refresh** - The frequency that the log pages should auto-refresh.
|
|
|
|
- **Exclusion Reg-ex** - This setting allows you to exclude certain log messages
|
|
by regular expression from normal users. Expressions that include login log
|
|
entries are common here to mask the login accounts of users.
|
|
|
|
## Realtime and RRDtool Graph Options
|
|
|
|
The image below shows the default layout for these sub-sections.
|
|
|
|
|
|
|
|
Those settings include:
|
|
|
|
- **Enable Real-time Graphing** - Allow Realtime graphs to be used in Cacti.
|
|
|
|
- **Graph Time-span** - The default system level `Graph Timespan` to use when a
|
|
user opens a Realtime **Graph** for the first time.
|
|
|
|
- **Refresh Interval** - The default system level `Refresh Interval` for the
|
|
Realtime interface when a user first opens a Realtime **Graph**.
|
|
|
|
- **Cacti Directory** - Where should Cacti cache Realtime PNG's and RRDfiles.
|
|
|
|
- **Custom Watermark** - A watermark that will appear on every Cacti **Graph**
|
|
|
|
- **Disable RRDtool Watermark** - Every RRDtool Graph includes a vertical
|
|
watermark. This option allows you to disable that.
|
|
|
|
- **Font Selection Method** - This allows the system administrator to control,
|
|
at a global level, how various text elements on RRDtool **Graphs** appear. The
|
|
settings include: Theme, or System. When choosing `System`, your settings page
|
|
will expand where you will then have additional control.
|
|
|
|
> **NOTE**: The RRDtool Watermark control requires a recent version of RRDtool,
|
|
> such as the 1.7 release. If you attempt to use this setting and your
|
|
> **Graphs** break, then upgrade RRDtool.
|
|
|
|
## Font Selection Options
|
|
|
|
The image below shows the available Font Selection options when you override the
|
|
Theme settings.
|
|
|
|
|
|
|
|
The sizes are in pixels, and the Font Settings can either be a True Type Font
|
|
file path, or a valid Pango font-config value. For more information on Pango
|
|
font-config values, see your operating systems documentation. However, you can
|
|
normally see all the fonts installed on your Linux system by issuing the
|
|
following command `fc-list`.
|
|
|
|
---
|
|
|
|
Copyright (c) 2004-2026 The Cacti Group
|