VM-MIB
113 objects
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).
Imported Objects
| IANA-STORAGE-MEDIA-TYPE-MIB | IANAStorageMediaType |
| IF-MIB | InterfaceIndexOrZero |
| SNMP-FRAMEWORK-MIB | SnmpAdminString |
| SNMPv2-CONF | MODULE-COMPLIANCE NOTIFICATION-GROUP OBJECT-GROUP |
| SNMPv2-SMI | Counter64 Integer32 mib-2 MODULE-IDENTITY NOTIFICATION-TYPE OBJECT-TYPE TimeTicks |
| SNMPv2-TC | PhysAddress TEXTUAL-CONVENTION TruthValue |
| UUID-TC-MIB | UUIDorZero |
| OID | Name | Access | Status | Description |
|---|---|---|---|---|
| 1.3.6.1.2.1.236 | IdentityvmMIB | 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… | ||
| 1.3.6.1.2.1.236.0 | NodevmNotifications | |||
| 1.3.6.1.2.1.236.0.1 | NotificationvmRunning | current | 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 indicat… | |
| 1.3.6.1.2.1.236.0.2 | NotificationvmShuttingdown | current | 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 i… | |
| 1.3.6.1.2.1.236.0.3 | NotificationvmShutdown | current | 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 indic… | |
| 1.3.6.1.2.1.236.0.4 | NotificationvmPaused | current | 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 indicate… | |
| 1.3.6.1.2.1.236.0.5 | NotificationvmSuspending | current | 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 indi… | |
| 1.3.6.1.2.1.236.0.6 | NotificationvmSuspended | current | 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 indic… | |
| 1.3.6.1.2.1.236.0.7 | NotificationvmResuming | current | 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 indica… | |
| 1.3.6.1.2.1.236.0.8 | NotificationvmMigrating | current | 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 indic… | |
| 1.3.6.1.2.1.236.0.9 | NotificationvmCrashed | current | 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 vmOperS… | |
| 1.3.6.1.2.1.236.0.10 | NotificationvmDeleted | current | 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 vmOperStat… | |
| 1.3.6.1.2.1.236.0.11 | NotificationvmBulkRunning | current | 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 runni… | |
| 1.3.6.1.2.1.236.0.12 | NotificationvmBulkShuttingdown | current | 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 shutting… | |
| 1.3.6.1.2.1.236.0.13 | NotificationvmBulkShutdown | current | 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).… | |
| 1.3.6.1.2.1.236.0.14 | NotificationvmBulkPaused | current | 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). Mana… | |
| 1.3.6.1.2.1.236.0.15 | NotificationvmBulkSuspending | current | 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(… | |
| 1.3.6.1.2.1.236.0.16 | NotificationvmBulkSuspended | current | 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)… | |
| 1.3.6.1.2.1.236.0.17 | NotificationvmBulkResuming | current | 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). … | |
| 1.3.6.1.2.1.236.0.18 | NotificationvmBulkMigrating | current | 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)… | |
| 1.3.6.1.2.1.236.0.19 | NotificationvmBulkCrashed | current | This notification is generated when one or more virtual machines have been crashed. Management stations are encouraged to subsequently poll the subset of virtu… | |
| 1.3.6.1.2.1.236.0.20 | NotificationvmBulkDeleted | current | This notification is generated when one or more virtual machines have been deleted. Management stations are encouraged to subsequently poll the subset of virtu… | |
| 1.3.6.1.2.1.236.1 | NodevmObjects | |||
| 1.3.6.1.2.1.236.1.1 | NodevmHypervisor | |||
| 1.3.6.1.2.1.236.1.1.1 | ScalarvmHvSoftware | read-only | current | A textual description of the hypervisor software. This value SHOULD NOT include its version as it SHOULD be included in 'vmHvVersion'. |
| 1.3.6.1.2.1.236.1.1.2 | ScalarvmHvVersion | read-only | current | A textual description of the version of the hypervisor software. |
| 1.3.6.1.2.1.236.1.1.3 | ScalarvmHvObjectID | read-only | current | The vendor's authoritative identification of the hypervisor software contained in the entity. This value is allocated within the SMI enterprises subtree (1.3.6… |
| 1.3.6.1.2.1.236.1.1.4 | ScalarvmHvUpTime | read-only | current | The time (in centiseconds) since the hypervisor was last re-initialized. Note that this is different from sysUpTime in the SNMPv2-MIB (RFC 3418) and hrSystemUp… |
| 1.3.6.1.2.1.236.1.2 | ScalarvmNumber | read-only | current | The number of virtual machines (regardless of their current state) present on this hypervisor. |
| 1.3.6.1.2.1.236.1.3 | ScalarvmTableLastChange | read-only | current | The value of vmHvUpTime at the time of the last creation or deletion of an entry in the vmTable. |
| 1.3.6.1.2.1.236.1.4 | TablevmTable | not-accessible | current | A list of virtual machine entries. The number of entries is given by the value of vmNumber. |
| 1.3.6.1.2.1.236.1.4.1 | RowvmEntry | not-accessible | current | An entry containing management information applicable to a particular virtual machine. |
| 1.3.6.1.2.1.236.1.4.1.1 | ColumnvmIndex | not-accessible | current | A unique value, greater than zero, identifying the virtual machine. The value assigned to a given virtual machine may not persist across re-initialization of t… |
| 1.3.6.1.2.1.236.1.4.1.2 | ColumnvmName | read-only | current | A textual name of the virtual machine. |
| 1.3.6.1.2.1.236.1.4.1.3 | ColumnvmUUID | read-only | current | The virtual machine's 128-bit Universally Unique Identifier (UUID) or the zero-length string when a UUID is not available. If set, the UUID MUST uniquely ident… |
| 1.3.6.1.2.1.236.1.4.1.4 | ColumnvmOSType | read-only | current | A textual description containing operating system information installed on the virtual machine. This value corresponds to the operating system the hypervisor a… |
| 1.3.6.1.2.1.236.1.4.1.5 | ColumnvmAdminState | read-only | current | The administrative state of the virtual machine. |
| 1.3.6.1.2.1.236.1.4.1.6 | ColumnvmOperState | read-only | current | The operational state of the virtual machine. |
| 1.3.6.1.2.1.236.1.4.1.7 | ColumnvmAutoStart | read-only | current | The autostart configuration of the virtual machine. If this value is enable(2), the virtual machine automatically starts at the next initialization of the hype… |
| 1.3.6.1.2.1.236.1.4.1.8 | ColumnvmPersistent | read-only | current | This value indicates whether the virtual machine has a persistent configuration, which means the virtual machine will still exist after its shutdown. |
| 1.3.6.1.2.1.236.1.4.1.9 | ColumnvmCurCpuNumber | read-only | current | The number of virtual CPUs currently assigned to the virtual machine. |
| 1.3.6.1.2.1.236.1.4.1.10 | ColumnvmMinCpuNumber | read-only | current | The minimum number of virtual CPUs that are assigned to the virtual machine when it is in a power-on state. The value -1 indicates that there is no hard bounda… |
| 1.3.6.1.2.1.236.1.4.1.11 | ColumnvmMaxCpuNumber | read-only | current | The maximum number of virtual CPUs that are assigned to the virtual machine when it is in a power-on state. The value -1 indicates that there is no limit. |
| 1.3.6.1.2.1.236.1.4.1.12 | ColumnvmMemUnit | read-only | current | The multiplication unit in bytes for vmCurMem, vmMinMem, and vmMaxMem. For example, when this value is 1024, the memory size unit for vmCurMem, vmMinMem, and v… |
| 1.3.6.1.2.1.236.1.4.1.13 | ColumnvmCurMem | read-only | current | The current memory size currently allocated to the virtual memory module in the unit designated by vmMemUnit. |
| 1.3.6.1.2.1.236.1.4.1.14 | ColumnvmMinMem | read-only | current | The minimum memory size defined to the virtual machine in the unit designated by vmMemUnit. The value -1 indicates that there is no hard boundary for the minim… |
| 1.3.6.1.2.1.236.1.4.1.15 | ColumnvmMaxMem | read-only | current | The maximum memory size defined to the virtual machine in the unit designated by vmMemUnit. The value -1 indicates that there is no limit. |
| 1.3.6.1.2.1.236.1.4.1.16 | ColumnvmUpTime | read-only | current | The time (in centiseconds) since the administrative state of the virtual machine was last changed from shutdown(4) to running(1). |
| 1.3.6.1.2.1.236.1.4.1.17 | ColumnvmCpuTime | read-only | current | The total CPU time used in microseconds. If the number of virtual CPUs is larger than 1, vmCpuTime may exceed real time. Discontinuities in the value of this c… |
| 1.3.6.1.2.1.236.1.5 | TablevmCpuTable | not-accessible | current | The table of virtual CPUs provided by the hypervisor. |
| 1.3.6.1.2.1.236.1.5.1 | RowvmCpuEntry | not-accessible | current | An entry for one virtual processor assigned to a virtual machine. |
| 1.3.6.1.2.1.236.1.5.1.1 | ColumnvmCpuIndex | not-accessible | current | A unique value identifying a virtual CPU assigned to the virtual machine. |
| 1.3.6.1.2.1.236.1.5.1.2 | ColumnvmCpuCoreTime | read-only | current | The total CPU time used by this virtual CPU in microseconds. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and … |
| 1.3.6.1.2.1.236.1.6 | TablevmCpuAffinityTable | not-accessible | current | A list of CPU affinity entries of a virtual CPU. |
| 1.3.6.1.2.1.236.1.6.1 | RowvmCpuAffinityEntry | not-accessible | current | An entry containing CPU affinity associated with a particular virtual machine. |
| 1.3.6.1.2.1.236.1.6.1.2 | ColumnvmCpuPhysIndex | not-accessible | current | A value identifying a physical CPU on the hypervisor. On systems implementing the HOST-RESOURCES-MIB, the value MUST be the same value that is used as the inde… |
| 1.3.6.1.2.1.236.1.6.1.3 | ColumnvmCpuAffinity | read-only | current | The CPU affinity of this virtual CPU to the physical CPU represented by 'vmCpuPhysIndex'. |
| 1.3.6.1.2.1.236.1.7 | TablevmStorageTable | not-accessible | current | The conceptual table of virtual storage devices attached to the virtual machine. |
| 1.3.6.1.2.1.236.1.7.1 | RowvmStorageEntry | not-accessible | current | An entry for one virtual storage device attached to the virtual machine. |
| 1.3.6.1.2.1.236.1.7.1.1 | ColumnvmStorageVmIndex | not-accessible | current | This value identifies the virtual machine (guest) this storage device has been allocated to. The value zero indicates that the storage device is currently not … |
| 1.3.6.1.2.1.236.1.7.1.2 | ColumnvmStorageIndex | not-accessible | current | A unique value identifying a virtual storage device allocated to the virtual machine. |
| 1.3.6.1.2.1.236.1.7.1.3 | ColumnvmStorageParent | read-only | current | The value of hrStorageIndex, which is the parent (i.e., physical) device of this virtual device on systems implementing the HOST-RESOURCES-MIB. The value zero … |
| 1.3.6.1.2.1.236.1.7.1.4 | ColumnvmStorageSourceType | read-only | current | The source type of the virtual storage device. |
| 1.3.6.1.2.1.236.1.7.1.5 | ColumnvmStorageSourceTypeString | read-only | current | A (detailed) textual string of the source type of the virtual storage device. For example, this represents the specific format name of the sparse file. |
| 1.3.6.1.2.1.236.1.7.1.6 | ColumnvmStorageResourceID | read-only | current | A textual string that represents the resource identifier of the virtual storage. For example, this contains the path to the disk image file that corresponds to… |
| 1.3.6.1.2.1.236.1.7.1.7 | ColumnvmStorageAccess | read-only | current | The access permission of the virtual storage device. |
| 1.3.6.1.2.1.236.1.7.1.8 | ColumnvmStorageMediaType | read-only | current | The media type of the virtual storage device. |
| 1.3.6.1.2.1.236.1.7.1.9 | ColumnvmStorageMediaTypeString | read-only | current | A (detailed) textual string of the virtual storage media. For example, this represents the specific driver name of the emulated media such as 'IDE' and 'SCSI'. |
| 1.3.6.1.2.1.236.1.7.1.10 | ColumnvmStorageSizeUnit | read-only | current | The multiplication unit in bytes for vmStorageDefinedSize and vmStorageAllocatedSize. For example, when this value is 1048576, the storage size unit for vmStor… |
| 1.3.6.1.2.1.236.1.7.1.11 | ColumnvmStorageDefinedSize | read-only | current | The defined virtual storage size defined in the unit designated by vmStorageSizeUnit. If this information is not available, this value MUST be -1. |
| 1.3.6.1.2.1.236.1.7.1.12 | ColumnvmStorageAllocatedSize | read-only | current | The storage size allocated to the virtual storage from a physical storage in the unit designated by vmStorageSizeUnit. When the virtual storage is block device… |
| 1.3.6.1.2.1.236.1.7.1.13 | ColumnvmStorageReadIOs | read-only | current | The number of read I/O requests. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdmi… |
| 1.3.6.1.2.1.236.1.7.1.14 | ColumnvmStorageWriteIOs | read-only | current | The number of write I/O requests. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrative state (vmAdm… |
| 1.3.6.1.2.1.236.1.7.1.15 | ColumnvmStorageReadOctets | read-only | current | The total number of bytes read from this device. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrati… |
| 1.3.6.1.2.1.236.1.7.1.16 | ColumnvmStorageWriteOctets | read-only | current | The total number of bytes written to this device. Discontinuities in the value of this counter can occur at re-initialization of the hypervisor and administrat… |
| 1.3.6.1.2.1.236.1.7.1.17 | ColumnvmStorageReadLatency | read-only | current | The total number of microseconds read requests have been queued for this device. This would typically be implemented by storing the high precision system times… |
| 1.3.6.1.2.1.236.1.7.1.18 | ColumnvmStorageWriteLatency | read-only | current | The total number of microseconds write requests have been queued for this device. This would typically be implemented by storing the high precision system time… |
| 1.3.6.1.2.1.236.1.8 | TablevmNetworkTable | not-accessible | current | The conceptual table of virtual network interfaces attached to the virtual machine. |
| 1.3.6.1.2.1.236.1.8.1 | RowvmNetworkEntry | not-accessible | current | An entry for one virtual network interface attached to the virtual machine. |
| 1.3.6.1.2.1.236.1.8.1.1 | ColumnvmNetworkIndex | not-accessible | current | A unique value identifying a virtual network interface allocated to the virtual machine. |
| 1.3.6.1.2.1.236.1.8.1.2 | ColumnvmNetworkIfIndex | read-only | current | The value of ifIndex, which corresponds to this virtual network interface. If this device is not represented in the ifTable, then this value MUST be zero. |
| 1.3.6.1.2.1.236.1.8.1.3 | ColumnvmNetworkParent | read-only | current | The value of ifIndex, which corresponds to the parent (i.e., physical) device of this virtual device. The value zero denotes this virtual device is not any chi… |
| 1.3.6.1.2.1.236.1.8.1.4 | ColumnvmNetworkModel | read-only | current | A textual string containing the (emulated) model of the virtual network interface. For example, this value is 'virtio' when the emulation driver model is virti… |
| 1.3.6.1.2.1.236.1.8.1.5 | ColumnvmNetworkPhysAddress | read-only | current | The Media Access Control (MAC) address of the virtual network interface. |
| 1.3.6.1.2.1.236.1.9 | ScalarvmPerVMNotificationsEnabled | read-write | current | Indicates if the notification generator will send notifications per virtual machine. Changes to this object MUST NOT persist across re-initialization of the ma… |
| 1.3.6.1.2.1.236.1.10 | ScalarvmBulkNotificationsEnabled | read-write | current | Indicates if the notification generator will send notifications per set of virtual machines. Changes to this object MUST NOT persist across re-initialization o… |
| 1.3.6.1.2.1.236.1.11 | ScalarvmAffectedVMs | accessible-for-notify | current | A complete list of virtual machines whose state has changed. This object is the only object sent with bulk notifications. |
| 1.3.6.1.2.1.236.2 | NodevmConformance | |||
| 1.3.6.1.2.1.236.2.1 | NodevmCompliances | |||
| 1.3.6.1.2.1.236.2.1.1 | CompliancevmFullCompliances | current | Compliance statement for implementations supporting read/write access, according to the object definitions. | |
| 1.3.6.1.2.1.236.2.1.2 | CompliancevmReadOnlyCompliances | read-only | current | Compliance statement for implementations supporting only read-only access. |
| 1.3.6.1.2.1.236.2.2 | NodevmGroups | |||
| 1.3.6.1.2.1.236.2.2.1 | GroupvmHypervisorGroup | current | A collection of objects providing insight into the hypervisor itself. | |
| 1.3.6.1.2.1.236.2.2.2 | GroupvmVirtualMachineGroup | current | A collection of objects providing insight into the virtual machines controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.3 | GroupvmCpuGroup | current | A collection of objects providing insight into the virtual machines controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.4 | GroupvmCpuAffinityGroup | current | A collection of objects providing insight into the virtual machines controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.5 | GroupvmStorageGroup | current | A collection of objects providing insight into the virtual storage devices controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.6 | GroupvmNetworkGroup | current | A collection of objects providing insight into the virtual network interfaces controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.7 | GroupvmPerVMNotificationOptionalGroup | current | 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.8 | GroupvmBulkNotificationsVariablesGroup | current | The variables used in vmBulkNotificationOptionalGroup virtual network interfaces controlled by a hypervisor. | |
| 1.3.6.1.2.1.236.2.2.9 | GroupvmBulkNotificationOptionalGroup | current | A collection of notifications for bulk notification of changes to virtual machine state (vmOperState) as reported by a given hypervisor. |
Type Definitions
| Name | Syntax | Status | Description |
|---|---|---|---|
| VirtualMachineAdminState | INTEGER { running(1), suspended(2), paused(3), shutdown(4) } | current | The administrative state of a virtual machine: running(1) The administrative state of the virtual machine indicating the virtual machine is currently online or should be brought online. suspended(2) The administrative s… |
| VirtualMachineAutoStart | INTEGER { unknown(1), enabled(2), disabled(3) } | current | The autostart configuration of a virtual machine: unknown(1) The autostart configuration is unknown, e.g., because the implementation failed to obtain the autostart configuration from the hypervisor. enabled(2) The auto… |
| VirtualMachineCpuIndex | Integer32 (1..2147483647) | current | A unique value for each virtual machine, greater than zero, identifying a virtual CPU assigned to a virtual machine. The value for each virtual CPU MUST remain constant at least from one re-initialization of the hypervi… |
| VirtualMachineIndex | Integer32 (1..2147483647) | current | A unique value, greater than zero, identifying a virtual machine. The value for each virtual machine MUST remain constant at least from one re-initialization of the hypervisor to the next re-initialization. |
| VirtualMachineIndexOrZero | Integer32 (0..2147483647) | current | This textual convention is an extension of the VirtualMachineIndex convention. This extension permits the additional value of zero. The meaning of the value zero is object-specific and MUST therefore be defined as part … |
| VirtualMachineList | OCTET STRING | current | Each octet within this value specifies a set of eight virtual machine vmIndex values, with the first octet specifying virtual machine 1 through 8, the second octet specifying virtual machine 9 through 16, etc. Within ea… |
| VirtualMachineNetworkIndex | Integer32 (1..2147483647) | current | A unique value for each virtual machine, greater than zero, identifying a virtual network interface allocated to the virtual machine. The value for each virtual network interface MUST remain constant at least from one r… |
| VirtualMachineOperState | INTEGER { unknown(1), other(2), preparing(3), running(4), suspending(5), suspended(6), resuming(7), paused(8), migrating(9), shuttingdown(10), shutdown(11), crashed(12) } | current | The operational state of a virtual machine: unknown(1) The operational state of the virtual machine is unknown, e.g., because the implementation failed to obtain the state from the hypervisor. other(2) The operational s… |
| VirtualMachinePersistent | INTEGER { unknown(1), persistent(2), transient(3) } | current | This value indicates whether a virtual machine has a persistent configuration, which means the virtual machine will still exist after shutting down: unknown(1) The persistent configuration is unknown, e.g., because the … |
| VirtualMachineStorageAccess | INTEGER { unknown(1), readwrite(2), readonly(3) } | current | The access permission of a virtual storage: unknown(1) The access permission of the virtual storage is unknown. readwrite(2) The virtual storage is a read-write device. readonly(3) The virtual storage is a read-only dev… |
| VirtualMachineStorageIndex | Integer32 (1..2147483647) | current | A unique value for each virtual machine, greater than zero, identifying a virtual storage device allocated to a virtual machine. The value for each virtual storage device MUST remain constant at least from one re-initia… |
| VirtualMachineStorageSourceType | INTEGER { unknown(1), other(2), block(3), raw(4), sparse(5), network(6) } | current | The source type of a virtual storage device: unknown(1) The source type is unknown, e.g., because the implementation failed to obtain the media type from the hypervisor. other(2) The source type is other than those defi… |