123 lines
4.1 KiB
Markdown
123 lines
4.1 KiB
Markdown
# TrueNAS Tools
|
|
|
|
## Описание
|
|
Инструменты для мониторинга и управления TrueNAS (WTR PRO, 192.168.31.100) через REST API v2.0.
|
|
|
|
**Версия TrueNAS:** 25.10.5 (Goldeye)
|
|
|
|
## Настройки по умолчанию
|
|
- **TrueNAS URL:** `http://192.168.31.100`
|
|
- **API Key:** задаётся в настройках (Valves)
|
|
- **Кэширование:** 30 секунд (0 = без кэша)
|
|
|
|
## Особенности
|
|
- Автоматический перебор альтернативных путей API (v2.0)
|
|
- Кэширование запросов для снижения нагрузки
|
|
- Диагностика соединения (HTTP/HTTPS, SSL, таймауты)
|
|
|
|
## Доступные функции
|
|
|
|
### get_debug_info()
|
|
Диагностика соединения с TrueNAS: проверяет базовый URL, HTTP/HTTPS, код ответа и текст ошибки для system/info.
|
|
|
|
**Использование:** когда API 'недоступен' и нужно понять, на каком этапе рвётся запрос.
|
|
|
|
**Возвращает:** отчёт о проверке подключения, включая пробу HTTP/HTTPS вариантов.
|
|
|
|
### clear_cache()
|
|
Очистка кэша запросов.
|
|
|
|
### get_system_status()
|
|
Статус системы TrueNAS: версия, аптайм, процессор, load average.
|
|
|
|
**Возвращает:**
|
|
```
|
|
🖥️ TrueNAS: X.Y.Z
|
|
⏱️ Uptime: Xд Xч Xм
|
|
🔧 Процессор: <модель>
|
|
📊 Load Average: 1мин: X.XX, 5мин: X.XX, 15мин: X.XX
|
|
```
|
|
|
|
### get_pools_status()
|
|
Статус пулов ZFS.
|
|
|
|
**Возвращает:** список пулов с статусом, размером, процентом занятости.
|
|
- ✅ — пул здоров
|
|
- ⚠️ — проблемы с пулом
|
|
|
|
**Пример:**
|
|
```
|
|
✅ 'tank' | ONLINE | 0.45 TiB, 16.2% занято
|
|
✅ 'backup' | ONLINE | 1.81 TiB, 23.9% занято
|
|
```
|
|
|
|
### get_disks_temp_and_info()
|
|
Информация о дисках: тип, модель, серийный номер, размер.
|
|
|
|
**Возвращает:** список дисков с основными параметрами.
|
|
|
|
### get_apps_status()
|
|
Список установленных приложений (TrueNAS Apps, docker compose).
|
|
|
|
**Статусы:**
|
|
- 🟢 RUNNING
|
|
- ⚪ STOPPED
|
|
- 🟡 DEPLOYING
|
|
- 🔴 CRASHED
|
|
- 🟠 STOPPING
|
|
|
|
### get_vms_status()
|
|
Список виртуальных машин (libvirt/KVM).
|
|
|
|
**Возвращает:** имя, статус, vCPU, RAM, автозапуск.
|
|
|
|
### get_containers_status()
|
|
Лёгкие контейнеры / инстансы (incus/virt, LXC-подобные).
|
|
|
|
**Возвращает:** имя, тип, статус, образ.
|
|
|
|
### get_active_alerts()
|
|
Активные алерты системы.
|
|
|
|
**Уровни:**
|
|
- 🔴 CRITICAL
|
|
- 🟡 WARNING
|
|
- 🔵 INFO
|
|
|
|
**Возвращает:** `✅ Все системы работают штатно.` или список алертов.
|
|
|
|
### get_full_report()
|
|
Полный отчёт по всей системе TrueNAS.
|
|
|
|
**Включает:**
|
|
- Система (статус, аптайм, CPU, load)
|
|
- Пулы ZFS
|
|
- Диски
|
|
- Приложения
|
|
- Виртуальные машины
|
|
- Контейнеры
|
|
- Алерты
|
|
|
|
## Текущая конфигурация системы
|
|
|
|
### Пools
|
|
| Pool | Диски | Занято |
|
|
|------|-------|--------|
|
|
| `tank` | 1x WD05PURX 465.8GB (sda) | 16.2% |
|
|
| `backup` | 1x WD20EFAX 2TB (sdb) | 23.9% |
|
|
| `ssd` | mirror: nvme0n1 (ADATA 1.9TB) + nvme2n1 (Samsung 2TB) | 8.0% |
|
|
| `video` | 1x WD05PURX 465.8GB (sda) | 0.45 TiB |
|
|
|
|
### Дополнительные диски
|
|
- `nvme1n1` — CUSU CV3500M 512GB, свободен, не привязан к пулу
|
|
|
|
### Репликации (активные)
|
|
- `tank/media` → `backup/media`
|
|
- `tank/nextcloud` → `backup/document`
|
|
- `tank/movies` → `backup/movies`
|
|
- `ssd/virtual` → `backup/virtual`
|
|
- `ssd/virtual-iso` → `backup/virtual-iso`
|
|
- `ssd/apps` → `backup/apps`
|
|
|
|
Все репликации успешны.
|