The snmp sensor platform simple displays the information which are available through the Simple Network Management Protocol (SNMP). SNMP uses a tree-like hierarchy where each node is an object.

To enable this sensor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: snmp

Configuration variables:

  • host (Required): The IP address of your host, eg.
  • port (Option): The SNMP port of your host. Defaults to 161.
  • name (Optional): Name of the SNMP sensor.
  • community (Optional): The SNMP community which is set for the device. Most devices have a default community set to to public with read-only permission (which is sufficient).
  • baseoid (Required): The OID where the information is located. It’s advised to use the numerical notation.
  • unit_of_measurement (Optional): Defines the unit of measurement of the sensor, if any.
  • version (Optional) version of SNMP protocol, 1 or 2c defaults to 1. Version 2c is needed to read data from 64-bit counters.

The OIDs may vary on different system because they are vendor-specific. Beside the device’s manual is the OID Repository a good place to start if you are looking for OIDs. The following OIDs are for the load of a Linux systems.

  • 1 minute Load:
  • 5 minute Load:
  • 15 minute Load:

There is a large amount of tools available to work with SNMP. snmpwalk let you easily retrieve the value of a OID.

$ snmpwalk -Os -c public -v 2c
laLoad.1 = STRING: 0.19