ZenPack considerations

This section describes special considerations for updating ZenPacks. For more information about ZenPacks, see the ZenPack catalog.

Alternate naming convention for LUN- and VM-specific metrics

This information applies to the VMware vSphere ZenPack. By default, LUN- and VM-specific metrics are written under the following naming convention:

<device-id>/<metric-name>

To improve retrieval speed of metrics (graphing speed) for vSphere instances with thousands of LUNs or virtual machines, you can enable the following alternate naming convention:

<device-id>/<component-id>/<metric-name>

Note: Changing the naming convention causes historical metrics to become inaccessible.

The following configuration properties support the alternate convention:

zVSphereLUNContextMetric - Controls whether to use LUN-specific metric names when storing performance data.

For example, with this configuration property enabled, the metric name diskReadRequests_diskReadRequests changes as follows:

Old name:
```
sol-vcenter/diskReadRequests_diskReadRequests
```
New name:
```
sol-vcenter/HostSystem_host-134_naa.600508e001da816aa59a72903/diskReadRequests_diskReadRequests
```
zVSphereVMContextMetric - Controls whether to use VM-specific metric names when storing performance data.

For example, with this configuration property enabled, the metric name cpuUsageAvg_cpuUsageAvg changes as follows:

Old name:
```
vxchnge-vcenter/cpuUsageAvg_cpuUsageAvg
```
New name:
```
vxchnge-vcenter-02/VirtualMachine_vm-2556/cpuUsageAvg_cpuUsageAvg
```

For more information, see the VMware vSphere ZenPack in the ZenPack catalog.

Enabling the alternate metric naming convention

This procedure requires a restart the zenvsphere daemon.

Log in to the Resource Manager browser interface.
Navigate to the Infrastructure page.
In the left pane, choose vSphere.
In the main pane, click the name of the VMware vSphere device.
In the left pane, choose Configuration Properties.
In the main pane, Name column, double-click the vSphere context metric name.
In the Edit Config Property dialog box, check Store x metrics by context, and then click Submit.

The property value changes to true.
Restart the zenvsphere daemon.