﻿---
title: vSphere virtualmachine metricset
description: This is the virtualmachine metricset of the vSphere module. This is a default metricset. If the host module is unconfigured, this metricset is enabled...
url: https://www.elastic.co/elastic/docs-builder/docs/2869/reference/beats/metricbeat/metricbeat-metricset-vsphere-virtualmachine
products:
  - Beats
  - Metricbeat
applies_to:
  - Elastic Cloud Serverless: Generally available
  - Elastic Stack: Generally available
---

# vSphere virtualmachine metricset
This is the `virtualmachine` metricset of the vSphere module.
This is a default metricset. If the host module is unconfigured, this metricset is enabled by default.

## Fields

For a description of each field in the metricset, see the [exported fields](https://www.elastic.co/elastic/docs-builder/docs/2869/reference/beats/metricbeat/exported-fields-vsphere) section.
Here is an example document generated by this metricset:
```json
{
    "@timestamp": "2024-08-12T04:51:25.851Z",
    "event": {
        "dataset": "vsphere.virtualmachine",
        "duration": 115000,
        "module": "vsphere"
    },
    "metricset": {
        "name": "virtualmachine",
        "period": 10000
    },
    "service": {
        "address": "127.0.0.1:39149",
        "type": "vsphere"
    },
    "vsphere": {
        "virtualmachine": {
            "id": "vm-51",
            "name": "xt0nmfpv9",
            "uptime": 5348978,
            "status": "green",
            "host": {
                "id": "host-32",
                "hostname": "example.com"
            },
            "cpu": {
                "free": {
                    "mhz": 0
                },
                "used": {
                    "mhz": 161
                },
                "total": {
                    "mhz": 0
                }
            },
            "network": {
                "names": [
                    "PROD_VCF_VMS"
                ],
                "count": 1
            },
            "memory": {
                "used": {
                    "guest": {
                        "bytes": 686817280
                    },
                    "host": {
                        "bytes": 29027729408
                    }
                },
                "total": {
                    "guest": {
                        "bytes": 68719476736
                    }
                },
                "free": {
                    "guest": {
                        "bytes": 68032659456
                    }
                }
            },
            "network_names": [
                "PROD_VCF_VMS"
            ],
            "datastore": {
                "count": 1,
                "names": [
                    "VxRailtoup-Virtual-Datastore-bc1d-5aa310fb"
                ]
            },
            "os": "CentOS 4/5/6/7 (64-bit)",
            "snapshot": {
                "info": [
                    {
                        "id": 1,
                        "name": "VM Snapshot 7%2f3%2f2024, 4:01:21 PM",
                        "description": "Created to demo",
                        "createtime": "2024-07-03T20:01:34.329Z",
                        "state": "poweredOn"
                    },
                    {
                        "createtime": "2024-07-05T23:35:40.859Z",
                        "state": "poweredOn",
                        "id": 2,
                        "name": "VM Snapshot 7%2f5%2f2024, 7:35:37 PM",
                        "description": "backup"
                    }
                ],
                "count": 2
            }
        }
    }
}
```