Use SNMP monitoring: Overview
If you want to monitor StorageGRID using the Simple Network Management Protocol (SNMP), you must configure the SNMP agent that is included with StorageGRID.
Capabilities
Each StorageGRID node runs an SNMP agent, or daemon, that provides a MIB. The StorageGRID MIB contains table and notification definitions for alerts and alarms. The MIB also contains system description information such as platform and model number for each node. Each StorageGRID node also supports a subset of MIB-II objects.
See Access MIB files if you want to download the MIB files on your grid nodes. |
Initially, SNMP is disabled on all nodes. When you configure the SNMP agent, all StorageGRID nodes receive the same configuration.
The StorageGRID SNMP agent supports all three versions of the SNMP protocol. It provides read-only MIB access for queries, and it can send two types of event-driven notifications to a management system:
- Traps
-
Traps are notifications sent by the SNMP agent that don't require acknowledgment by the management system. Traps serve to notify the management system that something has happened within StorageGRID, such as an alert being triggered.
Traps are supported in all three versions of SNMP.
- Informs
-
Informs are similar to traps, but they require acknowledgment by the management system. If the SNMP agent doesn't receive an acknowledgment within a certain amount of time, it resends the inform until an acknowledgment is received or the maximum retry value has been reached.
Informs are supported in SNMPv2c and SNMPv3.
Trap and inform notifications are sent in the following cases:
-
A default or custom alert is triggered at any severity level. To suppress SNMP notifications for an alert, you must configure a silence for the alert. Alert notifications are sent by the preferred sender Admin Node.
Each alert is mapped to one of three trap types based on the severity level of the alert: activeMinorAlert, activeMajorAlert, and activeCriticalAlert. For a list of the alerts that can trigger these traps, see the Alerts reference.
-
Certain alarms (legacy system) are triggered at specified severity levels or higher.
SNMP notifications aren't sent for every alarm or every alarm severity.
SNMP version support
The table provides a high-level summary of what is supported for each SNMP version.
SNMPv1 | SNMPv2c | SNMPv3 | |
---|---|---|---|
Queries (GET and GETNEXT) |
Read-only MIB queries |
Read-only MIB queries |
Read-only MIB queries |
Query authentication |
Community string |
Community string |
User-based Security Model (USM) user |
Notifications (TRAP and INFORM) |
Traps only |
Traps and informs |
Traps and informs |
Notification authentication |
Default trap community or a custom community string for each trap destination |
Default trap community or a custom community string for each trap destination |
USM user for each trap destination |
Limitations
-
StorageGRID supports read-only MIB access. Read-write access is not supported.
-
All nodes in the grid receive the same configuration.
-
SNMPv3: StorageGRID does not support the Transport Support Mode (TSM).
-
SNMPv3: The only authentication protocol supported is SHA (HMAC-SHA-96).
-
SNMPv3: The only privacy protocol supported is AES.