# Managed Object - VsanDiagnosticsSystem(vim.cluster.VsanDiagnosticsSystem)

See also
  ClusterComputeResource, ComputeResource, HostSystem, Task, VsanDiagnosticsThreshold, VsanIODiagnosticsInstance, VsanIODiagnosticsInstanceQuerySpec, VsanIODiagnosticsTarget, VsanIODiagnosticsTargetStats, VsanNetworkDiagnostics
Since
  vSAN API vSAN 7.0U2

## Managed Object Description

This managed object provides the diagnostics service that operates at cluster level. It runs the periodical diagnostics on the vSAN related statistics, as well as the on-demand diagnostics operation, e.g., the diagnostics of the IOs for a certain virtual machine. The ManagedEntity can be accessed with MOID of 'vsan-cluster-diagnostics-system' through vSAN service at at vCenter side.

Properties

Name | Type | Description
--- | --- | ---
None

Methods

Methods defined in this Managed Object
QueryIODiagnosticsInstances, QueryIODiagnosticsStats, StartIODiagnosticsTask, VsanGetThresholds, VsanQueryNetworkDiagnostics, VsanSetThresholds

# QueryIODiagnosticsInstances(queryIODiagnosticsInstances)

Query the completed diagnostics instances by the given query spec.

Required Privileges
  None
Since
  vSAN API vSAN 7.0U3

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
querySpec P | VsanIODiagnosticsInstanceQuerySpec | The spec for instance query. Since vSAN API vSAN 7.0U3
cluster* P | ManagedObjectReference to a ClusterComputeResource | The cluster where the diagnostics is performed, ignored when calling against ESXi hosts. Since vSAN API vSAN 7.0U3

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
VsanIODiagnosticsInstance[] | The list of the completed diagnostics instances.

Faults

Type | Description
--- | ---
InvalidArgument | Thrown if the query spec is not valid.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault | Thrown if the caller doesn't have the required privilege or if the vSAN performance service is disabled.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="QueryIODiagnosticsInstances" type="vsan:QueryIODiagnosticsInstancesRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="QueryIODiagnosticsInstancesResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VsanIODiagnosticsInstance" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# QueryIODiagnosticsStats(queryIODiagnosticsStats)

Query the IO diagnostics stats according to the given diagnostics instance name.

Required Privileges
  None
Since
  vSAN API vSAN 7.0U3

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
instanceName P | xsd:string | The completed diagnostics instance name. Since vSAN API vSAN 7.0U3
cluster* P | ManagedObjectReference to a ClusterComputeResource | The cluster where the diagnostics is performed. Since vSAN API vSAN 7.0U3

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
VsanIODiagnosticsTargetStats[] | The diagnostics stats.

Faults

Type | Description
--- | ---
InvalidArgument | Thrown if the given diagnostics instance name represent a running instance.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault | Thrown if the caller doesn't have the required privilege or if the vSAN performance service is disabled.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="QueryIODiagnosticsStats" type="vsan:QueryIODiagnosticsStatsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="QueryIODiagnosticsStatsResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VsanIODiagnosticsTargetStats" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# StartIODiagnosticsTask(startIODiagnosticsTask)

Start IO diagnostics task against the given targets running on vSAN datastore. It's not supported to run multiple diagnostics tasks at the same time. You need either cancel the running task or wait until it completes before starting a new diagnostics task.

Required Privileges
  None
Since
  vSAN API vSAN 7.0U3

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
targets P | VsanIODiagnosticsTarget[] | The targets to run the diagnostics. Since vSAN API vSAN 7.0U3
cluster* P | ManagedObjectReference to a ClusterComputeResource | The cluster where the targets belong to, ignored when calling against ESXi hosts. Since vSAN API vSAN 7.0U3
duration* P | xsd:long | The duration time in seconds to run diagnostics. The valid range is [300, 3600], default is 300. Since vSAN API vSAN 7.0U3

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
ManagedObjectReference to a Task | The task that runs the diagnostics.

