v1.8

Release Notes

Well this is a release that has been a long time coming. Thold is approaching 20 years of age now. You would think we would be done with it by now, but alas no. In this release of Thold we have introduced several new features to clear up much of the backlog, but not all of it. Most notably in this release we've implemented the following:

• Notification Queue - If you Email system is slow, this is a limiting factor to Thold. So, in this release of Thold we provide a way to cache Email message and send them out of band. This allows the Thold process to have reduced impact on the Data Collection process, be it you are using the Thold Daemon or the strait integration.
• Command Execution Queue - Part of the Notification Queue is to queue up command line executions as well out of band.
• Baseline Deviation Methods - We have added several new Baseline Deviation methods including Moving Average and Time in the Past Baselines with options for each. I consider Baseline deviation now done (well I have a few more ideas anyway).
• Graph Visualization with Skip Scale Option - If you don't want to see the Horizontal rule unless it's in range, you can prevent the threshold hrule from making the Graph otherwise unreadable now.
• Notification Lists - We added a BCC now to notification lists and the addition of allowing the Format File / CSS to be set at the Notification List.
• Suffix Handling on Thold Data - Better detection of suffixes so instead of a large number, it can be display 10G or 100G
• Format File / CSS Option - You can now use Format Files in Thold!

Read the ChangeLog below for more details. This release took the efforts of several developers and testers to finalize. I would like to personally thank all those involved. You know who you are. Notably @bmfmancini and his team, @xmacan, and @ddb4github and his team for all their efforts. We had quite a bit of support from various customers along the way as well. You know who you are. Dare I call you customers? We don't make any real money doing this.

There is still another release of Thold coming once this version sees some street time. Remember, to enjoy using Cacti.

ChangeLog

--- 1.8 ---

• security: Fix potential security exposure with unserialize() function
• feature#79: Allow and correctly handle unit suffix in the context of values
• feature#135: Ability to change the subject for the threshold alert message
• feature#140: Baseline Deviation Moving Average
• feature#185: Baseline deviation with exact changes
• feature#435: Allow thold commands to be queued and run in parallel so as to not affect the polling process
• feature#445: Allow removal of Threshold from a specific device ignoring device template
• feature#471: Add ability to change failure count in change device menu
• feature#486: add ":skipscale" option to prevent diagram area from being scaled by threshold lines, thus losing granularity in the graphs
• feature#497: Show acknowledgment status on Thresholds tab instead of log
• feature#500: Re-warning cycle when alert is reached
• feature#528: Allow Thold to Use the BCC in addition to the TO line for Notification Lists
• feature#569: Provide enough data in environment of command to get Graph Information about Thold
• feature#577: Clear pending device down message queue
• feature#650: Consider Unknown Data as Zero setting not working as expected, add log setting when Unknown data to zero occurs
• feature: Allow Templates and Thresholds to include an External ID
• feature: Add Site and Location options to Device Up/Down Notifications
• feature: Add the Thold ID to the environment for scripts
• feature: Add the Thold ID to the possible replacement value for notifications
• feature: Allow quick links to the Threshold Template when editing a Thold
• feature: Have the thold daemon use the standard cacti reconnect api
• feature: Move device down detection and maintenance to a separate background thread
• feature: Allow disabling notifications for a list by simply disabling it.
• feature: Mass Enable/Disable at Template Level
• feature: Make Enabling and Disabling a Thold Different than Enabling or Disabling a Template
• feature: Support Cacti Format Files in Thresholds and Templates
• feature: Allow the specification of the Graph Timespan when editing/creating the Threshold or Template
• feature: Allow the specification of the units suffix overriding automatic the number of significant digits to display
• feature: Better validation of Threshold values to reduce human error
• feature: Validate Threshold Template values identical to normal Threshold values
• issue#147: Fixed threshold compare negative baseline values.
• issue#396: Baseline Deviation does not work (as expected)
• issue#451: Creating Threshold from Template Missing from Graph Page
• issue#454: Unite last thold value and ds value
• issue#470: Device failure count setting not respected
• issue#487: If Dead Host Notification is disabled, prune the dead host table
• issue#489: A non-numeric value encountered in thold_functions.php on line 3223
• issue#514: When saving a thold template, tholds disassociated from their template are re-templated and re-enabled
• issue#516: The Default Monitor Status setting belongs in the Monitor plugin. Remove from Thold
• issue#535: Support new uptime calculation in Cacti 1.2.19
• issue#540: Change table name from 'plugin_thold_device_template' to 'plugin_thold_host_template' for Pre-1.0 upgrade
• issue#542: Thold uses hardcoded from adress insted of db one
• issue#549: Thold 1.6 breaks on bandwidth utilization
• issue#551: Cacti monitor rate different the threshold read
• issue#555: CMDPHP ERRORS DETECTED - DISABLING PLUGIN 'thold'
• issue#558: Thold entry displayed moretimes
• issue#562: Thold shows big numbers for bandwidth percentage CDEF (or RPN)
• issue#566: Device Notification Options: Subject editing with tags () not showing
• issue#574: Wrong href after click Auto-create Thresholds
• issue#575: Getting Errors in Cacti Log Frequently with Cacti 1.3.0 develop
• issue#578: Default setting for Threshold Up/Down Email Notification
• issue#582: Baseline deviation tholds generate warnings about alert email
• issue#583: Plugin Thold shows the current value as 0 after executing CDEF
• issue#584: Thold device uptime check still checks uptime when availability method is 0 and snmp_version is > 0
• issue#585: The return Web page is wrong after clicking the "return" button in the "edit threshold"
• issue#586: Attempting to edit a non-existing thold template results in plugin being disabled
• issue#660: data_template_hash is wrongly empty after import thold template by CLI
• issue#664: Inconsistent counts in thold tab and management -> thresholds
• issue#666: Thresholds should breach at or above, or at or below a value not below or above
• issue: Fix issues associated with PHP8.1.2 on transactions. By default Cacti uses autocommit, so don't use them.
• issue: Fix issues where thold daemon could possibly loose events due to an array chunking issue identified through PHP8.1.2 testing.
• issue: Fix potential divide by zero errors with an empty baseu
• issue: Fix undefined function reports_load_format_file
• issue: Fix table columns bi_reference_* values
• issue: Make sure if a device is in maintenance, that notifications are not set

