mirror of
https://github.com/prometheus-community/windows_exporter.git
synced 2026-10-17 18:19:04 +02:00
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
# dmi collector
|
|
|
|
The dmi collector exposes Desktop Management Interface (DMI) / SMBIOS system
|
|
information, compatible with node_exporter's
|
|
[`dmi` collector](https://github.com/prometheus/node_exporter/blob/master/collector/dmi.go).
|
|
|
|
|||
|
|
-|-
|
|
Metric name prefix | `dmi`
|
|
Data source | [`GetSystemFirmwareTable`](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemfirmwaretable) (SMBIOS)
|
|
Enabled by default? | No
|
|
|
|
## Flags
|
|
|
|
None
|
|
|
|
## Metrics
|
|
|
|
| Name | Description | Type | Labels |
|
|
|---------------------|-----------------------------------------------------------------------------------------------------|-------|----------------------------------------------------------------------------|
|
|
| `windows_dmi_info` | A metric with a constant '1' value labeled by SMBIOS Type 1 (System Information) fields. | gauge | `product_name`, `product_serial`, `product_uuid`, `product_version`, `system_vendor` |
|
|
|
|
On VMs the labels reflect the hypervisor-assigned identity; on physical hosts
|
|
they reflect the hardware SMBIOS data. If SMBIOS data cannot be read (e.g. in
|
|
some container environments), the collector will fail to build.
|
|
|
|
### Example metric
|
|
|
|
```
|
|
# HELP windows_dmi_info A metric with a constant '1' value labeled by product_name, product_serial, product_uuid, product_version, system_vendor from SMBIOS Type 1 (System Information).
|
|
# TYPE windows_dmi_info gauge
|
|
windows_dmi_info{product_name="Standard PC (Q35 + ICH9, 2009)",product_serial="Not Specified",product_uuid="12345678-1234-1234-1234-123456789abc",product_version="pc-q35-9.2",system_vendor="QEMU"} 1
|
|
```
|
|
|
|
## Useful queries
|
|
|
|
### Cross-exporter compatibility
|
|
|
|
The label names match node_exporter's `node_dmi_info` metric, so dashboards
|
|
and alerts work across Linux and Windows guests:
|
|
|
|
```promql
|
|
# Works for both Linux and Windows guests
|
|
{__name__=~"node_dmi_info|windows_dmi_info"}
|
|
```
|
|
|
|
### Correlate with libvirt_exporter
|
|
|
|
With [prometheus-libvirt-exporter](https://github.com/inovex/prometheus-libvirt-exporter),
|
|
the domain UUID is exposed on `libvirt_domain_info_meta{uuid="..."}`. This UUID
|
|
matches the SMBIOS UUID passed to the guest by QEMU/KVM.
|
|
|
|
Add the `product_uuid` label to any guest metric:
|
|
|
|
```promql
|
|
windows_memory_physical_free_bytes
|
|
* on(job, instance) group_left(product_uuid)
|
|
windows_dmi_info
|
|
```
|
|
|
|
Join a host-side libvirt metric with the guest-identified UUID (full guest→host chain):
|
|
|
|
```promql
|
|
libvirt_domain_info_memory_usage_bytes
|
|
* on(job, instance, domain) group_left(uuid)
|
|
libvirt_domain_info_meta
|
|
* on(uuid) group_left()
|
|
label_replace(windows_dmi_info, "uuid", "$1", "product_uuid", "(.+)")
|
|
```
|
|
|
|
## Alerting examples
|
|
|
|
_This collector does not yet have alerting examples, we would appreciate your help adding them!_
|