Home Assistant Unofficial Reference 2024.12.1
diagnostics.py
Go to the documentation of this file.
1 """Diagnostics support for Tailscale."""
2 
3 from __future__ import annotations
4 
5 import json
6 from typing import Any
7 
8 from homeassistant.components.diagnostics import async_redact_data
9 from homeassistant.config_entries import ConfigEntry
10 from homeassistant.const import CONF_API_KEY
11 from homeassistant.core import HomeAssistant
12 
13 from .const import CONF_TAILNET, DOMAIN
14 from .coordinator import TailscaleDataUpdateCoordinator
15 
16 TO_REDACT = {
17  CONF_API_KEY,
18  CONF_TAILNET,
19  "addresses",
20  "device_id",
21  "endpoints",
22  "hostname",
23  "machine_key",
24  "name",
25  "node_key",
26  "user",
27 }
28 
29 
31  hass: HomeAssistant, entry: ConfigEntry
32 ) -> dict[str, Any]:
33  """Return diagnostics for a config entry."""
34  coordinator: TailscaleDataUpdateCoordinator = hass.data[DOMAIN][entry.entry_id]
35  # Round-trip via JSON to trigger serialization
36  devices = [json.loads(device.to_json()) for device in coordinator.data.values()]
37  return async_redact_data({"devices": devices}, TO_REDACT)
dict async_redact_data(Mapping data, Iterable[Any] to_redact)
Definition: util.py:14
dict[str, Any] async_get_config_entry_diagnostics(HomeAssistant hass, ConfigEntry entry)
Definition: diagnostics.py:32