|
| 1 | +"""Prometheus Binary Sensor component.""" |
| 2 | + |
| 3 | +from __future__ import annotations |
| 4 | + |
| 5 | +from typing import TYPE_CHECKING, Final |
| 6 | + |
| 7 | +import voluptuous as vol |
| 8 | + |
| 9 | +from homeassistant.components.binary_sensor import ( |
| 10 | + PLATFORM_SCHEMA as BINARY_SENSOR_PLATFORM_SCHEMA, |
| 11 | + BinarySensorDeviceClass, |
| 12 | + BinarySensorEntity, |
| 13 | +) |
| 14 | +from homeassistant.const import ( |
| 15 | + CONF_DEVICE_CLASS, |
| 16 | + CONF_NAME, |
| 17 | + CONF_UNIQUE_ID, |
| 18 | + CONF_URL, |
| 19 | + CONF_VALUE_TEMPLATE, |
| 20 | +) |
| 21 | +from homeassistant.helpers.aiohttp_client import async_get_clientsession |
| 22 | +import homeassistant.helpers.config_validation as cv |
| 23 | + |
| 24 | +from . import Prometheus |
| 25 | + |
| 26 | +if TYPE_CHECKING: |
| 27 | + from homeassistant.core import HomeAssistant |
| 28 | + from homeassistant.helpers.entity_platform import AddEntitiesCallback |
| 29 | + from homeassistant.helpers.template import Template |
| 30 | + from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType |
| 31 | + |
| 32 | + from . import QueryResult |
| 33 | + |
| 34 | +from .const import CONF_EXPR, CONF_QUERIES, DEFAULT_URL, SCAN_INTERVAL as SCAN_INTERVAL |
| 35 | + |
| 36 | +_QUERY_SCHEMA: Final = vol.Schema( |
| 37 | + { |
| 38 | + vol.Required(CONF_NAME): cv.string, |
| 39 | + vol.Optional(CONF_UNIQUE_ID): cv.string, |
| 40 | + vol.Required(CONF_EXPR): cv.string, |
| 41 | + vol.Optional(CONF_VALUE_TEMPLATE): cv.template, |
| 42 | + vol.Optional(CONF_DEVICE_CLASS): vol.Coerce(BinarySensorDeviceClass), |
| 43 | + } |
| 44 | +) |
| 45 | + |
| 46 | +PLATFORM_SCHEMA: Final = BINARY_SENSOR_PLATFORM_SCHEMA.extend( |
| 47 | + { |
| 48 | + vol.Optional(CONF_URL, default=DEFAULT_URL): cv.string, # type: ignore |
| 49 | + vol.Required(CONF_QUERIES): [_QUERY_SCHEMA], |
| 50 | + } |
| 51 | +) |
| 52 | + |
| 53 | + |
| 54 | +async def async_setup_platform( |
| 55 | + hass: HomeAssistant, |
| 56 | + config: ConfigType, |
| 57 | + async_add_entities: AddEntitiesCallback, |
| 58 | + discovery_info: DiscoveryInfoType | None = None, |
| 59 | +): |
| 60 | + """Set up the sensor platform.""" |
| 61 | + session = async_get_clientsession(hass) |
| 62 | + url = config[CONF_URL] |
| 63 | + prometheus = Prometheus(url, session) |
| 64 | + |
| 65 | + async_add_entities( |
| 66 | + new_entities=[ |
| 67 | + PrometheusBinarySensor( |
| 68 | + prometheus=prometheus, |
| 69 | + unique_id=query.get(CONF_UNIQUE_ID), |
| 70 | + device_name=query[CONF_NAME], |
| 71 | + expression=query[CONF_EXPR], |
| 72 | + value_template=query.get(CONF_VALUE_TEMPLATE), |
| 73 | + device_class=query.get(CONF_DEVICE_CLASS), |
| 74 | + ) |
| 75 | + for query in config[CONF_QUERIES] |
| 76 | + ], |
| 77 | + update_before_add=True, |
| 78 | + ) |
| 79 | + |
| 80 | + |
| 81 | +class PrometheusBinarySensor(BinarySensorEntity): |
| 82 | + """Sensor entity representing the result of a PromQL expression.""" |
| 83 | + |
| 84 | + def __init__( |
| 85 | + self, |
| 86 | + *, |
| 87 | + prometheus: Prometheus, |
| 88 | + unique_id: str | None, |
| 89 | + device_name: str, |
| 90 | + expression: str, |
| 91 | + value_template: Template, |
| 92 | + device_class: BinarySensorDeviceClass | None, |
| 93 | + ) -> None: |
| 94 | + """Initialize the sensor.""" |
| 95 | + self._prometheus: Prometheus = prometheus |
| 96 | + self._expression = expression |
| 97 | + self._value_template = value_template |
| 98 | + |
| 99 | + self._attr_device_class = device_class |
| 100 | + self._attr_name = device_name |
| 101 | + self._attr_unique_id = unique_id |
| 102 | + |
| 103 | + async def async_update(self) -> None: |
| 104 | + """Update state by executing query.""" |
| 105 | + result: QueryResult = await self._prometheus.query(self._expression) |
| 106 | + self._attr_available = result.error is None |
| 107 | + |
| 108 | + # Nuke value if sensor becomes unavailable |
| 109 | + if not self._attr_available: |
| 110 | + self._attr_is_on = None |
| 111 | + |
| 112 | + # Naive bool cast without template |
| 113 | + elif self._value_template is None: |
| 114 | + self._attr_is_on = bool(result.value) |
| 115 | + |
| 116 | + # Evaluate template |
| 117 | + else: |
| 118 | + render_result = self._value_template.async_render( |
| 119 | + variables=dict(value=result.value) |
| 120 | + ) |
| 121 | + |
| 122 | + if render_result is not None: |
| 123 | + self._attr_is_on = render_result.return_as_boolean() |
| 124 | + else: |
| 125 | + self._attr_is_on = None |
0 commit comments