From a7991dc6cf88cfe7fcb6432ba17198f65968f30b Mon Sep 17 00:00:00 2001 From: TheWitness Date: Mon, 16 Jun 2025 09:26:09 -0400 Subject: [PATCH] QA: Update Copyrights to 2025 --- .github/ISSUE_TEMPLATE/bug_report.md | 2 +- .github/ISSUE_TEMPLATE/feature_request.md | 2 +- .gitignore | 2 +- .mdl_style.rb | 2 +- .mdlrc | 2 +- CACTI-THOLD-MIB | 1100 ++++++++++----------- CHANGELOG.md | 2 +- INFO | 2 +- README.md | 2 +- cli_import.php | 2 +- cli_thresholds.php | 2 +- extras/apply_realms.php | 2 +- extras/index.php | 2 +- extras/upgrade.php | 2 +- images/index.php | 2 +- includes/arrays.php | 2 +- includes/database.php | 2 +- includes/index.php | 2 +- includes/polling.php | 2 +- includes/settings.php | 2 +- includes/tab.php | 2 +- index.php | 2 +- locales/LC_MESSAGES/index.php | 2 +- locales/build_gettext.sh | 2 +- locales/index.php | 2 +- locales/po/index.php | 2 +- notify_lists.php | 2 +- notify_queue.php | 2 +- poller_thold.php | 2 +- service/README.md | 2 +- service/index.php | 2 +- service/systemd/index.php | 2 +- service/systemd/thold_daemon.service | 2 +- setup.php | 2 +- themes/classic/index.php | 2 +- themes/classic/main.css | 2 +- themes/dark/index.php | 2 +- themes/dark/main.css | 2 +- themes/index.php | 2 +- themes/midwinter/main.css | 2 +- themes/modern/index.php | 2 +- themes/modern/main.css | 2 +- themes/paper-plane/index.php | 2 +- themes/paper-plane/main.css | 2 +- themes/paw/index.php | 2 +- themes/paw/main.css | 2 +- themes/sunrise/index.php | 2 +- themes/sunrise/main.css | 2 +- thold.php | 2 +- thold_daemon.php | 2 +- thold_functions.php | 2 +- thold_graph.php | 2 +- thold_notify.php | 2 +- thold_process.php | 2 +- thold_templates.php | 2 +- thold_webapi.php | 2 +- 56 files changed, 605 insertions(+), 605 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 1c23f9c..fc1d562 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -8,7 +8,7 @@ assignees: '' --- diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md index c508021..df1ecf6 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ b/.github/ISSUE_TEMPLATE/feature_request.md @@ -8,7 +8,7 @@ assignees: '' --- diff --git a/.gitignore b/.gitignore index ce70e5d..eb71606 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,5 @@ # +-------------------------------------------------------------------------+ -# | Copyright (C) 2004-2023 The Cacti Group | +# | Copyright (C) 2004-2025 The Cacti Group | # | | # | This program is free software; you can redistribute it and/or | # | modify it under the terms of the GNU General Public License | diff --git a/.mdl_style.rb b/.mdl_style.rb index 17ad7fe..10f5cdd 100644 --- a/.mdl_style.rb +++ b/.mdl_style.rb @@ -1,5 +1,5 @@ # +-------------------------------------------------------------------------+ -# | Copyright (C) 2004-2023 The Cacti Group | +# | Copyright (C) 2004-2025 The Cacti Group | # | | # | This program is free software; you can redistribute it and/or | # | modify it under the terms of the GNU General Public License | diff --git a/.mdlrc b/.mdlrc index 3bec0e4..42c9b1d 100644 --- a/.mdlrc +++ b/.mdlrc @@ -1,5 +1,5 @@ # +-------------------------------------------------------------------------+ -# | Copyright (C) 2004-2023 The Cacti Group | +# | Copyright (C) 2004-2025 The Cacti Group | # | | # | This program is free software; you can redistribute it and/or | # | modify it under the terms of the GNU General Public License | diff --git a/CACTI-THOLD-MIB b/CACTI-THOLD-MIB index 4eca8e8..8ed773a 100644 --- a/CACTI-THOLD-MIB +++ b/CACTI-THOLD-MIB @@ -1,551 +1,551 @@ --- ***************************************************************** --- CACTI-THOLD-MIB: Thold Management Information Base for Cacti --- --- September 2013, Andreas Braun (aka browniebraun) --- --- Copyright (c) 2004-2023 by The Cacti Group --- All rights reserved. --- --- ***************************************************************** - -CACTI-THOLD-MIB DEFINITIONS ::= BEGIN - -IMPORTS - OBJECT-TYPE, - MODULE-IDENTITY, - OBJECT-IDENTITY, - NOTIFICATION-TYPE, - Integer32, - IpAddress - FROM SNMPv2-SMI - - OBJECT-GROUP, - NOTIFICATION-GROUP - FROM SNMPv2-CONF - - TEXTUAL-CONVENTION, - DisplayString - FROM SNMPv2-TC - - cactiPlugins - FROM CACTI-MIB -; - -thold MODULE-IDENTITY - LAST-UPDATED "201309260000Z" - ORGANIZATION "The Cacti Group" - CONTACT-INFO - "The Cacti Group - - E-mail: developers@cacti.net" - DESCRIPTION - "This modules defines a MIB for THOLD, a threshold - monitoring plugin for Cacti." - REVISION "201309260000Z" - DESCRIPTION - "Initial version of this MIB module." - ::= { cactiPlugins 1 } -- assigned by the Cacti Group - --- --- TEXTUAL CONVENTIONS --- - --- --- Event Class --- - -TcEventClass ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "Represents the classification of an event: - - info - threshold item is in normal state - warning - warning condition fulfilled - alert - alerting condition fulfilled " - SYNTAX INTEGER - { - info(1), - warning(2), - alert(3) - } - --- --- Event Severity --- - -TcEventSeverity ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "The following are the severities an THOLD event - can have: - - low - informational event, - event with low impact - medium - warning event, - event with medium impact - high - warning event or alert event, - event with high impact - critical - alert event, - event with critical impact " - SYNTAX INTEGER - { - low(1), - medium(2), - high(3), - critical(4) - } - --- --- Event Threshold Type --- - -TcEventThresholdType ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "The monitoring type used to verify a threshold - condition: - - highLow - Monitoring if the current value was below a - specific upper and above a specific lower limit - baseline - Monitoring based on deviation in percentage - for the upper and lower bound threshold against a - time reference in the past - timebased - Monitoring if a breach condition was given for a - specific number of times within a specific amount of time - in the past " - SYNTAX INTEGER - { - highLow(1), - baseline(2), - timebased(3) - } - --- --- Event Notification Type --- - -TcEventNotificationType ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "Describes the several conditions detected by THOLD - which will end in a notification / alert: - - restoral - not available (restoral) - triggera - not available (trigger alert) - notifyra - Notify Alert Retrigger - notifywa - Notify Warning - notifyal - Notify Alert - notifyrs - Notify Restoral - triggerw - not available (trigger warning) - notifyaw - Notify Restoral to Warning: - This occurs if conditions for an alert state are no - longer breached, but the thresholds for a warning state - are still exceeded. " - SYNTAX INTEGER - { - restoral(1), - triggera(2), - notifyra(3), - notifywa(4), - notifyal(5), - notifyrs(6), - triggerw(7), - notifyaw(8) - } - --- --- Event Status --- - -TcEventStatus ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "Represents the state of a threshold: - - normal - Threshold has not been exceeded - low - Lower threshold condition breached - high - Upper threshold condition breached " - SYNTAX INTEGER - { - normal(1), - low(2), - high(3) - } - --- --- Event Re-Alert Status --- - -TcEventRealertStatus ::= TEXTUAL-CONVENTION - STATUS current - DESCRIPTION - "Represents the long-term state of a threshold: - - normal - Threshold has not been exceeded - low - Lower threshold condition still breached - high - Upper threshold condition still breached " - SYNTAX INTEGER - { - normal(1), - low(2), - high(3) - } - --- --- THOLD APPLICATION DATA --- -tholdAppl OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for Thold application data" - ::= { thold 1 } - --- --- THOLD Statistics --- -tholdStats OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for statistics" - ::= { thold 2 } - --- --- THOLD Events --- -tholdEvents OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for events" - ::= { thold 3 } - -tholdEventObjects OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for event attributes" - ::= { tholdEvents 1 } - -eventDateRFC822 OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..48)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "The current date/time of when the event was detected by Thold." - ::= { tholdEventObjects 1 } - -eventClass OBJECT-TYPE - SYNTAX TcEventClass - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Represents the classification of an event: - - info - threshold item is in normal state - warning - warning condition fulfilled - alert - alerting condition fulfilled " - DEFVAL { alert } - ::= { tholdEventObjects 2 } - -eventSeverity OBJECT-TYPE - SYNTAX TcEventSeverity - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "The following are the severities an THOLD event - can have: - - low - informational event, - event with low impact - medium - warning event, - event with medium impact - high - warning event or alert event, - event with high impact - critical - alert event, - event with critical impact " - DEFVAL { high } - ::= { tholdEventObjects 3 } - -eventCategory OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "To allow a NMS to categorize different SNMP traps THOLD SNMP traps - this object can be used to define a custom category - like 'disk_usage', 'link_utilization' or 'ping_test'." - DEFVAL { "" } - ::= { tholdEventObjects 4 } - -eventSource OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Contains the threshold name to identify the threshold (source) - generating this event." - DEFVAL { "" } - ::= { tholdEventObjects 5 } - -eventDescription OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..1000)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Contains a customized event description." - DEFVAL { "Threshold exceeded" } - ::= { tholdEventObjects 6 } - -eventDevice OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "This item describes the device name this event is related to." - DEFVAL { "" } - ::= { tholdEventObjects 7 } - -eventDeviceIp OBJECT-TYPE - SYNTAX IpAddress - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "IPv4 address of the device the event is related to." - DEFVAL { "0.0.0.0" } - ::= { tholdEventObjects 8 } - -eventDataSource OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Identifies the rrd data source being used for this threshold - monitor." - DEFVAL { "" } - ::= { tholdEventObjects 9 } - -eventCurrentValue OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "The current value of the data source that caused this event." - DEFVAL { "" } - ::= { tholdEventObjects 10 } - -eventHigh OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "In relation to eventClass this object describes the upper - limit for a warning or an alerting condition. - If eventCurrentValue is higher than this upper limit - an event will be triggered" - DEFVAL { "" } - ::= { tholdEventObjects 11 } - -eventLow OBJECT-TYPE - SYNTAX DisplayString (SIZE(1..255)) - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "In relation to eventClass this object describes the lower - limit for a warning or an alerting condition. - If eventCurrentValue is below this limit an event will - be triggered" - DEFVAL { "" } - ::= { tholdEventObjects 12 } - -eventThresholdType OBJECT-TYPE - SYNTAX TcEventThresholdType - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "The monitoring type used to verify a threshold - condition: - - highLow - Monitoring if the current value was below a - specific upper and above a specific lower limit - baseline - Monitoring based on deviation in percentage - for the upper and lower bound threshold against a - time reference in the past - timebased - Monitoring if a breach condition was given for a - specific number of times within a specific amount of time - in the past " - DEFVAL { baseline } - ::= { tholdEventObjects 13 } - -eventNotificationType OBJECT-TYPE - SYNTAX TcEventNotificationType - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Describes the several conditions detected by THOLD - which will end in a notification / alert: - - restoral - not available (restoral) - triggera - not available (trigger alert) - notifyra - Notify Alert Retrigger - notifywa - Notify Warning - notifyal - Notify Alert - notifyrs - Notify Restoral - triggerw - not available (trigger warning) - notifyaw - Notify Restoral to Warning: - This occurs if conditions for an alert state are no - longer breached, but the thresholds for a warning state - are still exceeded. " - DEFVAL { notifyal } - ::= { tholdEventObjects 14 } - -eventStatus OBJECT-TYPE - SYNTAX TcEventStatus - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Represents the state of a threshold: - - normal - Threshold has not been exceeded - low - Lower threshold condition breached - high - Upper threshold condition breached " - DEFVAL { high } - ::= { tholdEventObjects 15 } - -eventRealertStatus OBJECT-TYPE - SYNTAX TcEventRealertStatus - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Represents the long-term state of a threshold: - - normal - Threshold has not been exceeded - low - Lower threshold condition still breached - high - Upper threshold condition still breached " - DEFVAL { normal } - ::= { tholdEventObjects 16 } - -eventFailDuration OBJECT-TYPE - SYNTAX Integer32 - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Describes the amount of time in seconds the data source - is in a breach condition." - DEFVAL { 0 } - ::= { tholdEventObjects 17 } - -eventFailCount OBJECT-TYPE - SYNTAX Integer32 - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Describes the number of times the data source - is in a breach condition." - DEFVAL { 0 } - ::= { tholdEventObjects 18 } - -eventFailDurationTrigger OBJECT-TYPE - SYNTAX Integer32 - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Describes the amount of time in seconds the data source - must be in a breach condition for an alert or warning - to be raised. " - DEFVAL { 0 } - ::= { tholdEventObjects 19} - -eventFailCountTrigger OBJECT-TYPE - SYNTAX Integer32 - MAX-ACCESS accessible-for-notify - STATUS current - DESCRIPTION - "Describes the number of times the data source - must be in a breach condition for an alert or warning - to be raised. " - DEFVAL { 0 } - ::= { tholdEventObjects 20 } - --- --- THOLD Event Notifications --- -tholdEventNotifications OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for event attributes" - ::= { tholdEvents 2 } - -tholdNotify NOTIFICATION-TYPE - OBJECTS { - eventDateRFC822, - eventClass, - eventSeverity, - eventCategory, - eventSource, - eventDescription, - eventDevice, - eventDeviceIp, - eventDataSource, - eventCurrentValue, - eventHigh, - eventLow, - eventThresholdType, - eventNotificationType, - eventStatus, - eventRealertStatus, - eventFailDuration, - eventFailCount, - eventFailDurationTrigger, - eventFailCountTrigger - } - STATUS current - DESCRIPTION - "The SNMP trap that is generated as a result of an event with Thold." - ::= { tholdEventNotifications 1 } - --- --- THOLD MIB Groups --- -tholdMibGroups OBJECT-IDENTITY - STATUS current - DESCRIPTION - "reserved for group definitions" - ::= { thold 4 } - -tholdEventGroup OBJECT-GROUP - OBJECTS { - eventDateRFC822, - eventClass, - eventSeverity, - eventCategory, - eventSource, - eventDescription, - eventDevice, - eventDeviceIp, - eventDataSource, - eventCurrentValue, - eventHigh, - eventLow, - eventThresholdType, - eventNotificationType, - eventStatus, - eventRealertStatus, - eventFailDuration, - eventFailCount, - eventFailDurationTrigger, - eventFailCountTrigger - } - STATUS current - DESCRIPTION - "A collection of objects providing the THOLD event - defaults." - ::= { tholdMibGroups 1 } - -tholdNotifyGroup NOTIFICATION-GROUP - NOTIFICATIONS { - tholdNotify - } - STATUS current - DESCRIPTION - "The notifications relating to the monitoring operation of Thold." - ::= { tholdMibGroups 2 } - +-- ***************************************************************** +-- CACTI-THOLD-MIB: Thold Management Information Base for Cacti +-- +-- September 2013, Andreas Braun (aka browniebraun) +-- +-- Copyright (c) 2004-2025 by The Cacti Group +-- All rights reserved. +-- +-- ***************************************************************** + +CACTI-THOLD-MIB DEFINITIONS ::= BEGIN + +IMPORTS + OBJECT-TYPE, + MODULE-IDENTITY, + OBJECT-IDENTITY, + NOTIFICATION-TYPE, + Integer32, + IpAddress + FROM SNMPv2-SMI + + OBJECT-GROUP, + NOTIFICATION-GROUP + FROM SNMPv2-CONF + + TEXTUAL-CONVENTION, + DisplayString + FROM SNMPv2-TC + + cactiPlugins + FROM CACTI-MIB +; + +thold MODULE-IDENTITY + LAST-UPDATED "201309260000Z" + ORGANIZATION "The Cacti Group" + CONTACT-INFO + "The Cacti Group + + E-mail: developers@cacti.net" + DESCRIPTION + "This modules defines a MIB for THOLD, a threshold + monitoring plugin for Cacti." + REVISION "201309260000Z" + DESCRIPTION + "Initial version of this MIB module." + ::= { cactiPlugins 1 } -- assigned by the Cacti Group + +-- +-- TEXTUAL CONVENTIONS +-- + +-- +-- Event Class +-- + +TcEventClass ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Represents the classification of an event: + + info - threshold item is in normal state + warning - warning condition fulfilled + alert - alerting condition fulfilled " + SYNTAX INTEGER + { + info(1), + warning(2), + alert(3) + } + +-- +-- Event Severity +-- + +TcEventSeverity ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The following are the severities an THOLD event + can have: + + low - informational event, + event with low impact + medium - warning event, + event with medium impact + high - warning event or alert event, + event with high impact + critical - alert event, + event with critical impact " + SYNTAX INTEGER + { + low(1), + medium(2), + high(3), + critical(4) + } + +-- +-- Event Threshold Type +-- + +TcEventThresholdType ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "The monitoring type used to verify a threshold + condition: + + highLow - Monitoring if the current value was below a + specific upper and above a specific lower limit + baseline - Monitoring based on deviation in percentage + for the upper and lower bound threshold against a + time reference in the past + timebased - Monitoring if a breach condition was given for a + specific number of times within a specific amount of time + in the past " + SYNTAX INTEGER + { + highLow(1), + baseline(2), + timebased(3) + } + +-- +-- Event Notification Type +-- + +TcEventNotificationType ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Describes the several conditions detected by THOLD + which will end in a notification / alert: + + restoral - not available (restoral) + triggera - not available (trigger alert) + notifyra - Notify Alert Retrigger + notifywa - Notify Warning + notifyal - Notify Alert + notifyrs - Notify Restoral + triggerw - not available (trigger warning) + notifyaw - Notify Restoral to Warning: + This occurs if conditions for an alert state are no + longer breached, but the thresholds for a warning state + are still exceeded. " + SYNTAX INTEGER + { + restoral(1), + triggera(2), + notifyra(3), + notifywa(4), + notifyal(5), + notifyrs(6), + triggerw(7), + notifyaw(8) + } + +-- +-- Event Status +-- + +TcEventStatus ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Represents the state of a threshold: + + normal - Threshold has not been exceeded + low - Lower threshold condition breached + high - Upper threshold condition breached " + SYNTAX INTEGER + { + normal(1), + low(2), + high(3) + } + +-- +-- Event Re-Alert Status +-- + +TcEventRealertStatus ::= TEXTUAL-CONVENTION + STATUS current + DESCRIPTION + "Represents the long-term state of a threshold: + + normal - Threshold has not been exceeded + low - Lower threshold condition still breached + high - Upper threshold condition still breached " + SYNTAX INTEGER + { + normal(1), + low(2), + high(3) + } + +-- +-- THOLD APPLICATION DATA +-- +tholdAppl OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for Thold application data" + ::= { thold 1 } + +-- +-- THOLD Statistics +-- +tholdStats OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for statistics" + ::= { thold 2 } + +-- +-- THOLD Events +-- +tholdEvents OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for events" + ::= { thold 3 } + +tholdEventObjects OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for event attributes" + ::= { tholdEvents 1 } + +eventDateRFC822 OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..48)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "The current date/time of when the event was detected by Thold." + ::= { tholdEventObjects 1 } + +eventClass OBJECT-TYPE + SYNTAX TcEventClass + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Represents the classification of an event: + + info - threshold item is in normal state + warning - warning condition fulfilled + alert - alerting condition fulfilled " + DEFVAL { alert } + ::= { tholdEventObjects 2 } + +eventSeverity OBJECT-TYPE + SYNTAX TcEventSeverity + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "The following are the severities an THOLD event + can have: + + low - informational event, + event with low impact + medium - warning event, + event with medium impact + high - warning event or alert event, + event with high impact + critical - alert event, + event with critical impact " + DEFVAL { high } + ::= { tholdEventObjects 3 } + +eventCategory OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "To allow a NMS to categorize different SNMP traps THOLD SNMP traps + this object can be used to define a custom category + like 'disk_usage', 'link_utilization' or 'ping_test'." + DEFVAL { "" } + ::= { tholdEventObjects 4 } + +eventSource OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Contains the threshold name to identify the threshold (source) + generating this event." + DEFVAL { "" } + ::= { tholdEventObjects 5 } + +eventDescription OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..1000)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Contains a customized event description." + DEFVAL { "Threshold exceeded" } + ::= { tholdEventObjects 6 } + +eventDevice OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "This item describes the device name this event is related to." + DEFVAL { "" } + ::= { tholdEventObjects 7 } + +eventDeviceIp OBJECT-TYPE + SYNTAX IpAddress + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "IPv4 address of the device the event is related to." + DEFVAL { "0.0.0.0" } + ::= { tholdEventObjects 8 } + +eventDataSource OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Identifies the rrd data source being used for this threshold + monitor." + DEFVAL { "" } + ::= { tholdEventObjects 9 } + +eventCurrentValue OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "The current value of the data source that caused this event." + DEFVAL { "" } + ::= { tholdEventObjects 10 } + +eventHigh OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "In relation to eventClass this object describes the upper + limit for a warning or an alerting condition. + If eventCurrentValue is higher than this upper limit + an event will be triggered" + DEFVAL { "" } + ::= { tholdEventObjects 11 } + +eventLow OBJECT-TYPE + SYNTAX DisplayString (SIZE(1..255)) + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "In relation to eventClass this object describes the lower + limit for a warning or an alerting condition. + If eventCurrentValue is below this limit an event will + be triggered" + DEFVAL { "" } + ::= { tholdEventObjects 12 } + +eventThresholdType OBJECT-TYPE + SYNTAX TcEventThresholdType + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "The monitoring type used to verify a threshold + condition: + + highLow - Monitoring if the current value was below a + specific upper and above a specific lower limit + baseline - Monitoring based on deviation in percentage + for the upper and lower bound threshold against a + time reference in the past + timebased - Monitoring if a breach condition was given for a + specific number of times within a specific amount of time + in the past " + DEFVAL { baseline } + ::= { tholdEventObjects 13 } + +eventNotificationType OBJECT-TYPE + SYNTAX TcEventNotificationType + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Describes the several conditions detected by THOLD + which will end in a notification / alert: + + restoral - not available (restoral) + triggera - not available (trigger alert) + notifyra - Notify Alert Retrigger + notifywa - Notify Warning + notifyal - Notify Alert + notifyrs - Notify Restoral + triggerw - not available (trigger warning) + notifyaw - Notify Restoral to Warning: + This occurs if conditions for an alert state are no + longer breached, but the thresholds for a warning state + are still exceeded. " + DEFVAL { notifyal } + ::= { tholdEventObjects 14 } + +eventStatus OBJECT-TYPE + SYNTAX TcEventStatus + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Represents the state of a threshold: + + normal - Threshold has not been exceeded + low - Lower threshold condition breached + high - Upper threshold condition breached " + DEFVAL { high } + ::= { tholdEventObjects 15 } + +eventRealertStatus OBJECT-TYPE + SYNTAX TcEventRealertStatus + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Represents the long-term state of a threshold: + + normal - Threshold has not been exceeded + low - Lower threshold condition still breached + high - Upper threshold condition still breached " + DEFVAL { normal } + ::= { tholdEventObjects 16 } + +eventFailDuration OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Describes the amount of time in seconds the data source + is in a breach condition." + DEFVAL { 0 } + ::= { tholdEventObjects 17 } + +eventFailCount OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Describes the number of times the data source + is in a breach condition." + DEFVAL { 0 } + ::= { tholdEventObjects 18 } + +eventFailDurationTrigger OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Describes the amount of time in seconds the data source + must be in a breach condition for an alert or warning + to be raised. " + DEFVAL { 0 } + ::= { tholdEventObjects 19} + +eventFailCountTrigger OBJECT-TYPE + SYNTAX Integer32 + MAX-ACCESS accessible-for-notify + STATUS current + DESCRIPTION + "Describes the number of times the data source + must be in a breach condition for an alert or warning + to be raised. " + DEFVAL { 0 } + ::= { tholdEventObjects 20 } + +-- +-- THOLD Event Notifications +-- +tholdEventNotifications OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for event attributes" + ::= { tholdEvents 2 } + +tholdNotify NOTIFICATION-TYPE + OBJECTS { + eventDateRFC822, + eventClass, + eventSeverity, + eventCategory, + eventSource, + eventDescription, + eventDevice, + eventDeviceIp, + eventDataSource, + eventCurrentValue, + eventHigh, + eventLow, + eventThresholdType, + eventNotificationType, + eventStatus, + eventRealertStatus, + eventFailDuration, + eventFailCount, + eventFailDurationTrigger, + eventFailCountTrigger + } + STATUS current + DESCRIPTION + "The SNMP trap that is generated as a result of an event with Thold." + ::= { tholdEventNotifications 1 } + +-- +-- THOLD MIB Groups +-- +tholdMibGroups OBJECT-IDENTITY + STATUS current + DESCRIPTION + "reserved for group definitions" + ::= { thold 4 } + +tholdEventGroup OBJECT-GROUP + OBJECTS { + eventDateRFC822, + eventClass, + eventSeverity, + eventCategory, + eventSource, + eventDescription, + eventDevice, + eventDeviceIp, + eventDataSource, + eventCurrentValue, + eventHigh, + eventLow, + eventThresholdType, + eventNotificationType, + eventStatus, + eventRealertStatus, + eventFailDuration, + eventFailCount, + eventFailDurationTrigger, + eventFailCountTrigger + } + STATUS current + DESCRIPTION + "A collection of objects providing the THOLD event + defaults." + ::= { tholdMibGroups 1 } + +tholdNotifyGroup NOTIFICATION-GROUP + NOTIFICATIONS { + tholdNotify + } + STATUS current + DESCRIPTION + "The notifications relating to the monitoring operation of Thold." + ::= { tholdMibGroups 2 } + END \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 8bcaaad..4d96ebd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -705,4 +705,4 @@ * bug: Lots of bug fixes for issues in the original threshold module ----------------------------------------------- -Copyright (c) 2004-2024 - The Cacti Group, Inc. +Copyright (c) 2004-2025 - The Cacti Group, Inc. diff --git a/INFO b/INFO index 72c24ba..ee9e80c 100644 --- a/INFO +++ b/INFO @@ -1,5 +1,5 @@ ; +-------------------------------------------------------------------------+ -; | Copyright (C) 2004-2024 The Cacti Group | +; | Copyright (C) 2004-2025 The Cacti Group | ; | | ; | This program is free software; you can redistribute it and/or | ; | modify it under the terms of the GNU General Public License | diff --git a/README.md b/README.md index 4e24848..d8f6d03 100644 --- a/README.md +++ b/README.md @@ -105,4 +105,4 @@ new ideas. So, this won't be the last release of thold, you can rest assured of that. ----------------------------------------------- -Copyright (c) 2004-2024 - The Cacti Group, Inc. +Copyright (c) 2004-2025 - The Cacti Group, Inc. diff --git a/cli_import.php b/cli_import.php index f983068..7fb2a83 100644 --- a/cli_import.php +++ b/cli_import.php @@ -1,7 +1,7 @@