[comment]: # ({28c0af3f-e6df368c})
# 2 虚拟机发现键字段

下表列出了由虚拟机相关发现键返回的字段。

| **监控项 键** | <   | <   |
|--|--|------|
| **Description** | **字段** | **检索内容** |
| **vmware.cluster.discovery** | <   | <   |
| Performs cluster discovery. | {\#CLUSTER.ID} | 集群标识符。 |
| ^ | {\#CLUSTER.NAME} | 集群名称。 |
| ^ | "resource_pool" | 一个array，包含资源池数据，包括资源组ID、标签array、资源池路径、虚拟机数量。<br><br>array结构：<br>`[{`<br>`"rpid":"resource group id",`<br>`"tags":[{}],`<br>`"rpath":"resource group path",`<br>`"vm_count":0`<br>`}]`<br><br>对于`"tags"` array结构，请参见“tags”字段。 |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| **vmware.datastore.discovery** | <   | <   |
| Performs datastore discovery. | {\#DATASTORE} | 数据存储名称。 |
| ^ | {\#DATASTORE.EXTENT} | 一个array，包含数据存储区段的分区ID和实例名称。<br><br>array结构：<br>`[{`<br>`"partitionid":1,`<br>`"instance":"name"`<br>`}]` |
| ^ | {\#DATASTORE.TYPE} | 数据存储类型。<br><br>值示例：`VMFS`、`NFS`、`vsan`等。 |
| ^ | {\#DATASTORE.UUID} | 数据存储标识符。 |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| **vmware.dc.discovery** | <   | <   |
| Performs datacenter discovery. | {\#DATACENTER} | 数据中心名称。 |
| ^ | {\#DATACENTERID} | 数据中心标识符。 |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| **vmware.dvswitch.discovery** | <   | <   |
| Performs vSphere distributed switches discovery. | {\#DVS.NAME} | 交换机名称。 |
| ^ | {\#DVS.UUID} | 交换机标识符。 |
| **vmware.hv.discovery** | <   | <   |
| Performs hypervisor discovery. | {\#HV.UUID} | 唯一的虚拟机管理程序标识符。 |
| ^ | {\#HV.ID} | 虚拟机管理程序标识符（HostSystem托管object名称）。 |
| ^ | {\#HV.NAME} | 虚拟机管理程序名称。 |
| ^ | {\#HV.NETNAME} | 虚拟机管理程序网络主机名。 |
| ^ | {\#HV.IP} | 虚拟机管理程序IP地址，可能为空。<br><br>在具有多个网络接口的HA配置情况下，接口选择优先级如下：<br>- 优先选择与vCenter IP在同一IP子网的IP；<br>- 优先选择具有默认网关的IP子网中的IP；<br>- 优先选择接口ID最小的IP。 |
| ^ | {\#CLUSTER.NAME} | 集群名称，可能为空。 |
| ^ | {\#DATACENTER.NAME} | 数据中心名称。 |
| ^ | {\#PARENT.NAME} | 存储虚拟机管理程序的容器名称。 |
| ^ | {\#PARENT.TYPE} | 存储虚拟机管理程序的容器类型。值可以是`Datacenter`、`Folder`、`ClusterComputeResource`、`VMware`，其中“VMware”表示未知容器类型。 |
| ^ | "resource_pool" | 一个array，包含资源池数据，包括资源组ID、标签array、资源池路径、虚拟机数量。<br><br>array结构：<br>`[{`<br>`"rpid":"resource group id",`<br>`"tags":[{}],`<br>`"rpath":"resource group path",`<br>`"vm_count":0`<br>`}]`<br><br>对于`"tags"` array结构，请参见“tags”字段。 |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| **vmware.hv.datastore.discovery** | <   | <   |
| Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore. | {\#DATASTORE} | 数据存储名称。 |
| ^ | {\#DATASTORE.TYPE} | 数据存储类型。<br><br>值示例：`VMFS`、`NFS`、`vsan`等。 |
| ^ | {\#DATASTORE.UUID} | 数据存储标识符。 |
| ^ | {\#MULTIPATH.COUNT} | 注册的数据存储路径数量。 |
| ^ | {\#MULTIPATH.PARTITION.COUNT} | 可用磁盘分区数量。 |
| ^ | "datastore_extent" | 一个array，包含数据存储区段的实例名称和分区ID。<br><br>array结构：<br>`[{`<br>`"partitionid":1,`<br>`"instance":"name"`<br>`}]` |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| **vmware.hv.net.if.discovery** | <   | <   |
| Performs hypervisor network interfaces discovery. | {\#IFNAME} | 接口名称。 |
| ^ | {\#IFDRIVER} | 接口驱动程序。 |
| ^ | {\#IFDUPLEX} | 接口双工设置。 |
| ^ | {\#IFSPEED} | 接口速度。 |
| ^ | {\#IFMAC} | 接口MAC地址。 |
| **vmware.vm.discovery** | <   | <   |
| Performs virtual machine discovery. | {\#VM.UUID} | 唯一的虚拟机标识符。 |
| ^ | {\#VM.ID} | 虚拟机标识符（VirtualMachine托管object名称）。 |
| ^ | {\#VM.NAME} | 虚拟机名称。 |
| ^ | {\#HV.NAME} | 虚拟机管理程序名称。 |
| ^ | {\#HV.UUID} | 唯一的虚拟机管理程序标识符。 |
| ^ | {\#HV.ID} | 虚拟机管理程序标识符（HostSystem托管object名称）。 |
| ^ | {\#CLUSTER.NAME} | 集群名称，可能为空。 |
| ^ | {\#DATACENTER.NAME} | 数据中心名称。 |
| ^ | {\#DATASTORE.NAME} | 数据存储名称。 |
| ^ | {\#DATASTORE.UUID} | 数据存储标识符。 |
| ^ | {\#VM.IP} | 虚拟机IP地址，可能为空。 |
| ^ | {\#VM.DNS} | 虚拟机DNS名称，可能为空。 |
| ^ | {\#VM.GUESTFAMILY} | 客户虚拟机操作系统家族，可能为空。 |
| ^ | {\#VM.GUESTFULLNAME} | 完整的客户虚拟机操作系统名称，可能为空。 |
| ^ | {\#VM.FOLDER} | 虚拟机父文件夹链，可用于嵌套组；文件夹名称用“/”连接。可能为空。 |
| ^ | {\#VM.TOOLS.STATUS} | VMware虚拟机工具状态。 |
| ^ | {\#VM.POWERSTATE} | VMware虚拟机电源状态（`poweredOff`、`poweredOn`或`suspended`）。 |
| ^ | {\#VM.RPOOL.ID} | 资源池标识符。 |
| ^ | {\#VM.RPOOL.PATH} | 完整的资源池路径，不包括“root”名称“Resources”。文件夹名称用“/”连接。 |
| ^ | {\#VM.SNAPSHOT.COUNT} | 虚拟机快照数量。 |
| ^ | "tags" | 一个array，包含带有标签名称、描述和类别的标签。<br><br>array结构：<br>`[{`<br>`"tag":"tag name",`<br>`"tag_description":"tag description",`<br>`"category":"tag category"`<br>`}]` |
| ^ | "vm_customattribute" | 一个array，包含虚拟机自定义属性（如果已定义）。<br><br>array结构：<br>`[{`<br>`"name":"custom field name",`<br>`"value":"custom field value"`<br>`}]` |
| ^ | "net_if" | 一个array，包含虚拟机网络接口。<br><br>array结构：<br>`[{`<br>`"ifname": "interface name",`<br>`"ifdesc": "interface description",`<br>`"ifmac": "00:00:00:00:00:00",`<br>`"ifconnected": true,`<br>`"iftype": "interface type",`<br>`"ifbackingdevice": "interface backing device",`<br>`"ifdvswitch_uuid": "interface switch uuid",`<br>`"ifdvswitch_portgroup": "interface switch port group",`<br>`"ifdvswitch_port": "interface switch port",`<br>`"ifip": ["interface ip addresses"]`<br>`}]`<br><br>有关返回数据的描述，请参见“vmware.vm.net.if.discovery”监控项键。 |
| **vmware.vm.net.if.discovery** | <   | <   |
| Performs virtual machine network interface discovery. | {\#IFNAME} | 网络接口名称。 |
| ^ | {\#IFDESC} | 接口描述。 |
| ^ | {\#IFMAC} | 接口MAC地址。 |
| ^ | {\#IFCONNECTED} | 接口连接状态（`false` - 断开连接；`true` - 已连接）。 |
| ^ | {\#IFTYPE} | 接口类型。 |
| ^ | {\#IFBACKINGDEVICE} | 后端设备名称。 |
| ^ | {\#IFDVSWITCH.UUID} | 唯一的vSphere分布式交换机标识符。 |
| ^ | {\#IFDVSWITCH.PORTGROUP} | 分布式端口组。 |
| ^ | {\#IFDVSWITCH.PORT} | vSphere分布式交换机端口。 |
| ^ | "ifip" | 一个array，包含接口地址。 |
| **vmware.vm.vfs.dev.discovery** | <   | <   |
| Performs virtual machine disk device discovery. | {\#DISKNAME} | 磁盘设备名称。 |
| **vmware.vm.vfs.fs.discovery** | <   | <   |
| Performs virtual machine file system discovery. | {\#FSNAME} | 文件系统名称。 |

[comment]: # ({/28c0af3f-e6df368c})