v1.8.2

Release Notes

Maintenance release addressing the issues below and two nice feature enhancements.

ChangeLog

--- 1.8.2 ---

• issue#682: Setting.php thold_notification_delay field does not have 'description' key
• issue#673: Device up/down notification emails don't appear to be sent if the notification queue is enabled
• issue#674: Thold Current Value is incorrect in 1.8.1
• issue#678: Unable to remove suspended notifications one by one
• issue#679: The PHP Mailer does not allow for the to and bcc addresses to be the same
• issue#698: Add missing thread id to polling process
• issue#700: PHP8.x issue - addition a non-numeric value
• issue#701: Site filter on notification list doesn't work
• issue#703: Fix sorting column links
• issue#704: Fix change thold log message - missing information about email addresses
• feature#677: Allow the Administrator to create a default Single Email Notification Subject
• feature#696: Extend email replacement (location, site, ...) for subject and email body

v1.8.1

Minor release to address compatibility issues with Cacti 1.3, and issue with creating Thold Templates, and updating the Cacti Translations from Microsoft Translator and poedit.

ChangeLog

--- 1.8.1 ---

• issue#669: Thold Graph tab subtab 'Device Status' complains about duplicate column in Cacti develop
• issue#670: Cannot create new Thold Template
• feature: Complete translations of Thold to 23 languages

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

v1.5.2

Minor update release to address recently reported bugs.

--- 1.5.2 ---

issue#457: Page show blank if do export function without log info exist

issue#458: The indicator is not removed upon completion when do export function

issue#459: Background color looks ugly for availability column. Table not aligned well.

issue#460: Filter result for template none incorrect

v1.5.1

Release to add missing columns from the upgrade/install script.

v1.5

Fairly comprehensive BugFix release. Still missing a large list of Notification, Baseline, and Aggregate Graph fixes and enhancements. ChangeLog below.

--- 1.5 ---

• issue#187: Standalone Thresholds created do not read graph data due to threshold daemon not running
• issue#225: Customize Thold Restore message
• issue#304: Warn Cacti Administrator if the Thold Daemon is Down
• issue#366: When a value is undefined, Thresholds are no longer triggering when minimum is zero
• issue#372: Thold plugin execute a script each time device state changes? v2
• issue#376: Question - Variables to use when sending a command
• issue#402: Notification Lists should support searching via RegEx
• issue#412: Can not trigger thold command cause there is a Enter Key at the end
• issue#417: zero 'lastread' value incorrectly processed by thold_check_threshold()
• issue#418: Errors during Thold upgrade to v1.4
• issue#422: Apply Cacti#3191 for XSS exposure (CVE-2020-7106)
• issue#429: Add new per host config thold_failure_count
• issue#430: XSS Vulnerabilities if host/graph name include script
• issue#431: SQL Syntax Determining Failed Devices
• issue#433: ERROR PHP WARNING in Plugin 'thold': Use of undefined constant LOG_VERBOSITY_MEDIUM
• issue#441: Thold 1.4 + cacti 1.2.14 - Classic Theme - Unable to Create Thresholds
• issue#442: THOLD daemon should not log errors on interruption/termination by user
• issue#443: Add support for upper + lower bytes calculation
• issue#444: PHP bug - Array and string offset access syntax with curly braces is deprecated
• issue#446: Threshold not triggering if CDEF is utilized
• issue#449: Notification List is not saved when adding new device
• issue#450: Thold generate wrong bandwidth alert
• issue: Function array_column() missing from PHP5.4
• issue: Unable to search for thresholds by regular expression
• issue: Percentage threholds that show horizontal rule are cut off
• feature: Migrate all Images to Fontawesome Glyphs

v1.4

--- 1.4 ---

• issue#400: Slow cli_thresholds.php Performance

• issue#405: thold_functions.php Undefined variable "polling_interval"

• issue#406: THOLD 1.3.4 no 1 minute cycle/Trigger option

• issue#407: Error php deprecated when delete any graph

• issue#409: Cannot send mail due to default From mail is invalid

• issue#410: php error when creating threshold - Undefined index: data_type

• issue#411: The newly added device In Stat value incorrect

• issue: Make notification lists aware of device removal

• issue: When Data Manipulation type is Percentage, RPN Expression column is shown

v1.3.4

--- 1.3.4 ---

• issue#404: THOLD 1.3.3 Cacti 1.2.9 PHP errors

v1.3.3

--- 1.3.3 ---

feature#359: Allow variable substitution also in UP/DOWN e-mail subject

feature#375: Enhance Thold to Export Thold Logs to csv

feature: Properly support 10, 20, and 30 second polling

feature: Add additional environment variables for scripts

issue#345: Adding an alarm threshold does not work

issue#351: Missed required param $host_id of thold_new_graphs_save() in
thold_functions.php

issue#353: Thold Wizard enables Cacti poller to remove newly created
thresholds

issue#354: Error trying to resolve Graph display values with error: Unknown
RPN type: 1

issue#355: Thold search fields do not work with some international characters

issue#356: Thold should not show the 'i' suffix for percentage type tholds

issue#358: Downtime message is only calculated when SNMP is in use

issue#361: Thresholds are not applying CDEF's correctly

issue#364: Thold 1.3.2 A non-numeric value encountered in thold_functions.php

issue#368: When using Classic Theme, devices not appearing when try to create a threshold

issue#369: When saving a template, notification lists of all
templates are updated

issue#381: Threshold Daemon Server (get rid of start script)

issue#383: Backtrace errors when first creating a thold

issue#384: Call to undefined function rrdtool_execute() in thold_functions.php:4094

issue#391: Undefined CDEF generated with latest Core / Thold versions

issue#392: Make THOLD working on 1min poller w/ 5min rrd

issue#394: THOLD shows devices that have been deleted as down

issue#395: Filtering on Ack Required field does not work

issue#401: Errors occur with invalid thresholds with a bad thold type

v1.3.2 - Minor Bug Fixing

--- 1.3.2 ---

• issue#349: Undefined variable notice when attempting to create a threshold
• issue#352: Non-numeric value error can sometimes be issued by
  thold_format_number()