mirror of https://github.com/ceph/ceph synced 2024-12-19 09:57:05 +00:00

History

Paul Cuzner cbeab5c566 monitoring: remove old MIB

The MIB file that matches the OID definitions in the alerts is
CEPH-MIB.txt. The old MIB from the original SuSE snmp
gateway work, therefore needs to be removed to avoid
confusion.

Signed-off-by: Paul Cuzner <pcuzner@redhat.com>

2022-01-27 11:24:34 +13:00

CEPH-MIB.txt

README.md

SNMP schema

To show the OID's supported by the MIB, use the snmptranslate command. Here's an example:

snmptranslate -Pu -Tz -M ~/git/ceph/monitoring/snmp:/usr/share/snmp/mibs -m CEPH-MIB

The snmptranslate command is in the net-snmp-utils package

The MIB provides a NOTIFICATION only implementation since ceph doesn't have an SNMP agent feature.

Integration

The SNMP MIB is has been aligned to the Prometheus rules. Any rule that defines a critical alert should have a corresponding oid in the CEPH-MIB.txt file. To generate an SNMP notification, you must use an SNMP gateway that the Prometheus Alertmanager service can forward alerts through to, via it's webhooks feature.

SNMP Gateway

The recommended SNMP gateway is https://github.com/maxwo/snmp_notifier. This is a widely used and generic SNMP gateway implementation written in go. It's usage (syntax and parameters) is very similar to Prometheus, AlertManager and even node-exporter.

SNMP OIDs

The main components of the Ceph MIB is can be broken down into discrete areas

internet private enterprise   ceph   ceph    Notifications   Prometheus  Notification
                               org  cluster   (alerts)         source      Category
1.3.6.1   .4     .1          .50495   .1        .2               .1         .2  (Ceph Health)
                                                                            .3  (MON)
                                                                            .4  (OSD)
                                                                            .5  (MDS)
                                                                            .6  (MGR)
                                                                            .7  (PGs)
                                                                            .8  (Nodes)
                                                                            .9  (Pools)
                                                                            .10  (Rados)
                                                                            .11 (cephadm)
                                                                            .12 (prometheus)

Individual alerts are placed within the appropriate alert category. For example, to add a notification relating to a MGR issue, you would use the oid 1.3.6.1.4.1.50495.1.2.1.6.x

The SNMP gateway also adds additional components to the SNMP notification ;

Suffix	Description
.1	The oid
.2	Severity of the alert. When an alert is resolved, severity is 'info', and the description is set to Status:OK
.3	Text of the alert(s)