Back to the list of connectors

WMI - Battery

Description

This connector provides battery monitoring for Windows computers.

Connector ID: GenBatteryNT

Target

Typical platform: Any system

Operating system: Microsoft Windows

Prerequisites

Leverages: WMI

Technology and protocols: WMI

Examples

CLI

hws HOSTNAME -t win -f GenBatteryNT --wmi -u USER

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: win
  selectedConnectors: [ GenBatteryNT ] # Optional, to load only this connector
  wmi:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt

Connector Activation Criteria

The WMI - Battery connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • Operating System is Microsoft Windows
  • The Windows service WINMGMT is running
  • The WMI query below to the managed host succeeds:
    • Namespace: root\cimv2
    • WQL Query: SELECT DeviceID FROM Win32_Battery

Metrics

Type Collected Metrics Specific Attributes (Labels)
Battery
  • hw.battery.charge
  • hw.battery.time_left{state="discharging"}
  • hw.status{hw.type="battery",state="ok|degraded|failed"}
  • hw.status{hw.type="battery",state="present"}
  • chemistry
  • model
  • vendor
Keywords:
hardware observability opentelemetry otel sustainability
No results.