feat: SnmpHealthProfile, the OIDs a driver declares; deprecate HealthMetricsMixin (4.12.0) #40

2026-10-16T10:00:14Z

christianmanivong commented

2026-10-16 10:00:14 +00:00

Step 3 of NetOrk/netork#1105, base-package side.

SnmpHealthProfile (+ SnmpValueSpec, SnmpMemorySpec, SnmpInterfacesSpec): fallback OIDs, tables folded by first/average/max, a pattern for text answers, memory as total+used/free or percent with a unit, interfaces to skip and TX errors that are drops. Every key optional.
HealthMetricsMixin.get_health_metrics warns DeprecationWarning; it goes in 5.0.
README: SNMP is the application's, with an example profile.

The application side is NetOrk/netork#1129 (it reads the profile as a plain mapping, so it does not need this version to work). Next: procurve, netgear and tplink declare profiles instead of their own collectors.

Rebased onto 4.11.0 (DHCP HA / config sync, #42).

Closes #32

Step 3 of NetOrk/netork#1105, base-package side. - `SnmpHealthProfile` (+ `SnmpValueSpec`, `SnmpMemorySpec`, `SnmpInterfacesSpec`): fallback OIDs, tables folded by first/average/max, a pattern for text answers, memory as total+used/free or percent with a unit, interfaces to skip and TX errors that are drops. Every key optional. - `HealthMetricsMixin.get_health_metrics` warns `DeprecationWarning`; it goes in 5.0. - README: SNMP is the application's, with an example profile. The application side is NetOrk/netork#1129 (it reads the profile as a plain mapping, so it does not need this version to work). Next: procurve, netgear and tplink declare profiles instead of their own collectors. Rebased onto 4.11.0 (DHCP HA / config sync, #42). Closes #32

christianmanivong referenced this pull request

2026-10-16 10:06:27 +00:00

feat: fix routines as templates with the caller's values; deprecate run_device_action (4.13.0) #41

christianmanivong referenced this pull request

2026-10-16 13:18:35 +00:00

feat: an HA pair's DHCP peers and config sync as facts (4.11.0) #42

christianmanivong added 1 commit 2026-10-16 13:29:28 +00:00

feat: SnmpHealthProfile, the OIDs a driver declares; deprecate HealthMetricsMixin (4.12.0)

CI / test (3.10) (push) Successful in 28s

Details

CI / test (3.11) (push) Successful in 27s

Details

CI / test (3.12) (push) Successful in 29s

Details

CI / test (3.13) (push) Successful in 30s

Details

CI / test (3.10) (pull_request) Successful in 29s

Details

CI / test (3.11) (pull_request) Successful in 26s

Details

CI / test (3.12) (pull_request) Successful in 35s

Details

CI / test (3.13) (pull_request) Successful in 33s

Details

b4c4ec0b0b

Drivers no longer collect over SNMP (docs/STRUCTURE.md). A driver whose
device publishes its health values under OIDs of its own declares them
as SNMP_HEALTH_PROFILE: per value either scalars asked in order or a
table folded by first, average or max, optionally with a pattern for
text answers; memory as total with used or free, or a percentage, in
KiB or bytes; and how to read the interfaces. The application polls
and computes.

HealthMetricsMixin.get_health_metrics now warns that it is deprecated;
it goes in 5.0.

Closes #32

christianmanivong force-pushed feat/snmp-health-profile-32 from 64cc20ba00 to b4c4ec0b0b

2026-10-16 13:29:28 +00:00

Compare

christianmanivong changed title from ~~feat: SnmpHealthProfile, the OIDs a driver declares; deprecate HealthMetricsMixin (4.11.0)~~ to feat: SnmpHealthProfile, the OIDs a driver declares; deprecate HealthMetricsMixin (4.12.0)

2026-10-16 13:29:56 +00:00

christianmanivong merged commit 321537ff0a into main

2026-10-16 22:43:22 +00:00

christianmanivong deleted branch feat/snmp-health-profile-32

2026-10-16 22:43:22 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: NAPALM/napalm-device-types#40