docs(okf): entidades e relacionamentos OKF do DashDescomplicar

2026-10-28 16:01:20 +00:00
parent f063a2ec8c
commit 61ae4697f9
48 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,53 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, backend, integracao, ssh, metricas]
+title: "Integracao-SSH-Metrics"
+---
+
+# Integracao-SSH-Metrics
+
+Colector de métricas de servidores via SSH (biblioteca `ssh2`). Recolhe CPU, RAM, disco, load e containers do EasyPanel Server.
+
+## Responsabilidades
+
+- **SSH Connection**: Ligação ao EasyPanel (`5.9.90.70:22`) com password auth
+- **Métricas**: Executa comandos remotos para recolher CPU%, RAM%, disco%, load avg, nº containers
+- **Parsing**: Extrai valores de output formatado (`CPU:`, `MEM:`, `DISK:`, `LOAD:`, `CONTAINERS:`)
+- **Sync**: Sincroniza servidores Hetzner para `tbl_eal_monitoring`
+
+## Stack
+
+- **Library**: `ssh2` 1.17 (Client, exec)
+- **Timeout**: 20 segundos por ligação SSH
+- **Auth**: Password (não suporta chave privada no container)
+
+## Servidores
+
+| Nome | Host | Porta | Auth | Notas |
+|---|---|---|---|---|
+| EasyPanel | `5.9.90.70` | 22 | Password | Docker Swarm — 46 serviços |
+| CWP Server | `5.9.90.105` | 22 | ❌ Chave ed25519 | NÃO acessível do container |
+
+## Rotas
+
+| Método | Rota | Função |
+|---|---|---|
+| `POST` | `/api/server-metrics/collect` | Recolher todas as métricas |
+| `POST` | `/api/server-metrics/ssh` | Apenas métricas SSH |
+| `POST` | `/api/server-metrics/hetzner` | Sync Hetzner → monitoring |
+
+## Localizações
+
+- **Código**: `api/services/server-metrics.ts` (188 linhas), `api/routes/server-metrics.ts` (68 linhas)
+- **DB**: `tbl_eal_monitoring`
+
+## Dependências
+
+- **EasyPanel Server**: SSH acesso (`.env`: `EASY_HOST`, `EASY_USER`, `EASY_PASS`)
+- **MySQL-Pool**: Armazenamento de métricas
+
+## Fornece a
+
+- **Painel-Monitor**: Métricas SSH exibidas na secção "Infraestrutura"
+- **Express-API**: Rota `/api/server-metrics`