DOKK / manpages / debian 12 / torrus-common / torrus_snmpfailures.8.en
TORRUS_SNMPFAILURES(8) torrus TORRUS_SNMPFAILURES(8)

snmpfailures - Displays SNMP collector failures.

torrus snmpfailures --tree=TREENAME [options...]

In addition to failure counters, list the failed SNMP hosts and the time stamps of failure events.
Displays a help message.

This utility prints the SNMP collector failure information in JSON format. Without --details option, it prints only the failure counters.

Upon collector startup or after the tree re-compilation, the failure counters are reset to zero.

The output is very convenient for further automatic processing in any scripting language.

The top level of the output is a JSON object with the following name/value pairs:

Displays the number SNMP hosts that are currently unreachable. The number adds up across multiple collector instances for a given tree. If a host becomes reachable again, the number is decreased.
Displays the number SNMP hosts that are completely removed from SNMP collection for the life cycle of the collector process. This happens when a host is unreachable for too long time and the collector gives up to reach it again. The number adds up across multiple collector instances for a given tree.
Displays the number of MIB errors (noSuchObject, noSuchInstance, and endOfMibView) during the collector life cycle. The number adds up across multiple collector instances for a given tree.
If the option --details is specified, these objects contain the host names and timestamps of the failures. The keys are contactenations of SNMP host, UDP port, and SNMP community separated by "|". The values are objects representing the UNIX timestamp and a human-readable time string.
If the option --details is specified, this object displays the MIB error details: for each SNMP host, it lists the datasource leaves which had these errors and the event timestamps.

The following example illustrates an SNMP host unreachable:

 torrus failures --tree=main --details
 {
    "detail_deleted" : {},
    "detail_mib_errors" : {},
    "detail_unreachable" : {
       "217.101.101.101|161|public" : {
          "time" : "Fri Jul 23 14:15:10 2010",
          "timestamp" : 1279887310
       }
    },
    "total_deleted" : 0,
    "total_mib_errors" : 0,
    "total_unreachable" : 1
 }

The following example illustrates a MIB error:

 torrus failures --tree=main --details
 {
    "detail_deleted" : {},
    "detail_mib_errors" : {
       "217.101.102.102|161|public" : {
          "count" : 1,
          "nodes" : {
             "/Routers/CMTS3/Temperature_Sensors/sensor_01" : {
                "time" : "Fri Jul 23 15:26:14 2010",
                "timestamp" : 1279891574
             }
          }
       }
    },
    "detail_unreachable" : {},
    "total_deleted" : 0,
    "total_mib_errors" : 1,
    "total_unreachable" : 0
 }

torrus(8),

See more documentation at Torrus home page: http://torrus.org

Stanislav Sinyagin <ssinyagin@k-open.com>

2023-05-02 torrus 3.00