axiscam: add CPU and memory polling for AXIS OS 12.10+ (librenms#19639)

redundantredundancy · web-flow · commit d69b805b5ba5 · 2026-05-11T10:17:50.000-05:00
Replace AXIS-VIDEO-MIB and AXIS-ROOT-MIB with official files obtained
directly from Axis Communications, adding the basicDeviceInfo subtree
(1.3.6.1.4.1.368.4.1.100) introduced in AXIS OS 12.10 and a new RAID
subtree (videoObjects 10).

Add os_discovery/axiscam.yaml to poll CPU (processors) and memory
(mempools) on devices running AXIS OS 12.10 or later.

Add device_processor and device_mempool graphs to axiscam os_detection.

Add test fixtures for AXIS Q6074 running AXIS OS 12.10.68.

Backwards compatible � tested against AXIS M3077-PLVE running AXIS OS
11.11, older devices gracefully return no data for the new OIDs.
diff --git a/mibs/axis/AXIS-ROOT-MIB b/mibs/axis/AXIS-ROOT-MIB
@@ -34,3 +34,4 @@ products OBJECT-IDENTITY
     ::= { axis 1 }
 
 END
+
diff --git a/mibs/axis/AXIS-VIDEO-MIB b/mibs/axis/AXIS-VIDEO-MIB
@@ -6,7 +6,7 @@ IMPORTS
     MODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP
         FROM SNMPv2-CONF            -- RFC 2580
     Integer32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE,
-    Unsigned32
+    Unsigned32, TimeTicks
         FROM SNMPv2-SMI             -- RFC 2578
    SnmpAdminString
         FROM SNMP-FRAMEWORK-MIB;    -- RFC 3411
@@ -400,6 +400,213 @@ storageDisruptionDetected OBJECT-TYPE
 
 --- { videoObjects 9 }, reserved for tampering
 
+--- RAID
+raid OBJECT IDENTIFIER ::= { videoObjects 10 }
+
+raidTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF RaidEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A list of RAID information, one entry for each RAID"
+    ::= { raid 1 }
+
+raidEntry OBJECT-TYPE
+    SYNTAX      RaidEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A RAID entry contains information about a specific RAID"
+    INDEX       { raidId }
+    ::= { raidTable 1 }
+
+RaidEntry ::= SEQUENCE {
+    raidId         Unsigned32,
+    raidStatus     INTEGER
+}
+
+raidId OBJECT-TYPE
+    SYNTAX      Unsigned32 (1..128)
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "Used to identify a RAID"
+    ::= { raidEntry 1 }
+
+raidStatus OBJECT-TYPE
+    SYNTAX      INTEGER { active(1), degraded(2), syncing(3), failure(4) }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The status of the RAID"
+    ::= { raidEntry 2 }
+
+raidComponentTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF RaidComponentEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A list of RAID component status, one entry for each RAID component in
+        each RAID"
+    ::= { raid 2 }
+
+raidComponentEntry OBJECT-TYPE
+    SYNTAX      RaidComponentEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A RAID component entry contains information about a specific RAID
+         component"
+    INDEX       { raidId, raidComponentId }
+    ::= { raidComponentTable 1 }
+
+RaidComponentEntry ::= SEQUENCE {
+    raidComponentId         Unsigned32,
+    raidComponentName       SnmpAdminString,
+    raidComponentStatus     INTEGER
+}
+
+raidComponentId OBJECT-TYPE
+    SYNTAX      Unsigned32 (1..128)
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "Used to identify a RAID component"
+    ::= { raidComponentEntry 1 }
+
+raidComponentName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "Used to identify a RAID component. If the original string is longer
+         than the specified length then the middle of the string will be
+         replaced by '..' in such a way that the length of the string becomes
+         32 characters anyway."
+    ::= { raidComponentEntry 2 }
+
+raidComponentStatus OBJECT-TYPE
+    SYNTAX      INTEGER { connected(1), spare(2), missing(3) }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+        "The status of the RAID component."
+    ::= { raidComponentEntry 3 }
+
+--- Basic device info
+basicDeviceInfo OBJECT IDENTIFIER ::= { videoObjects 100 }
+
+memoryInfo OBJECT IDENTIFIER ::= { basicDeviceInfo 1 }
+
+deviceMemoryUtilization OBJECT-TYPE
+    SYNTAX      Unsigned32 (0..100)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The percentage of system memory in use."
+    ::= { memoryInfo 1 }
+
+deviceMemoryTotal OBJECT-TYPE
+    SYNTAX      Unsigned32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total amount of available system memory, in kB."
+    ::= { memoryInfo 2 }
+
+deviceMemoryUsed OBJECT-TYPE
+    SYNTAX      Unsigned32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The amount of system memory in use, in kB."
+    ::= { memoryInfo 3 }
+
+flashInfo OBJECT IDENTIFIER ::= { basicDeviceInfo 2 }
+
+deviceFlashUtilization OBJECT-TYPE
+    SYNTAX      Unsigned32 (0..100)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The percentage of flash storage in use."
+    ::= { flashInfo 1 }
+
+deviceFlashTotal OBJECT-TYPE
+    SYNTAX      Unsigned32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total amount of flash storage available, in MB."
+    ::= { flashInfo 2 }
+
+deviceFlashUsed OBJECT-TYPE
+    SYNTAX      Unsigned32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The amount of flash in use, in MB."
+    ::= { flashInfo 3 }
+
+cpuInfo OBJECT IDENTIFIER ::= { basicDeviceInfo 3 }
+
+deviceCpuUtilization OBJECT-TYPE
+    SYNTAX      Unsigned32 (0..100)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The percentage of time the CPU is actively working."
+    ::= { cpuInfo 1 }
+
+deviceSystemLoad OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of processes running or waiting on the cpu.
+             Represented by 1-minute, 5-minute, 15-minute averages."
+    ::= { cpuInfo 2 }
+
+deviceUptime OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The time since the  system was last re-initialized."
+    ::= { basicDeviceInfo 4 }
+
+deviceSoftware OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The AxisOS version running on the device."
+    ::= { basicDeviceInfo 5 }
+
+deviceSerialNumber OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The serial number of the device."
+    ::= { basicDeviceInfo 6 }
+
+deviceManufacturer OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The manufacturer of the device."
+    ::= { basicDeviceInfo 7 }
+
+deviceModel OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The model name of the device."
+    ::= { basicDeviceInfo 8 }
+
 -- Objects used in Private Enterprise Traps
 videoNotifications OBJECT IDENTIFIER
     ::= { video 2 }
@@ -472,7 +679,8 @@ videoObjectGroup OBJECT-GROUP
     OBJECTS     { powerSupplyStatus, fanStatus, tempSensorStatus,
                   tempSensorValue, videoSignalStatus, audioSignalStatus,
                   casingName, casingStatus, storageDisruptionDetected,
-                  storageName, alarmID, alarmName, alarmText }
+                  storageName, raidStatus, raidComponentName,
+                  raidComponentStatus, alarmID, alarmName, alarmText }
     STATUS      obsolete
     DESCRIPTION
         "A collection of video objects."
