VM-MIB
This MIB module is for use in managing a hypervisor and
virtual machines controlled by the hypervisor.
Copyright (c) 2015 IETF Trust and the persons identified
as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with
or without modification, is permitted pursuant to, and
subject to the license terms contained in, the
Simplified BSD License set forth in Section 4.c of the
IETF Trust's Legal Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info).
- Source file
VM-MIB- Last revised
- Identity
vmMIB- Base OID
1.3.6.1.2.1.236
Imported Objects
| IANA-STORAGE-MEDIA-TYPE-MIB | IANAStorageMediaType |
| IF-MIB | InterfaceIndexOrZero |
| SNMP-FRAMEWORK-MIB | SnmpAdminString |
| SNMPv2-CONF | MODULE-COMPLIANCE (no object page) NOTIFICATION-GROUP (no object page) OBJECT-GROUP (no object page) |
| SNMPv2-SMI | Counter64 Integer32 mib-2 MODULE-IDENTITY (no object page) NOTIFICATION-TYPE (no object page) OBJECT-TYPE (no object page) TimeTicks |
| SNMPv2-TC | PhysAddress TEXTUAL-CONVENTION (no object page) TruthValue |
| UUID-TC-MIB | UUIDorZero |
Net-SNMP examples using the rfc MIB directory Show commands
These commands use the standard Observium installation path and load the selected MIB variant before the RFC and Net-SNMP directories.
Translate the module identity
/usr/bin/snmptranslate -Pud -Ir -On -m 'VM-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'VM-MIB::vmMIB'
Walk the MIB subtree
/usr/bin/snmpbulkwalk -v2c -c '<community>' -Pud -Ir -OQUs -m 'VM-MIB' -M '/opt/observium/mibs/rfc:/opt/observium/mibs/net-snmp' 'udp:<hostname>:161' 'VM-MIB::vmMIB'
Objects (70)
Showing 70 of 70 objects
Object legend
Table
Row
Column
Scalar
Node
Object type
Icons distinguish tables, entry rows, columns, scalars, and structural nodes.
SNMPv2-TCTruthValue
Syntax
Blue badges identify the value syntax. Connected badges read as defining module and convention.
IF-MIBifIndex
Table index
Green identifies an index object; yellow names its module when the index is defined elsewhere.
r/w
deprecated
obsolete
Access and status
r/w means read-write. Grey labels mark definitions retained for compatibility.
OBS ✓
Observium use
The indicator appears only when Observium directly references that object.
ifOperStatus
.1.3.6.1.2.1…
Names and OIDs
Object names link to their detail pages. Hover or focus a linked name or badge for available definition details.
.1.3.6.1.2.1.236 |
||
.1.3.6.1.2.1.236.0 |
||
.1.3.6.1.2.1.236.1 |
||
.1.3.6.1.2.1.236.1.1 |
||
|
OctetString
|
.1.3.6.1.2.1.236.1.1.1 |
|
|
OctetString
|
.1.3.6.1.2.1.236.1.1.2 |
|
|
ObjectIdentifier
|
.1.3.6.1.2.1.236.1.1.3 |
|
.1.3.6.1.2.1.236.1.1.4 |
||
.1.3.6.1.2.1.236.1.10 |
||
.1.3.6.1.2.1.236.1.11 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.2 |
|
.1.3.6.1.2.1.236.1.3 |
||
.1.3.6.1.2.1.236.1.4 |
||
.1.3.6.1.2.1.236.1.4.1 |
||
.1.3.6.1.2.1.236.1.4.1.1 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.10 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.11 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.12 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.13 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.14 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.15 |
|
.1.3.6.1.2.1.236.1.4.1.16 |
||
|
microsecondSNMPv2-SMICounter64
|
.1.3.6.1.2.1.236.1.4.1.17 |
|
|
OctetString
|
.1.3.6.1.2.1.236.1.4.1.2 |
|
.1.3.6.1.2.1.236.1.4.1.3 |
||
|
OctetString
|
.1.3.6.1.2.1.236.1.4.1.4 |
|
.1.3.6.1.2.1.236.1.4.1.5 |
||
.1.3.6.1.2.1.236.1.4.1.6 |
||
.1.3.6.1.2.1.236.1.4.1.7 |
||
.1.3.6.1.2.1.236.1.4.1.8 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.4.1.9 |
|
.1.3.6.1.2.1.236.1.5 |
||
.1.3.6.1.2.1.236.1.5.1 |
||
.1.3.6.1.2.1.236.1.5.1.1 |
||
|
microsecondSNMPv2-SMICounter64
|
.1.3.6.1.2.1.236.1.5.1.2 |
|
.1.3.6.1.2.1.236.1.6 |
||
.1.3.6.1.2.1.236.1.6.1 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.6.1.2 |
|
|
Enumeration
|
.1.3.6.1.2.1.236.1.6.1.3 |
|
.1.3.6.1.2.1.236.1.7 |
||
.1.3.6.1.2.1.236.1.7.1 |
||
.1.3.6.1.2.1.236.1.7.1.1 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.7.1.10 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.7.1.11 |
|
|
Integer32
|
.1.3.6.1.2.1.236.1.7.1.12 |
|
.1.3.6.1.2.1.236.1.7.1.13 |
||
.1.3.6.1.2.1.236.1.7.1.14 |
||
.1.3.6.1.2.1.236.1.7.1.15 |
||
.1.3.6.1.2.1.236.1.7.1.16 |
||
.1.3.6.1.2.1.236.1.7.1.17 |
||
.1.3.6.1.2.1.236.1.7.1.18 |
||
.1.3.6.1.2.1.236.1.7.1.2 |
||
|
Integer32
|
.1.3.6.1.2.1.236.1.7.1.3 |
|
.1.3.6.1.2.1.236.1.7.1.4 |
||
|
OctetString
|
.1.3.6.1.2.1.236.1.7.1.5 |
|
|
OctetString
|
.1.3.6.1.2.1.236.1.7.1.6 |
|
.1.3.6.1.2.1.236.1.7.1.7 |
||
.1.3.6.1.2.1.236.1.7.1.8 |
||
|
OctetString
|
.1.3.6.1.2.1.236.1.7.1.9 |
|
.1.3.6.1.2.1.236.1.8 |
||
.1.3.6.1.2.1.236.1.8.1 |
||
.1.3.6.1.2.1.236.1.8.1.1 |
||
.1.3.6.1.2.1.236.1.8.1.2 |
||
.1.3.6.1.2.1.236.1.8.1.3 |
||
|
OctetString
|
.1.3.6.1.2.1.236.1.8.1.4 |
|
.1.3.6.1.2.1.236.1.8.1.5 |
||
.1.3.6.1.2.1.236.1.9 |
||
.1.3.6.1.2.1.236.2 |
||
.1.3.6.1.2.1.236.2.1 |
||
.1.3.6.1.2.1.236.2.2 |
Dependencies (9) 7 direct · 2 transitive Show tree and compile order Hide dependency details
Each imported module is resolved in the importing module's source directory first, then through the normal default-variant rules.
Dependency tree
Dependency-first compile order
- SNMPv2-SMIrfc
- SNMPv2-TCrfc
- IANA-STORAGE-MEDIA-TYPE-MIBrfc
- IANAifType-MIBrfc
- SNMPv2-CONFrfc
- SNMPv2-MIBrfc
- IF-MIBrfc
- SNMP-FRAMEWORK-MIBrfc
- UUID-TC-MIBrfc
- VM-MIBrfcselected
Type Definitions (12)
| Enumeration |
running(1)suspended(2)paused(3)shutdown(4) |
|
| Enumeration |
unknown(1)enabled(2)disabled(3) |
|
| Integer32 |
range: 1..2147483647 |
|
| Integer32 |
range: 1..2147483647 |
|
| Integer32 |
range: 0..2147483647 |
|
| OctetString | ||
| Integer32 |
range: 1..2147483647 |
|
| Enumeration |
unknown(1)other(2)preparing(3)running(4)suspending(5)suspended(6)resuming(7)paused(8)migrating(9)shuttingdown(10)shutdown(11)crashed(12) |
|
| Enumeration |
unknown(1)persistent(2)transient(3) |
|
| Enumeration |
unknown(1)readwrite(2)readonly(3) |
|
| Integer32 |
range: 1..2147483647 |
|
| Enumeration |
unknown(1)other(2)block(3)raw(4)sparse(5)network(6) |
Conformance Groups (9)
|
vmHvSoftware vmHvVersion vmHvObjectID vmHvUpTime vmNumber vmTableLastChange vmPerVMNotificationsEnabled vmBulkNotificationsEnabled
A collection of objects providing insight into the
hypervisor itself. |
.1.3.6.1.2.1.236.2.2.1
|
|
|
vmName vmUUID vmOSType vmAdminState vmOperState vmAutoStart vmPersistent vmCurCpuNumber vmMinCpuNumber vmMaxCpuNumber vmMemUnit vmCurMem vmMinMem vmMaxMem vmUpTime vmCpuTime
A collection of objects providing insight into the
virtual machines controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.2
|
|
|
A collection of objects providing insight into the
virtual machines controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.3
|
|
|
A collection of objects providing insight into the
virtual machines controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.4
|
|
|
vmStorageParent vmStorageSourceType vmStorageSourceTypeString vmStorageResourceID vmStorageAccess vmStorageMediaType vmStorageMediaTypeString vmStorageSizeUnit vmStorageDefinedSize vmStorageAllocatedSize vmStorageReadIOs vmStorageWriteIOs vmStorageReadOctets vmStorageWriteOctets vmStorageReadLatency vmStorageWriteLatency
A collection of objects providing insight into the
virtual storage devices controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.5
|
|
|
A collection of objects providing insight into the
virtual network interfaces controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.6
|
|
|
vmRunning vmShuttingdown vmShutdown vmPaused vmSuspending vmSuspended vmResuming vmMigrating vmCrashed vmDeleted
A collection of notifications for per-VM notification
of changes to virtual machine state (vmOperState) as reported by a hypervisor. |
.1.3.6.1.2.1.236.2.2.7
|
|
|
The variables used in vmBulkNotificationOptionalGroup
virtual network interfaces controlled by a hypervisor. |
.1.3.6.1.2.1.236.2.2.8
|
|
|
vmBulkRunning vmBulkShuttingdown vmBulkShutdown vmBulkPaused vmBulkSuspending vmBulkSuspended vmBulkResuming vmBulkMigrating vmBulkCrashed vmBulkDeleted
A collection of notifications for bulk notification of
changes to virtual machine state (vmOperState) as reported by a given hypervisor. |
.1.3.6.1.2.1.236.2.2.9
|
Compliance Statements (2)
OID
.1.3.6.1.2.1.236.2.1.1Compliance statement for implementations supporting
read/write access, according to the object definitions.
read/write access, according to the object definitions.
Required groups
| mandatory | vmHypervisorGroup | |
| mandatory | vmVirtualMachineGroup | |
| mandatory | vmCpuGroup | |
| mandatory | vmCpuAffinityGroup | |
| mandatory | vmStorageGroup | |
| mandatory | vmNetworkGroup | |
| optional | vmPerVMNotificationOptionalGroup |
Support for per-VM notifications is optional. If not implemented, then vmPerVMNotificationsEnabled MUST report false(2). |
| optional | vmBulkNotificationsVariablesGroup |
Necessary only if vmPerVMNotificationOptionalGroup is implemented. |
| optional | vmBulkNotificationOptionalGroup |
Support for bulk notifications is optional. If not implemented, then vmBulkNotificationsEnabled MUST report false(2). |
OID
.1.3.6.1.2.1.236.2.1.2Compliance statement for implementations supporting
only read-only access.
only read-only access.
Required groups
| mandatory | vmHypervisorGroup | |
| mandatory | vmVirtualMachineGroup | |
| mandatory | vmCpuGroup | |
| mandatory | vmCpuAffinityGroup | |
| mandatory | vmStorageGroup | |
| mandatory | vmNetworkGroup |
Object refinements
| Object | Access | Syntax | Description |
|---|---|---|---|
| vmPerVMNotificationsEnabled | readonly | Write access is not required. | |
| vmBulkNotificationsEnabled | readonly | Write access is not required. |
Notifications / Traps (20)
| Name | OID | Description |
|---|---|---|
.1.3.6.1.2.1.236.0.1 |
This notification is generated when the operational
state of a virtual machine has been changed to running(4) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.10 |
This notification is generated when a virtual machine
has been deleted. The prior state of the virtual machine is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.11 |
This notification is generated when the operational
state of one or more virtual machines has been changed to running(4) from any prior state, except for running(4). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.12 |
This notification is generated when the operational
state of one or more virtual machines has been changed to shuttingdown(10) from a state other than shuttingdown(10). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.13 |
This notification is generated when the operational
state of one or more virtual machine has been changed to shutdown(11) from a state other than shutdown(11). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.14 |
This notification is generated when the operational
state of one or more virtual machines has been changed to paused(8) from a state other than paused(8). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.15 |
This notification is generated when the operational
state of one or more virtual machines has been changed to suspending(5) from a state other than suspending(5). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.16 |
This notification is generated when the operational
state of one or more virtual machines has been changed to suspended(6) from a state other than suspended(6). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.17 |
This notification is generated when the operational
state of one or more virtual machines has been changed to resuming(7) from a state other than resuming(7). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.18 |
This notification is generated when the operational
state of one or more virtual machines has been changed to migrating(9) from a state other than migrating(9). Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.19 |
This notification is generated when one or more virtual
machines have been crashed. Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.2 |
This notification is generated when the operational
state of a virtual machine has been changed to shuttingdown(10) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.20 |
This notification is generated when one or more virtual
machines have been deleted. Management stations are encouraged to subsequently poll the subset of virtual machines of interest for vmOperState. |
|
.1.3.6.1.2.1.236.0.3 |
This notification is generated when the operational
state of a virtual machine has been changed to shutdown(11) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.4 |
This notification is generated when the operational
state of a virtual machine has been changed to paused(8) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.5 |
This notification is generated when the operational
state of a virtual machine has been changed to suspending(5) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.6 |
This notification is generated when the operational
state of a virtual machine has been changed to suspended(6) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.7 |
This notification is generated when the operational
state of a virtual machine has been changed to resuming(7) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.8 |
This notification is generated when the operational
state of a virtual machine has been changed to migrating(9) from some other state. The other state is indicated by the included value of vmOperState. |
|
.1.3.6.1.2.1.236.0.9 |
This notification is generated when a virtual machine
has been crashed. The previous state of the virtual machine is indicated by the included value of vmOperState. |