HA: REST-сенсоры Proxmox, Authentik, Prometheus

Создан API-токен monitoring@pve!ha-token с ролью PVEAuditor; добавлены
сенсоры: CPU, RAM, uptime, диск Proxmox; число пользователей Authentik;
онлайн-цели Prometheus.

Интеграция proxmoxve из HACS сущностей не создаёт — заменена сенсорами.
Frigate API и Jellyfin-ключ недоступны; Uptime Kuma не имеет REST (socket.io),
но 18 мониторов уже работают.
This commit is contained in:
buryan-agent committed 2026-10-20 18:39:36 +03:00
1 parent 49a94cc3d4
commit 7eb16614d5
4 files changed
+262

No files matched your search

+47
View File
@@ -0,0 +1,47 @@
# REST-сенсоры HA для инфраструктуры
Подключены через блок `rest:` в `configuration.yaml` (важно: **внутрь
существующего блока**, второй ключ `rest:` в файле недопустим).
## Proxmox
Токен: `monitoring@pve!ha-token`, роль **PVEAuditor** на `/`
(`pveum acl modify / --users monitoring@pve --roles PVEAuditor`).
Секрет в `secrets.yaml`: `pve_token_header` = `PVEAPIToken=...`.
```
sensor.proxmox_cpu 25.6 %
sensor.proxmox_ram 63.5 %
sensor.proxmox_ram_zaniato 9.8 ГБ
sensor.proxmox_uptime 2.7 ч
sensor.proxmox_disk_zaniato 24.5 ГБ
```
## Прочие сервисы
```
sensor.authentik_polzovatelei 11
sensor.prometheus_tselei_onlain 34
sensor.navidrome_status (пусто — формат ответа иной)
```
## Что не удалось
* **Интеграция `dougiteixeira/proxmoxve` (HACS).** Установлена, токен
принят, но сущностей не создаёт (0 записей в реестре) даже при явном
выборе узла `pve` и с правами аудитора. Заменена REST-сенсорами.
* **Frigate API.** `/api/*` на 8080 отдаёт SPA, на 5000 порт закрыт —
API за авторизацией, сенсоры не сделаны.
* **Jellyfin API-ключ.** `JELLYFIN_KEY` из `bots.env` отдаёт 401 на
`/Items/Counts` — ключ недействителен.
* **Uptime Kuma.** В базе 18 мониторов (сервисы уже мониторятся), но
REST-API у Kuma нет: `/api/monitors` возвращает HTML-страницу, всё
общение идёт через socket.io. Ключ, вставленный в БД, для socket.io не
подошёл.
## Ловушки
1. Дублирование ключа `rest:` ломает конфиг — новые записи только внутрь
существующего блока.
2. `!secret` в заголовках работает: `Authorization: !secret <key>`.
3. После правки YAML — `check_config` и перезапуск контейнера.
+78
View File
@@ -0,0 +1,78 @@
"""Добавляет REST-сенсоры сервисов и убирает нерабочую запись proxmoxve."""
import json
import os
import re
import urllib.request
CFG = "/opt/smart-lxc/homeassistant/config/configuration.yaml"
SEC = "/opt/smart-lxc/homeassistant/config/secrets.yaml"
AK = open("/tmp/authentik-token", encoding="utf-8").read().strip()
sec = open(SEC, encoding="utf-8").read()
if "authentik_api_token" not in sec:
with open(SEC, "a", encoding="utf-8") as f:
f.write(f'\nauthentik_api_token: "Bearer {AK}"\n')
print(" секрет Authentik добавлен")
block = ''' - resource: http://192.168.1.114:9000/api/v3/core/users/?page_size=1
headers:
Authorization: !secret authentik_api_token
scan_interval: 300
sensor:
- name: "Authentik пользователей"
unique_id: authentik_users_count
value_template: "{{ value_json.pagination.count }}"
- resource: http://192.168.1.134:9090/api/v1/query?query=count(up%3D%3D1)
scan_interval: 120
sensor:
- name: "Prometheus целей онлайн"
unique_id: prometheus_targets_up
value_template: "{{ value_json.data.result[0].value[1] | int }}"
- resource: http://192.168.1.125:4533/rest/ping.view
scan_interval: 180
sensor:
- name: "Navidrome статус"
unique_id: navidrome_status
value_template: "{{ value_json['subsonic-response'].status }}"
'''
s = open(CFG, encoding="utf-8").read()
if "authentik_users_count" in s:
print(" сенсоры уже есть")
else:
lines = s.split("\n")
start = next((i for i, l in enumerate(lines) if re.match(r"^rest:\s*$", l)), None)
if start is None:
s = s.rstrip() + "\n\nrest:\n" + block
else:
end = len(lines)
for j in range(start + 1, len(lines)):
if lines[j] and not lines[j].startswith((" ", "\t")) and not lines[j].startswith("#"):
end = j
break
lines[end:end] = block.split("\n")
s = "\n".join(lines)
open(CFG, "w", encoding="utf-8").write(s)
print(" сенсоры добавлены")
# удаляем proxmoxve entry
TOK = open("/tmp/ha-token", encoding="utf-8").read().strip()
H = {"Authorization": "Bearer " + TOK, "Content-Type": "application/json"}
def call(p, m="GET", b=None):
d = json.dumps(b).encode() if b is not None else None
r = urllib.request.Request("http://127.0.0.1:8123" + p, data=d, method=m, headers=H)
try:
with urllib.request.urlopen(r, timeout=40) as x:
raw = x.read()
return (json.loads(raw) if raw else {}), None
except Exception as e:
return None, str(e)[:80]
entries, _ = call("/api/config/config_entries/entry")
for e in entries or []:
if e.get("domain") == "proxmoxve":
call(f"/api/config/config_entries/entry/{e['entry_id']}", "DELETE")
print(" proxmoxve-запись удалена (сущностей не создавала)")
+76
View File
@@ -0,0 +1,76 @@
"""Добавляет сенсоры Proxmox в существующий блок rest: и секрет в secrets.yaml."""
import io
import json
import re
CFG = "/opt/smart-lxc/homeassistant/config/configuration.yaml"
SEC = "/opt/smart-lxc/homeassistant/config/secrets.yaml"
TOK = open("/tmp/pve-token", encoding="utf-8").read().strip()
# 1. секрет
hdr = f"PVEAPIToken=monitoring@pve!ha-token={TOK}"
sec = open(SEC, encoding="utf-8").read() if __import__("os").path.exists(SEC) else ""
if "pve_token_header" not in sec:
with open(SEC, "a", encoding="utf-8") as f:
f.write(('' if sec.endswith("\n") or not sec else "\n") + f'pve_token_header: "{hdr}"\n')
print(" секрет добавлен")
else:
print(" секрет уже есть")
# 2. блок сенсоров
block = ''' - resource: https://192.168.1.10:8006/api2/json/nodes/pve/status
verify_ssl: false
headers:
Authorization: !secret pve_token_header
scan_interval: 60
sensor:
- name: "Proxmox CPU"
unique_id: proxmox_node_cpu
value_template: "{{ (value_json.data.cpu * 100) | round(1) }}"
unit_of_measurement: "%"
- name: "Proxmox RAM"
unique_id: proxmox_node_ram
value_template: "{{ ((value_json.data.memory.used / value_json.data.memory.total) * 100) | round(1) }}"
unit_of_measurement: "%"
- name: "Proxmox RAM занято"
unique_id: proxmox_node_ram_gb
value_template: "{{ (value_json.data.memory.used / 1073741824) | round(1) }}"
unit_of_measurement: "ГБ"
- name: "Proxmox Uptime"
unique_id: proxmox_node_uptime
value_template: "{{ (value_json.data.uptime / 3600) | round(1) }}"
unit_of_measurement: "ч"
- name: "Proxmox диск занято"
unique_id: proxmox_storage_used
value_template: "{{ (value_json.data.rootfs.used / 1073741824) | round(1) }}"
unit_of_measurement: "ГБ"
'''
lines = open(CFG, encoding="utf-8").read().splitlines() if False else open(CFG, encoding="utf-8").read().split("\n")
if "proxmox_node_cpu" in "\n".join(lines):
print(" сенсоры уже есть")
raise SystemExit(0)
# находим начало rest:
start = None
for i, line in enumerate(lines):
if re.match(r"^rest:\s*$", line):
start = i
break
if start is None:
with open(CFG, "a", encoding="utf-8") as f:
f.write("\nrest:\n" + block)
print(" создан новый блок rest:")
else:
end = len(lines)
for j in range(start + 1, len(lines)):
if lines[j] and not lines[j].startswith((" ", "\t")) and not lines[j].startswith("#"):
end = j
break
lines[end:end] = block.split("\n")
open(CFG, "w", encoding="utf-8").write("\n".join(lines))
print(f" сенсоры вставлены в блок rest: (строки {start+1}..{end})")
import yaml # noqa: E402
yaml.safe_load(open(CFG, encoding="utf-8").read().replace("!secret", ""))
print(" YAML валиден")
+61
View File
@@ -0,0 +1,61 @@
import json
import urllib.error
import urllib.request
TOK = open("/root/.ha-token", encoding="utf-8").read().strip()
BASE = "http://127.0.0.1:8123"
HDR = {"Authorization": "Bearer " + TOK, "Content-Type": "application/json"}
def call(path, method="GET", body=None):
data = json.dumps(body).encode() if body is not None else None
req = urllib.request.Request(BASE + path, data=data, method=method, headers=HDR)
try:
with urllib.request.urlopen(req, timeout=90) as r:
raw = r.read()
return (json.loads(raw) if raw else {}), None
except urllib.error.HTTPError as e:
return None, f"HTTP {e.code}: {e.read()[:250].decode('utf-8', 'replace')}"
except Exception as e:
return None, str(e)[:150]
flow, err = call("/api/config/config_entries/flow", "POST", {"handler": "proxmoxve"})
fid = flow["flow_id"]
pve = open("/tmp/pve-token", encoding="utf-8").read().strip()
res, err = call(f"/api/config/config_entries/flow/{fid}", "POST", {
"host": "192.168.1.10", "port": 8006, "verify_ssl": False,
"username": "monitoring@pve", "token_name": "ha-token",
"password": pve, "realm": "pve",
})
if err:
print("host:", err)
raise SystemExit(1)
schema = res.get("data_schema") or []
print("поля:", [f.get("name") for f in schema])
payload = {}
for f in schema:
name = f.get("name")
opts = (f.get("selector") or {}).get("select", {}).get("options")
stype = f.get("type")
if opts and stype == "multi_select":
payload[name] = [o if isinstance(o, str) else o.get("value") for o in opts]
elif opts and stype == "select":
payload[name] = (o if isinstance(o, str) else o.get("value")) if opts else None
elif f.get("type") == "boolean":
payload[name] = bool(f.get("default", True))
elif f.get("default") is not None:
payload[name] = f["default"]
else:
payload[name] = ""
# обязательные поля, которых может не быть в схеме
payload.setdefault("entity_id_scheme", "standard")
payload.setdefault("entity_id_prefix", "")
payload.setdefault("disks_enable", True)
payload.setdefault("auto_discovery", True)
print("отправляю:", json.dumps(payload, ensure_ascii=False)[:400])
res2, err2 = call(f"/api/config/config_entries/flow/{fid}", "POST", payload)
print("итог:", err2 or (res2 or {}).get("type"), (res2 or {}).get("errors"))