mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-27 11:16:54 +00:00
Update prometheus component configuration (#7418)
This commit is contained in:
parent
699d9af012
commit
257a179bf2
@ -21,16 +21,43 @@ To use the `prometheus` component in your installation, add the following to you
|
|||||||
prometheus:
|
prometheus:
|
||||||
```
|
```
|
||||||
|
|
||||||
Configuration variables:
|
{% configuration %}
|
||||||
|
namespace:
|
||||||
- **namespace** (*Optional*): The "namespace" that will be assigned to all the Prometheus metrics. This is the prefix of the metric name. E.g., having `myhass` as the namespace will cause the device tracker metrics to be `myhass_device_tracker_state`, the switch metrics to be `myhass_switch_state` and so on. The default is to not add any prefix to the metrics name. (available in version 0.73.0 and later)
|
description: The "namespace" that will be assigned to all the Prometheus metrics. This is the prefix of the metric name. E.g., having `myhass` as the namespace will cause the device tracker metrics to be `myhass_device_tracker_state`, the switch metrics to be `myhass_switch_state` and so on. The default is to not add any prefix to the metrics name. (available in version 0.73.0 and later)
|
||||||
- **filter** (*Optional*): Filtering directives for the components which should be included or excluded from recording.
|
required: false
|
||||||
- **exclude** (*Optional*): Excluded from recording.
|
type: string
|
||||||
- **entities** (*Optional*): The list of entity ids to be excluded from recording.
|
filter:
|
||||||
- **domains** (*Optional*): The list of domains to be excluded from recording.
|
description: Filtering directives for the components which should be included or excluded from recording.
|
||||||
- **include** (*Optional*): Included in recordings. If set, all other entities will not be recorded. Values set by the **exclude** option will prevail.
|
required: false
|
||||||
- **entities** (*Optional*): The list of entity ids to be included from recordings.
|
type: list
|
||||||
- **domains** (*Optional*): The list of domains to be included from recordings.
|
keys:
|
||||||
|
exclude:
|
||||||
|
description: Excluded from recording.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
keys:
|
||||||
|
entities:
|
||||||
|
description: The list of entity ids to be excluded from recording.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
domains:
|
||||||
|
description: The list of domains to be excluded from recording.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
include:
|
||||||
|
description: Included in recordings. If set, all other entities will not be recorded. Values set by the **exclude** option will prevail.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
keys:
|
||||||
|
entities:
|
||||||
|
description: The list of entity ids to be included from recordings.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
domains:
|
||||||
|
description: The list of domains to be included from recordings.
|
||||||
|
required: false
|
||||||
|
type: list
|
||||||
|
{% endconfiguration %}
|
||||||
|
|
||||||
You can then configure Prometheus to fetch metrics from Home Assistant by adding to its `scrape_configs` configuration.
|
You can then configure Prometheus to fetch metrics from Home Assistant by adding to its `scrape_configs` configuration.
|
||||||
|
|
||||||
@ -45,7 +72,7 @@ You can then configure Prometheus to fetch metrics from Home Assistant by adding
|
|||||||
api_password: ['PASSWORD']
|
api_password: ['PASSWORD']
|
||||||
|
|
||||||
# Long-Lived Access Token
|
# Long-Lived Access Token
|
||||||
bearer_token: 'your.longlived.token
|
bearer_token: 'your.longlived.token'
|
||||||
|
|
||||||
scheme: https
|
scheme: https
|
||||||
static_configs:
|
static_configs:
|
||||||
@ -54,7 +81,7 @@ You can then configure Prometheus to fetch metrics from Home Assistant by adding
|
|||||||
|
|
||||||
When looking into the metrics on the Prometheus side, there will be:
|
When looking into the metrics on the Prometheus side, there will be:
|
||||||
|
|
||||||
- All Home Assistant domains, which can be easily found through the common **namespace** prefix, if defined.
|
- All Home Assistant domains, which can be easily found through the common **namespace** prefix, if defined.
|
||||||
- The [client library](https://github.com/prometheus/client_python) provided metrics, which are a bunch of **process_\*** and also a single pseudo-metric **python_info** which contains (not as value but as labels) information about the Python version of the client, i.e., the Home Assistant Python interpreter.
|
- The [client library](https://github.com/prometheus/client_python) provided metrics, which are a bunch of **process_\*** and also a single pseudo-metric **python_info** which contains (not as value but as labels) information about the Python version of the client, i.e., the Home Assistant Python interpreter.
|
||||||
|
|
||||||
Typically, you will only be interested in the first set of metrics.
|
Typically, you will only be interested in the first set of metrics.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user