This is a translation of the original English documentation page. Help us make it better.

JSON examples for VMware items

Overview

This section provides additional information about JSON objects returned by various VMware items.

vmware.*.alarms.get

The items vmware.alarms.get[], vmware.cluster.alarms.get[], vmware.datastore.alarms.get[], vmware.dc.alarms.get[], vmware.hv.alarms.get[], vmware.vm.alarms.get[] return JSON objects with the following structure (values are provided as an example):

{
           "alarms": [ 
               { 
                   "name": "Host connection and power state", 
                   "system_name": "alarm.HostConnectionStateAlarm", 
                   "description": "Default alarm to monitor host connection and power state", 
                   "enabled": true, 
                   "key": "alarm-1.host-2013", 
                   "time": "2022-06-27T05:27:38.759976Z", 
                   "overall_status": "red", 
                   "acknowledged": false 
               }, 
               { 
                   "name": "Host memory usage", 
                   "system_name": "alarm.HostMemoryUsageAlarm", 
                   "description": "Default alarm to monitor host memory usage", 
                   "enabled": true, 
                   "key": "alarm-4.host-1004", 
                   "time": "2022-05-16T13:32:42.47863Z", 
                   "overall_status": "yellow", 
                   "acknowledged": false 
               }, 
               { 
                   // other alarms 
               } 
           ]
       } 

vmware.*.tags.get

The items vmware.cluster.tags.get[], vmware.datastore.tags.get[], vmware.dc.tags.get[], vmware.hv.tags.get[], vmware.vm.tags.get[] return JSON objects with the following structure (values are provided as an example):

{
           "tags": [ 
               { 
                   "name": "Windows", 
                   "description": "tag for cat OS type", 
                   "category": "OS type" 
               }, 
               { 
                   "name": "SQL Server", 
                   "description": "tag for cat application name", 
                   "category": "application name" 
               }, 
               { 
                   // other tags 
               } 
           ] 
       }

vmware.hv.diskinfo.get

The item vmware.hv.diskinfo.get[] returns JSON objects with the following structure (values are provided as an example):

[
         {
           "instance": "mpx.vmhba32:C0:T0:L0",
           "hv_uuid": "8002299e-d7b9-8728-d224-76004bbb6100",
           "datastore_uuid": "",
           "operational_state": [
             "ok"
           ],
           "lun_type": "disk",
           "queue_depth": 1,
           "model": "USB DISK",
           "vendor": "SMI Corp",
           "revision": "1100",
           "serial_number": "CCYYMMDDHHmmSS9S62CK",
           "vsan": {}
         },
         {
           // other instances
         }
       ]

vmware.dvswitch.fetchports.get

The item vmware.dvswitch.fetchports.get[] returns JSON objects with the following structure (values are provided as an example):

{ 
           "FetchDVPortsResponse": 
           { 
               "returnval": [ 
                   { 
                       "key": "0", 
                       "dvsUuid": "50 36 6a 24 25 c0 10 9e-05 4a f6 ea 4e 3d 09 88", 
                       "portgroupKey": "dvportgroup-2023", 
                       "proxyHost": 
                       { 
                           "@type": "HostSystem", 
                           "#text": "host-2021" 
                       }, 
                       "connectee": 
                       { 
                           "connectedEntity": 
                           { 
                               "@type": "HostSystem", 
                               "#text": "host-2021" 
                           }, 
                           "nicKey": "vmnic0", 
                           "type": "pnic" 
                       }, 
                       "conflict": "false", 
                       "state": 
                       { 
                           "runtimeInfo": 
                           { 
                               "linkUp": "true", 
                               "blocked": "false", 
                               "vlanIds": 
                               { 
                                   "start": "0", 
                                   "end": "4094" 
                               }, 
                               "trunkingMode": "true", 
                               "linkPeer": "vmnic0", 
                               "macAddress": "00:00:00:00:00:00", 
                               "statusDetail": null, 
                               "vmDirectPathGen2Active": "false", 
                               "vmDirectPathGen2InactiveReasonOther": "portNptIncompatibleConnectee" 
                           }, 
                           "stats": 
                           { 
                               "packetsInMulticast": "2385470", 
                               "packetsOutMulticast": "45", 
                               "bytesInMulticast": "309250248", 
                               "bytesOutMulticast": "5890", 
                               "packetsInUnicast": "155601537", 
                               "packetsOutUnicast": "113008658", 
                               "bytesInUnicast": "121609489384", 
                               "bytesOutUnicast": "47240279759", 
                               "packetsInBroadcast": "1040420", 
                               "packetsOutBroadcast": "7051",
                               "bytesInBroadcast": "77339771", 
                               "bytesOutBroadcast": "430392", 
                               "packetsInDropped": "0", 
                               "packetsOutDropped": "0", 
                               "packetsInException": "0", 
                               "packetsOutException": "0" 
                           } 
                       }, 
                       "connectionCookie": "1702765133", 
                       "lastStatusChange": "2022-03-25T14:01:11Z", 
                       "hostLocalPort": "false" 
                   }, 
                   { 
                       //other keys
                   } 
               ] 
           } 
       }

