import json import time import requests from typing import Dict from pydantic import BaseModel, Field class Tools: """ Мониторинг TrueNAS через Open WebUI. REST с перебором альтернативных путей. TrueNAS 25.10 (Goldeye). """ class Valves(BaseModel): TRUENAS_URL: str = Field( default="http://192.168.31.100", description="IP-адрес или домен TrueNAS (http://...)", ) TRUENAS_API_KEY: str = Field( default="", description="API-ключ для доступа к TrueNAS (Settings → API Keys)", ) CACHE_TTL: int = Field( default=30, description="Время кэширования в секундах (0 = без кэша)" ) def __init__(self): self.valves = self.Valves() self._cache: Dict[str, tuple[float, str]] = {} self._last_error = "нет данных (запросы ещё не выполнялись)" try: import urllib3 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning) except Exception: pass @property def _base(self) -> str: # Всегда читаем актуальное значение из Valves — оно может # меняться в UI уже после создания экземпляра Tools. return self.valves.TRUENAS_URL.rstrip("/") @property def _headers(self) -> dict: return { "Authorization": f"Bearer {self.valves.TRUENAS_API_KEY}", "Content-Type": "application/json", } def clear_cache(self): self._cache.clear() def _rest_get(self, cache_key: str, endpoint: str): now = time.time() if cache_key in self._cache: t, d = self._cache[cache_key] if now - t < self.valves.CACHE_TTL: return d try: r = requests.get( f"{self._base}/api/v2.0/{endpoint}", headers=self._headers, timeout=10 ) if r.status_code == 200: data = r.json() s = json.dumps(data, default=str) if self.valves.CACHE_TTL > 0: self._cache[cache_key] = (now, s) return s self._last_error = f"HTTP {r.status_code} на {endpoint}: {r.text[:300]}" return None except Exception as e: self._last_error = f"Исключение на {endpoint}: {type(e).__name__}: {e}" return None def get_debug_info(self) -> str: """ Диагностика соединения с TrueNAS: проверяет базовый URL, HTTP/HTTPS, код ответа и текст ошибки для system/info. Полезно, когда API 'недоступен' и нужно понять, на каком этапе рвётся запрос. """ lines = [] base = self._base lines.append(f"🔧 TRUENAS_URL из настроек: {base}") lines.append( "🔑 API-ключ задан: " + ("да" if self.valves.TRUENAS_API_KEY else "❌ НЕТ — заполни Valves.TRUENAS_API_KEY") ) candidates = [base] if base.startswith("http://"): candidates.append("https://" + base[len("http://"):]) elif base.startswith("https://"): candidates.append("http://" + base[len("https://"):]) for url in candidates: lines.append(f"\n▶️ Проверка: {url}/api/v2.0/system/info") try: r = requests.get( f"{url}/api/v2.0/system/info", headers=self._headers, timeout=10, verify=False, ) lines.append(f" Код ответа: {r.status_code}") if r.status_code == 200: lines.append( " ✅ Успех! Обнови TRUENAS_URL на этот вариант, если он отличается от текущего." ) elif r.status_code in (401, 403): lines.append( " 🔑 Ошибка авторизации — проверь API-ключ (Settings → API Keys) и что он активен." ) else: lines.append(f" ⚠️ Тело ответа (первые 300 симв.): {r.text[:300]}") except requests.exceptions.SSLError as e: lines.append(f" 🔒 Ошибка SSL: {e}") except requests.exceptions.ConnectionError as e: lines.append( f" 🔌 Ошибка соединения (сервер недоступен / порт закрыт / неверный IP): {e}" ) except requests.exceptions.Timeout: lines.append( " ⏱️ Таймаут — сервер не отвечает за 10 секунд (перегружен или сеть медленная)." ) except Exception as e: lines.append(f" ❓ Прочая ошибка: {type(e).__name__}: {e}") lines.append( "\nℹ️ Последняя зафиксированная ошибка внутренних запросов: " + getattr(self, "_last_error", "нет данных (запросы ещё не выполнялись)") ) return "\n".join(lines) def _try_endpoints(self, cache_key: str, endpoints: list) -> str: for ep in endpoints: result = self._rest_get(f"{cache_key}_{ep.replace('/', '_')}", ep) if result is not None: return result return f"⚠️ Данные недоступны. Попробованы пути: {', '.join(endpoints)}" def get_system_status(self) -> str: raw = self._rest_get("info", "system/info") if raw is None: return "⚠️ Ошибка получения информации о системе" try: d = json.loads(raw) except Exception: return "Ошибка парсинга" ver = d.get("version", "N/A") model = d.get("model", "N/A") load = d.get("loadavg", []) load_s = ( f"1мин: {load[0]:.2f}, 5мин: {load[1]:.2f}, 15мин: {load[2]:.2f}" if len(load) >= 3 else str(load) if load else "Н/Д" ) up = d.get("uptime_seconds") if up: dd, r = divmod(int(up), 86400) hh, r = divmod(r, 3600) mm, _ = divmod(r, 60) up_s = f"{dd}д {hh}ч {mm}м" else: up_s = d.get("uptime_string", "Н/Д") return ( f"🖥️ TrueNAS: {ver}\n" f"⏱️ Uptime: {up_s}\n" f"🔧 Процессор: {model}\n" f"📊 Load Average: {load_s}" ) def get_pools_status(self) -> str: raw = self._try_endpoints("pools", ["pool/query", "pool", "storage/pool"]) if raw.startswith("⚠️"): return raw try: pools = json.loads(raw) except Exception: return "Ошибка парсинга" if not pools: return "Активные пулы не найдены." rows = [] for p in pools: name = p.get("name", "?") status = p.get("status", "?") icon = "✅" if p.get("healthy", False) else "⚠️" total = p.get("size", 0) free = p.get("free", 0) used_pct = ((total - free) / total * 100) if total > 0 else 0 rows.append( f"{icon} '{name}' | {status} | {total/1024**4:.2f} TiB, {used_pct:.1f}% занято" ) return "\n".join(rows) def get_disks_temp_and_info(self) -> str: raw = self._try_endpoints("disks", ["disk/query", "disk", "storage/disk"]) if raw.startswith("⚠️"): return raw try: disks = json.loads(raw) except Exception: return "Ошибка парсинга" if not disks: return "Диски не обнаружены." rows = [] for d in disks: name = d.get("name", "N/A") dtype = d.get("type", "N/A") serial = d.get("serial", "N/A") size = f"{int(d['size']) / (1024**3):.1f} GB" if d.get("size") else "N/A" model = d.get("model", "") rows.append(f"💾 {name} ({dtype}) | {model} | {serial} | {size}") return "\n".join(rows) def get_apps_status(self) -> str: """Список установленных приложений (TrueNAS Apps, docker compose).""" raw = self._try_endpoints("apps", ["app/query", "app", "chart/release/query"]) if raw.startswith("⚠️"): return raw try: apps = json.loads(raw) except Exception: return "Ошибка парсинга" if not apps: return "Приложения не установлены." imap = { "RUNNING": "🟢", "STOPPED": "⚪", "DEPLOYING": "🟡", "CRASHED": "🔴", "STOPPING": "🟠", } rows = [] for a in apps: name = a.get("name", a.get("id", "?")) state = a.get("state", a.get("status", "N/A")) version = a.get("human_version", a.get("version", "N/A")) icon = imap.get(str(state).upper(), "⚪") rows.append(f"{icon} {name} | статус: {state} | версия: {version}") return "\n".join(rows) def get_vms_status(self) -> str: """Список виртуальных машин (libvirt/KVM).""" raw = self._try_endpoints("vms", ["vm/query", "vm"]) if raw.startswith("⚠️"): return raw try: vms = json.loads(raw) except Exception: return "Ошибка парсинга" if not vms: return "Виртуальные машины не найдены." rows = [] for vm in vms: name = vm.get("name", "?") status = vm.get("status", {}) state = status.get("state", "N/A") if isinstance(status, dict) else status vcpus = vm.get("vcpus", "N/A") memory = vm.get("memory") mem_s = f"{int(memory) / 1024:.0f} MB" if memory else "N/A" autostart = "✅" if vm.get("autostart") else "❌" icon = "🟢" if str(state).upper() == "RUNNING" else "⚪" rows.append( f"{icon} {name} | статус: {state} | vCPU: {vcpus} | RAM: {mem_s} | автозапуск: {autostart}" ) return "\n".join(rows) def get_containers_status(self) -> str: """Лёгкие контейнеры / инстансы (incus/virt, LXC-подобные).""" raw = self._try_endpoints( "containers", ["virt/instance", "virt/instance/query", "container/query"] ) if raw.startswith("⚠️"): return raw try: instances = json.loads(raw) except Exception: return "Ошибка парсинга" if not instances: return "Контейнеры не найдены." rows = [] for c in instances: name = c.get("name", c.get("id", "?")) status = c.get("status", c.get("state", "N/A")) itype = c.get("type", "N/A") image = c.get("image", {}) image_s = image.get("name", "N/A") if isinstance(image, dict) else image icon = "🟢" if str(status).upper() == "RUNNING" else "⚪" rows.append(f"{icon} {name} | тип: {itype} | статус: {status} | образ: {image_s}") return "\n".join(rows) def get_active_alerts(self) -> str: raw = self._rest_get("alerts", "alert/list") if raw is None: return "⚠️ Ошибка получения алертов" try: alerts = json.loads(raw) except Exception: return "Ошибка парсинга" active = [a for a in alerts if not a.get("dismissed", False)] if not active: return "✅ Все системы работают штатно." rows = [] imap = {"CRITICAL": "🔴", "WARNING": "🟡", "INFO": "🔵"} for a in active: level = a.get("level", "INFO") klass = a.get("klass", "Alert") msg = a.get("formatted", a.get("message", "?")) rows.append(f"{imap.get(level, '⚪')} [{level}] {klass}: {msg}") return "\n".join(rows) def get_full_report(self) -> str: return ( "══════════════════════════════════════════════════\n" "📋 ПОЛНЫЙ ОТЧЁТ TRUENAS\n" "(REST перебор путей)\n" "══════════════════════════════════════════════════\n\n" "--- СИСТЕМА ---\n" + self.get_system_status() + "\n\n" "--- ПУЛЫ ZFS ---\n" + self.get_pools_status() + "\n\n" "--- ДИСКИ ---\n" + self.get_disks_temp_and_info() + "\n\n" "--- ПРИЛОЖЕНИЯ ---\n" + self.get_apps_status() + "\n\n" "--- ВИРТУАЛЬНЫЕ МАШИНЫ ---\n" + self.get_vms_status() + "\n\n" "--- КОНТЕЙНЕРЫ (virt/incus) ---\n" + self.get_containers_status() + "\n\n" "--- АЛЕРТЫ ---\n" + self.get_active_alerts() )