
Dell iDRAC Service Module 5.3.0.0 User’s Guide
Metric Injection (Host OS Telemetry)
The Metric Injection (Host OS Telemetry) feature in iDRAC Service Module (iSM) collects metrics from the operating system and injects the metrics data into the iDRAC telemetry interface. The metric injection to the iDRAC telemetry is performed over HTTPS requests following the Redfish standards. iSM supports the Metric Injection (Host OS Telemetry) feature on Microsoft Windows, Linux, and VMware ESXi 8.0 U2 operating systems, with iDRAC firmware 6.10.00.00 and later versions.
Following are the prerequisites for the Metric Injection (Host OS Telemetry) feature:
- iDRAC Datacenter license
- iDRAC and host operating system time must be synchronized
- The Metric Injection (Host OS Telemetry) feature must be installed on iSM
- Enable the iDRAC web server in the iDRAC UI or RACADM CLI by running the following command:
racadm set idrac.webserver.enable 1
- Enable Redfish service in the iDRAC UI or RACADM CLI by running the following command:
racadm set iDRAC.Redfish.Enable 1
- Enable the telemetry feature in RACADM CLI by running the following commands:
racadm set iDRAC.Telemetry.EnableTelemetry 1
racadm set idrac.Telemetry.EnableMetricInjection 1
- The Metric Injection (Host OS Telemetry) feature of iSM does not create metric reports on iDRAC. To view the metric values that are injected by iSM to the iDRAC telemetry, you must create the metric report for the required metrics.
- The Metric Injection (Host OS Telemetry) feature is not supported when iSM is running in Limited Functionality mode.
- During iDRAC factory reset, the metric information is deleted from the iDRAC.
- The Metric Injection (Host OS Telemetry) feature supports a maximum of 48 metric values on iDRAC firmware 7.00.60.00 and earlier versions.
The Metric Injection (Host OS Telemetry) feature collects static and dynamic metrics from the host operating system. The static metrics are injected only when the iSM service starts or restarts, and the dynamic metrics have a default update interval of three minutes. The following table lists the static and dynamic metrics that are injected to the iDRAC telemetry:
| Metric ID | Metric description | Metric type | Supported platforms |
|---|---|---|---|
| OSProcessorMaxFrequency | Processor max frequency | Static | All operating systems supported by iSM |
| OSNumberofProcessorCores | Number of processor cores | Static | All operating systems supported by iSM |
| OSProcessorArchitecture | Processor architecture | Static | All operating systems supported by iSM |
| OSTotalPhysicalMemory | Total visible physical memory | Static | All operating systems supported by iSM |
| OSTotalVirtualMemory | Total virtual memory | Static |
|
| OSProcessorUtilizationPercentage | Processor utilization percentage | Dynamic | All operating systems supported by iSM |
| OSProcessorOperatingFrequency | Processor operating frequency | Dynamic | All operating systems supported by iSM |
| OSNumberofProcesses | Number of processes | Dynamic | All operating systems supported by iSM |
| OSNumberofProcesses | Free physical memory | Dynamic | All operating systems supported by iSM |
| OSFreeVirtualMemory | Free virtual memory | Dynamic |
|
| OSMemoryUtilizationPercentage | Physical memory utilization percentage | Dynamic | All operating systems supported by iSM |
| OSPhysicalDriveNodeName | Physical drive node name | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskName | Physical drive disk name | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskSerial | Physical drive disk serial | Dynamic | Microsoft Windows |
| OSPhysicalDriveBusType | Physical drive bus type | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskMediaType | Physical drive disk media type | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskId | Physical drive disk Id | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskSize | Physical drive disk size | Dynamic | Microsoft Windows |
| OSPhysicalDriveDiskAllocated | Physical drive disk allocated size | Dynamic | Microsoft Windows |
| OSPhysicalDriveCanPool | Physical drive can pool | Dynamic | Microsoft Windows |
| OSPhysicalDriveCannotPoolReason | Physical drive disk cannot pool reason | Dynamic | Microsoft Windows |
| OSPhysicalDriveVirtualDiskFootprint | Physical drive virtual disk footprint | Dynamic | Microsoft Windows |
| OSLogicalDriveDriveLetter | Logical drive drive letter | Dynamic | Microsoft Windows |
| OSLogicalDriveName | Logical drive name | Dynamic | Microsoft Windows |
| OSLogicalDriveFileSystemType | Logical drive file system type | Dynamic | Microsoft Windows |
| OSLogicalDriveDriveType | Logical drive drive type | Dynamic | Microsoft Windows |
| OSLogicalDriveHealthStatus | Logical drive health status | Dynamic | Microsoft Windows |
| OSLogicalDriveOperationalStatus | Logical drive operational status | Dynamic | Microsoft Windows |
| OSLogicalDriveFreeSpace | Logical drive free space | Dynamic | Microsoft Windows |
| OSLogicalDriveTotalSize | Logical drive total size | Dynamic | Microsoft Windows |
| OSLogicalProcessorUtilizationPercentage | Logical processor utilization percentage | Dynamic | Microsoft Windows |
The following tables list the dcismcfg command-line options to configure the Metric Injection (Host OS Telemetry) feature:
| iSM utility name | CLI option | Description |
|---|---|---|
| dcismcfg -metricinjection | --help/-h | To display the help content. |
| dcismcfg -metricinjection | --enable/-e | To enable the Metric Injection feature. |
| dcismcfg -metricinjection | --disable/-d | To disable the Metric Injection feature. |
| dcismcfg -metricinjection | --patch/-p=<MetricID> --interval/-i=<Sensing Interval> | To update sensing interval for the metric ID. This command supports only the dynamic metric IDs.
Supported sensing interval is between 60 seconds to 3600 seconds. Enter the sensing interval in multiples of 180. |
| dcismcfg -metricinjection | --getinterval/-g --metricid/-m=<MetricID> | To retrieve the sensing interval for the metric ID. This command is supported only for dynamic metric IDs. |
| dcismcfg -metricinjection | --listmetrics/-l=<type> |
To list the metric IDs. |
| iSM utility name | CLI option | Description |
|---|---|---|
| dcismcfg.exe -metricinjection | --help/-h | To display the Online Help content. |
| dcismcfg.exe -metricinjection | --enable/-e | To enable the Metric Injection feature. |
| dcismcfg.exe -metricinjection | --disable/-d | To disable the Metric Injection feature. |
| dcismcfg.exe -metricinjection | --patch/-p=<MetricID> --interval/-i=<Sensing Interval> | To update sensing interval for the metric ID. This command supports only the dynamic metric IDs.
Supported sensing interval is between 60 seconds to 3,600 seconds. Enter the sensing interval in multiples of 180. The sensing interval that is supported for physical drive and logical drive metrics is between 1,800 and 3,600 seconds, default interval is 1,800 seconds. |
| dcismcfg.exe -metricinjection | --getinterval/-g --metricid/-m=<MetricID> | To retrieve the sensing interval for the metric ID. This command is supported only for dynamic metric IDs. |
| dcismcfg.exe -metricinjection | --listmetrics/-l=<type> |
To list the metric IDs. The options for <type> can be static, dynamic, or all. |
| iSM utility name | CLI option | Description |
|---|---|---|
| esxcli dell ism metricinjection | --help | To display the help content. |
| esxcli dell ism metricinjection | --enable/-e | To enable the Metric Injection feature. |
| esxcli dell ism metricinjection | --disable/-d | To disable the Metric Injection feature. |
| esxcli dell ism metricinjection | --patch/-p=<MetricID> --interval/-i=<Sensing Interval> | To update sensing interval for the metric ID. This command supports only the dynamic metric IDs.
Supported sensing interval is between 60 seconds to 3600 seconds. Enter the sensing interval in multiples of 180. |
| esxcli dell ism metricinjection | --getinterval/-g --metricid/-m=<MetricID> | To retrieve the sensing interval for the metric ID. This command is supported only for dynamic metric IDs. |
| esxcli dell ism metricinjection | --listmetrics/-l=<str> |
To list the metric IDs. The options for <type> can be static, dynamic, or all. |