--- 1.6.0 ---

• feature: Enhance thold daemon to work more efficiently
• feature: Auto Enable the thold daemon on startup
• feature: Keep track of running daemon processes and scale up/down automatically
• feature: Make the thold daemon process/thread counter a dropdown
• feature: Make the thold daemon children processes persistent
• feature: Make the thold daemon properly pause in cases where the database is offline
• feature: Properly execute signal handling from the parent to the children processes
• feature: Implement thold daemon debugging from the settings page
• feature: Properly implement thold_error_handler
• issue#515: Security[CSRF]: thold.php use the value of the "Referer" header without validation
• issue#517: notification list page formatting not correct
• issue#520: When applying threshold from Devices Page they are not applied.
• issue#522: Incorrect variable name for threshold
• issue#523: Fix misspelled SQL statement
• issue#525: Thold Daemon improperly adjust the thold by it's cdef twice
• issue#527: When removing a threshold, thold should remove daemon data related to it
• issue#529: Undefined index: thold_name in thold_functions.php on line: 3412
• issue#533: thold_data table missed two indexes for fresh installation
• issue#534: CLI template importing output escaped template name

--- 1.5.3 ---

• issue#463: php error - undefined index dnotes
• issue#467: The thold cdef processing function does not handle non-numeric data correctly
• issue#474: Create threshold from templates fail with multiple data template ids
• issue#482: Thold and Thold Template missing Tab in Help
• issue#492: Thold search filter does not work from Console > Management > Thresholds
• issue#495: THOLD ERROR: RPN Expression is invalid!
• issue#496: Aacknowledgement text does not visible but shows up when you refresh
• issue#498: Return button in Thold templates is broken
• issue#499: In Thold Tab > Device status > ID of device reported simply as 1K if number is above 1023
• feature#469: use thold template name as filename for single export
• feature#481: SNMP event description can be defined individually or template based.
• issue#510: Searching in Notify lists doesnt filter result
• issue#511: Fix missing variable validation