home-assistant.io/source/_components/sensor.pi_hole.markdown
Alok Saboo 1aca7b08cf Misc fixes: e.g. -> e.g., and proper case for Home Assistant (#4942)
* e.g. to e.g., and proper case for Home Assistant

* Instructions how to -> Instructions on how to
2018-03-17 20:20:37 +01:00

1.6 KiB

layout title description date sidebar comments sharing footer ha_category ha_iot_class logo ha_release
page Pi-Hole Sensor Instructions on how to integrate REST sensors into Home Assistant. 2016-09-03 16:30 true false true true System Monitor Local Polling pi_hole.png 0.28

The pi_hole sensor platform is displaying the statistical summary of a Pi-Hole system.

To enable this sensor, add the following lines to your configuration.yaml file for a GET request:

# Example configuration.yaml entry
sensor:
  - platform: pi_hole

Configuration variables:

  • host (Optional): The IP address of the Pi-Hole system. Defaults to localhost.
  • location (Optional): The installation location of the Pi-Hole API. Defaults to admin.
  • ssl (Optional): If true, use SSL/TLS to connect to the Pi-Hole system. Defaults to False.
  • verify_ssl (Optional): Verify the certification of the system. Default to True.
  • monitored_conditions (Optional): Defines the stats to monitor as sensors.
    • ads_blocked_today: Total number of blocked ads today.
    • ads_percentage_today: Percentage of blocked ads.
    • dns_queries_today: Total number of DNS queries handled by Pi-Hole today.
    • domains_being_blocked: Total number of domains blocked by Pi-Hole.
    • queries_cached: Total number of cache queries on the last 24 hours.
    • queries_forwarded: Total number of forwarded queries on the last 24 hours.
    • unique_clients: Total number of unique clients on the last 24 hours.
    • unique_domains: Total number of unique domains on the last 24 hours.