mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-26 10:46:51 +00:00
Updates pi_hole component documentation per home-assistant/home-assistant#25837 (#10097)
This commit is contained in:
parent
73b88bd660
commit
20ed56ef43
@ -10,7 +10,7 @@ redirect_from:
|
|||||||
- /components/sensor.pi_hole/
|
- /components/sensor.pi_hole/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `pi_hole` sensor platform displays the statistical summary of a [Pi-hole](https://pi-hole.net/) system.
|
The `pi_hole` integration allows you to retrieve and display statistics from a [Pi-hole](https://pi-hole.net/) system.
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
@ -18,8 +18,7 @@ To enable this sensor, add the following lines to your `configuration.yaml` file
|
|||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
sensor:
|
pi_hole:
|
||||||
- platform: pi_hole
|
|
||||||
```
|
```
|
||||||
|
|
||||||
{% configuration %}
|
{% configuration %}
|
||||||
@ -27,7 +26,7 @@ host:
|
|||||||
description: IP address of the host where Pi-hole is running.
|
description: IP address of the host where Pi-hole is running.
|
||||||
required: false
|
required: false
|
||||||
type: string
|
type: string
|
||||||
default: localhost
|
default: pi.hole
|
||||||
location:
|
location:
|
||||||
description: The installation location of the Pi-hole API.
|
description: The installation location of the Pi-hole API.
|
||||||
required: false
|
required: false
|
||||||
@ -43,48 +42,17 @@ verify_ssl:
|
|||||||
required: false
|
required: false
|
||||||
type: boolean
|
type: boolean
|
||||||
default: true
|
default: true
|
||||||
monitored_conditions:
|
|
||||||
description: Defines the stats to monitor as sensors.
|
|
||||||
required: false
|
|
||||||
type: list
|
|
||||||
default: ads_blocked_today
|
|
||||||
keys:
|
|
||||||
ads_blocked_today:
|
|
||||||
description: Total number of blocked ads today.
|
|
||||||
ads_percentage_today:
|
|
||||||
description: Percentage of blocked ads.
|
|
||||||
dns_queries_today:
|
|
||||||
description: Total number of DNS queries handled by Pi-hole today.
|
|
||||||
domains_being_blocked:
|
|
||||||
description: Total number of domains blocked by Pi-hole.
|
|
||||||
queries_cached:
|
|
||||||
description: Total number of cache queries on the last 24 hours.
|
|
||||||
queries_forwarded:
|
|
||||||
description: Total number of forwarded queries on the last 24 hours.
|
|
||||||
unique_clients:
|
|
||||||
description: Total number of unique clients on the last 24 hours.
|
|
||||||
unique_domains:
|
|
||||||
description: Total number of unique domains on the last 24 hours.
|
|
||||||
clients_ever_seen:
|
|
||||||
description: Total number of seen clients.
|
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
### Full example
|
### Full example
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
# Example configuration.yaml entry
|
# Example configuration.yaml entry
|
||||||
|
pi_hole:
|
||||||
|
host: IP_ADDRESS
|
||||||
|
|
||||||
sensor:
|
sensor:
|
||||||
- platform: pi_hole
|
- platform: pi_hole
|
||||||
host: IP_ADDRESS
|
|
||||||
monitored_conditions:
|
|
||||||
- ads_blocked_today
|
|
||||||
- ads_percentage_today
|
|
||||||
- dns_queries_today
|
|
||||||
- domains_being_blocked
|
|
||||||
- queries_cached
|
|
||||||
- queries_forwarded
|
|
||||||
- unique_clients
|
|
||||||
- unique_domains
|
|
||||||
```
|
```
|
||||||
|
|
||||||
This sensor platform was not made by Pi-hole LLC or the Pi-hole community. They did not provide support, feedback, testing, or any other help during its creation. This is a third party platform which may break if Pi-hole changes their API in a later release. It is not official, not developed, not supported, and not endorsed Pi-hole LLC or the Pi-hole community. The trademark `Pi-hole` and the logo is used here to describe the platform. `Pi-hole` is a registered trademark of Pi-hole LLC.
|
This integration was not made by Pi-hole LLC or the Pi-hole community. They did not provide support, feedback, testing, or any other help during its creation. This is a third party platform which may break if Pi-hole changes their API in a later release. It is not official, not developed, not supported, and not endorsed Pi-hole LLC or the Pi-hole community. The trademark `Pi-hole` and the logo is used here to describe the platform. `Pi-hole` is a registered trademark of Pi-hole LLC.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user