@@ -506,6 +714,24 @@ storageGroup OBJECT-GROUP
         "Objects related to Axis storage."
     ::= { videoGroups 5 }
 
+raidGroup OBJECT-GROUP
+    OBJECTS { raidStatus, raidComponentName, raidComponentStatus }
+    STATUS      current
+    DESCRIPTION
+        "Objects related to Axis RAID."
+    ::= { videoGroups 6 }
+
+basicDeviceInfoGroup OBJECT-GROUP
+    OBJECTS { deviceMemoryUtilization, deviceMemoryTotal, deviceMemoryUsed,
+              deviceFlashTotal, deviceFlashUsed, deviceFlashUtilization,
+              deviceCpuUtilization, deviceSystemLoad, deviceUptime,
+              deviceSoftware, deviceSerialNumber, deviceManufacturer,
+              deviceModel }
+    STATUS      current
+    DESCRIPTION
+        "Objects related to basic device information."
+    ::= { videoGroups 7 }
+
 -- Compliance Statements
 videoComplianceRev2 MODULE-COMPLIANCE
     STATUS      current
@@ -555,6 +781,11 @@ videoComplianceRev2 MODULE-COMPLIANCE
               storage device connected and for which it is possible to check the
               state."
 
+        GROUP   raidGroup
+        DESCRIPTION
+              "This group is mandatory for all Axis video products that have
+              RAID capabilities, for which it is possible to check the status."
+
     ::= { videoCompliances 2 }
 
 videoCompliance MODULE-COMPLIANCE
@@ -574,3 +805,4 @@ videoCompliance MODULE-COMPLIANCE
     ::= { videoCompliances 1 }
 
 END -- end of module AXIS-VIDEO-MIB.
+
diff --git a/resources/definitions/os_detection/axiscam.yaml b/resources/definitions/os_detection/axiscam.yaml
@@ -8,5 +8,7 @@ discovery:
         sysDescr_regex: '/AXIS .* ((Network|Bullet|PTZ|Dome|Panoramic|Box) Camera|Security Radar|Video (Server|Decoder)|Network Video Encoder)/'
 over:
     - { graph: device_bits, text: Traffic }
+    - { graph: device_processor, text: 'CPU Usage' }
+    - { graph: device_mempool, text: 'Memory Usage' }
     - { graph: device_temperature, text: 'Device Temperature' }
     - { graph: device_state, text: 'Device State' }
diff --git a/resources/definitions/os_discovery/axiscam.yaml b/resources/definitions/os_discovery/axiscam.yaml
@@ -1,5 +1,19 @@
 modules:
+    mempools:
+        data:
+            -
+                used: AXIS-VIDEO-MIB::deviceMemoryUsed.0
+                total: AXIS-VIDEO-MIB::deviceMemoryTotal.0
+                descr: 'System Memory'
+                precision: 1024
     os:
         sysDescr_regex: '/(?<hardware>[^;]+); [^;]+; (?<version>[^;]+)/'
         serial:
             - IF-MIB::ifPhysAddress.2
+    processors:
+        data:
+            -
+                oid: AXIS-VIDEO-MIB::deviceCpuUtilization
+                num_oid: '.1.3.6.1.4.1.368.4.1.100.3.1.{{ $index }}'
+                index: 0
+                descr: 'CPU'
diff --git a/tests/data/axiscam_q6074.json b/tests/data/axiscam_q6074.json
diff --git a/tests/snmpsim/axiscam_q6074.snmprec b/tests/snmpsim/axiscam_q6074.snmprec

Original file line number	Diff line number	Diff line change
`@@ -34,3 +34,4 @@ products OBJECT-IDENTITY`
`34`	`34`	`::= { axis 1 }`
`35`	`35`
`36`	`36`	`END`
	`37`	`+`