vmware.hv.hw.sensors.get

The item vmware.hv.hw.sensors.get[] returns JSON objects with the following structure (values are provided as an example):

{
           "val": 
               { 
                   "@type": "HostHardwareStatusInfo", 
                   "storageStatusInfo": [ 
                       { 
                           "name": "Intel Corporation HD Graphics 630 #2", 
                           "status": 
                               { 
                                   "label": "Unknown", 
                                   "summary": "Cannot report on the current status of the physical element",
                                   "key": "Unknown" 
                               } 
                       }, 
                       { 
                           "name": "Intel Corporation 200 Series/Z370 Chipset Family USB 3.0 xHCI Controller #20",
                           "status": 
                               { 
                                   "label": "Unknown", 
                                   "summary": "Cannot report on the current status of the physical element", 
                                   "key": "Unknown" 
                               } 
                       }, 
                       { 
                           // other hv hw sensors 
                       } 
                   ] 
               }
       } 

vmware.hv.sensors.get

The item vmware.hv.sensors.get[] returns JSON objects with the following structure (values are provided as an example):

{ 
           "val": 
               { 
                   "@type": "ArrayOfHostNumericSensorInfo", "HostNumericSensorInfo": [ 
                       { 
                           "@type": "HostNumericSensorInfo", 
                           "name": "System Board 1 PwrMeter Output --- Normal", 
                           "healthState": 
                               { 
                                   "label": "Green", 
                                   "summary": "Sensor is operating under normal conditions", 
                                   "key": "green" 
                               }, 
                           "currentReading": "10500", 
                           "unitModifier": "-2", 
                           "baseUnits": "Watts", 
                           "sensorType": "other" 
                       }, 
                       { 
                           "@type": "HostNumericSensorInfo", 
                           "name": "Power Supply 1 PS 1 Output --- Normal", 
                           "healthState":
                               { 
                                   "label": "Green", 
                                   "summary": "Sensor is operating under normal conditions", 
                                   "key": "green" 
                               }, 
                           "currentReading": "10000", 
                           "unitModifier": "-2", 
                           "baseUnits": "Watts", 
                           "sensorType": "power" 
                       }, 
                       { 
                           // other hv sensors 
                       } 
                   ] 
               } 
       } 

vmware.vm.snapshot.get

If any snapshots exist, the item vmware.snapshot.get[] returns a JSON object with the following structure (values are provided as an example):

{
         "snapshot": [
           {
             "name": "VM Snapshot 4%2f1%2f2022, 9:16:39 AM",
             "description": "Descr 1",
             "createtime": "2022-04-01T06:16:51.761Z",
             "size": 5755795171,
             "uniquesize": 5755795171
           },
           {
             "name": "VM Snapshot 4%2f1%2f2022, 9:18:21 AM",
             "description": "Descr 2",
             "createtime": "2022-04-01T06:18:29.164999Z",
             "size": 118650595,
             "uniquesize": 118650595
           },
           {
             "name": "VM Snapshot 4%2f1%2f2022, 9:37:29 AM",
             "description": "Descr 3",
             "createtime": "2022-04-01T06:37:53.534999Z",
             "size": 62935016,
             "uniquesize": 62935016
           }
         ],
         "count": 3,
         "latestdate": "2022-04-01T06:37:53.534999Z",
         "latestage": 22729203,
         "oldestdate": "2022-04-01T06:16:51.761Z",
         "oldestage": 22730465,
         "size": 5937380782,
         "uniquesize": 5937380782
       }

If no snapshot exists, the item vmware.snapshot.get[] returns a JSON object with empty values:

{
         "snapshot": [],
         "count": 0,
         "latestdate": null,
         "latestage": 0,
         "oldestdate": null,
         "oldestage": 0,
         "size": 0,
         "uniquesize": 0
       }