Faults

Type | Description
--- | ---
InvalidArgument | Thrown if the targets are not valid.
NotSupported | Thrown if there's already a running diagnostics task.
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
VsanFault | Thrown if the caller doesn't have the required privilege or if the pre-check tests failed.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="StartIODiagnosticsTask" type="vsan:StartIODiagnosticsTaskRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="StartIODiagnosticsTaskResponse"> <complexType> <sequence> <element name="returnval" type="vsan:ManagedObjectReference"/> </sequence> </complexType> </element>

# VsanGetThresholds(getThresholds)

Get the threshold. If "entityType" is not set, all threshold settings will be returned; If "entityType" is set but "metric" is not set, threshold settings for the specified "entityType" will be returned; If threshold settings doesn't exist for "entityType", empty result ([]) will be returned; If both "entityType" and "metric" are set, threshold settings for the specified "entityType" and "metric" will be returned; If threshold settings doesn't exist for either "entityType" or "metric", empty result ([]) will be returned. If "metric" is set but "entityType" is not set, "metric" will be ignored and all threshold settings will be returned.

Required Privileges
  System.Read

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
cluster P | ManagedObjectReference to a ComputeResource | The cluster where the threshold is to get from Since vSAN API vSAN 7.0U2
entityType* P | xsd:string | Get threshold only for the specified entity type. Since vSAN API vSAN 7.0U2
metric* P | xsd:string | Get threshold only for the specified metric, "entityType" must also be set if "metric" is set. Since vSAN API vSAN 7.0U2

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
VsanDiagnosticsThreshold[] | vim.cluster.VsanDiagnosticsThreshold[]

Faults

Type | Description
--- | ---
NotFound |
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetThresholds" type="vsan:VsanGetThresholdsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanGetThresholdsResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VsanDiagnosticsThreshold" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# VsanQueryNetworkDiagnostics(queryNetworkDiagnostics)

Get the latest network events that triggered network alarms.

Required Privileges
  System.Read

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
cluster P | ManagedObjectReference to a ComputeResource | The cluster where the network diagnostics is performed. Since vSAN API vSAN 7.0U2
host* P | ManagedObjectReference to a HostSystem | Get only for the specified host. Since vSAN API vSAN 7.0U2

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
VsanNetworkDiagnostics[] | vim.cluster.VsanNetworkDiagnostics[]

Faults

Type | Description
--- | ---
NotFound |
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryNetworkDiagnostics" type="vsan:VsanQueryNetworkDiagnosticsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanQueryNetworkDiagnosticsResponse"> <complexType> <sequence> <element name="returnval" type="vsan:VsanNetworkDiagnostics" minOccurs="0" maxOccurs="unbounded"/> </sequence> </complexType> </element>

# VsanSetThresholds(setThresholds)

Set the threshold. The "entityType" and "metric" of the new threshold must be in current supported list (see entityType), or fault "vmodl.fault.InvalidArgument" will be raised. If "yellow" or "red" value is "0" or not set in the new threshold, the existing "yellow" or "red" value of current threshold setting will keep unchanged.

Required Privileges
  Global.Diagnostics

Parameters

Name | Type | Description
--- | --- | ---
_this | ManagedObjectReference | A reference to the VsanDiagnosticsSystem used to make the method call.
cluster P | ManagedObjectReference to a ComputeResource | The cluster where the threshold is to set to Since vSAN API vSAN 7.0U2
thresholds* P | VsanDiagnosticsThreshold[] | The new threshold value to set Since vSAN API vSAN 7.0U2

*Need not be set P Required privilege - see tooltip for details

Return Value

Type | Description
--- | ---
None

Faults

Type | Description
--- | ---
InvalidArgument |
NotFound |
RuntimeFault | Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition
<element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanSetThresholds" type="vsan:VsanSetThresholdsRequestType"/> <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="VsanSetThresholdsResponse"> <complexType/> </element>