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>
76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
# The Cacti Log Interface
|
|
|
|
## Summary
|
|
|
|
The Cacti Log is where all Cacti statistics, warnings, errors and other log
|
|
messages are sent. Cacti can optionally log some information to your syslog or
|
|
event log
|
|
depending on your OS type.
|
|
|
|
The Cacti Log is by default ordered from newest event to oldest event, and
|
|
the Cacti Log is rotated by Cacti itself once a day.
|
|
|
|
If you have the User Level permission, you can view any available Cacti Standard
|
|
Output or Standard Error log. If you have the Administrative level access,
|
|
you may additionally purge information from the logs.
|
|
|
|
As a Cacti Administrator, you have the ability to filter out some message types
|
|
from users for example, one message type that people like to filter out is
|
|
"AUTH" messages that tell you who is logging into the Cacti Web Site.
|
|
You can edit these removal rules from the Cacti Settings page.
|
|
|
|
An image of the Cacti Log file can be seen below.
|
|
|
|
|
|
|
|
## Cacti Log Filters
|
|
|
|
What we like to see in the Cacti Log is a lot of Green, which means good. By
|
|
default,
|
|
WARNINGS are yellow, and ERRORS are red. But there are other types of messages
|
|
that highlight differently. Generally, you can filter for these message types.
|
|
The filters include:
|
|
|
|
- **File** - The Cacti Log file to view. Rotated files are suffixed with the
|
|
date they were rotated, using the pattern YYYY-MM-DD.
|
|
- **Tail Lines** - The number of lines to view from the selected Cacti Log.
|
|
- **Types** - The message types to view. These will be explained below.
|
|
- **Display Order** - The order to display the Log lines, either *Newest First*
|
|
or *Oldest First*.
|
|
- **Refresh** - How often to Auto-refresh the interface.
|
|
- **Search** - A Perl compatible regular expression to search the log with.
|
|
|
|
The Cacti Log **Types** include the following:
|
|
|
|
- **Stats** - Anything that includes the word **STATS**
|
|
- **Warnings** - Anything that includes the word **WARNING**
|
|
- **Warnings++** - Anything of each **WARNING**, **ERROR**, **DEBUG**, and
|
|
**SQL**. This one is good for debugging, and it includes the errors that
|
|
matter most to the Cacti Administrator.
|
|
|
|
- **Errors** - Anything that includes the word **ERROR**
|
|
- **Errors++** - Anything of each **ERROR**, **DEBUG**, and **SQL**
|
|
- **Debug** - Anything that includes the word **DEBUG**
|
|
- **SQL Calls** - Anything that includes the word **SQL**
|
|
- **AutoM8** - Anything that includes the word **AUTOM8**. These messages come
|
|
from Cacti automation of Devices, Graphs, and Trees
|
|
- **Non Stats** - Anything that does not include the word **STATS**.
|
|
- **Boost** - Anything that contains the word **BOOST**.
|
|
- **Device Up/Down** - Any device Up/Down notification, including those that
|
|
come from the *Thold* or *Monitor* plugins.
|
|
- **Recaches** - Any Device Recache Events.
|
|
- **Security Issues** - Added in Cacti 1.3. Anything logged by Cacti's
|
|
security auditing.
|
|
- **Threshold** - If the *Thold* plugin is installed, any of its threshold
|
|
breach and restoration events.
|
|
|
|
## Differences between User and Administrative Views
|
|
|
|
As previously mentioned, the Cacti log has two permission levels,
|
|
the User Permission level will not include the *Purge* button,
|
|
and can have some information hidden from public view
|
|
whereas the Administrative view includes all Log messages and a *Purge* button.
|
|
|
|
---
|
|
Copyright (c) 2004-2026 The Cacti Group
|