systemmonitor sensor platform allows you to monitor disk usage,
memory usage, CPU usage, and running processes.
To add this platform to your installation,
add the following to your
# Example configuration.yaml entry sensor: - platform: systemmonitor resources: - type: disk_use_percent arg: /config - type: memory_free
After restarting Home Assistant, these sensors will show up and update their information every 15 seconds.
The table contains types and their argument to use in your
If no path is provided via the optional argument, the integration defaults to ‘/’ (root).
Note: The disk usage sensors do not support monitoring folder/directory sizes. Instead, it is only concerned with “disks” (more specifically mount points on Linux).
$ df -H Filesystem Size Used Avail Use% Mounted on /dev/root 29G 12G 16G 42% / devtmpfs 805M 0 805M 0% /dev tmpfs 934M 0 934M 0% /dev/shm /dev/mmcblk0p1 253M 54M 199M 22% /boot
disk_use sensor for
/home/pi is redundant and will return the same values, since they both belong to the same “disk”. However, defining separate sensors for
/dev/shm is possible and provides different values, since those are treated as separate “disks” by the integration.
# Example configuration.yaml entry sensor: - platform: systemmonitor resources: - type: disk_use arg: /dev - type: disk_use arg: /dev/shm
- If no hardware sensor data is available (e.g., because the integration runs in a virtualized environment), the sensor entity will not be created.
- The unit of measurement (Celsius vs. Fahrenheit) will be chosen based on the system configuration.
- Only the very first processor related hardware sensor is read, i.e., no individual core temperatures (even if the hardware sensor could provide that level of detail).
To retrieve all available network interfaces on a Linux System, execute the
ifconfig -a | sed 's/[ \t].*//;/^$/d'
When running this platform on Microsoft Windows, Typically,
the default interface would be called
Local Area Connection,
so your configuration might look like:
sensor: - platform: systemmonitor resources: - type: network_in arg: "Local Area Connection"
If you need to use some other interface, open a command line prompt and type
ipconfig to list all interface names. For example a wireless connection output from
ipconfig might look like:
Wireless LAN adapter Wireless Network Connection: Media State . . . . . . . . . . . : Media disconnected Connection-specific DNS Suffix . :
Where the name is
Wireless Network Connection.