feat(infraestrutura): adiciona plugin infraestrutura (agents, skills, knowledge e metadados do projeto)

2026-10-28 16:09:01 +00:00
parent de2d6f2fb5
commit e43fec3bd9
73 changed files with 8589 additions and 0 deletions
@@ -0,0 +1,204 @@
+---
+name: easypanel-monitor
+description: Monitorizacao de servicos EasyPanel -- estado de todos os servicos Docker, uso de recursos, disco e logs de erros com tabela resumo OK/DOWN/WARN.
+layer: wiki
+---
+
+# /easypanel-monitor - Monitorizacao EasyPanel
+
+Verificacao rapida do estado de todos os servicos no EasyPanel (VM 101) com identificacao de problemas.
+
+---
+
+## Quando usar
+
+- Verificacao diaria do estado dos servicos
+- Apos alertas de servicos down
+- Antes de deploys (validar estado actual)
+- Diagnostico rapido de problemas de recursos
+
+## Quando nao usar
+
+- Para troubleshooting aprofundado de um servico especifico (usar `/easypanel-troubleshoot`)
+- Para rollback de versao (usar `/easypanel-rollback`)
+- Para deploy de servicos (usar `/easypanel-deploy`)
+
+---
+
+## Sintaxe
+
+```bash
+/easypanel-monitor              # Check completo (servicos + recursos + disco)
+/easypanel-monitor quick        # Apenas estado dos servicos (OK/DOWN)
+/easypanel-monitor <servico>    # Detalhe de um servico especifico (logs + stats)
+```
+
+---
+
+## Servidor alvo
+
+| Alias SSH | IP | Porta | Funcao |
+|-----------|-----|-------|--------|
+| **easy** | 5.9.90.70 | 22 | EasyPanel (VM 101) |
+
+```javascript
+mcp__ssh-unified__ssh_execute({
+  server: "easy",
+  command: "<comando>"
+})
+```
+
+---
+
+## Workflow completo
+
+### Passo 1: Estado dos servicos (docker service ls)
+
+```bash
+docker service ls --format "table {{.Name}}\t{{.Replicas}}\t{{.Image}}\t{{.Ports}}"
+```
+
+**Classificacao:**
+- **OK** - Replicas X/X (todas activas)
+- **DOWN** - Replicas 0/X (nenhuma activa)
+- **WARN** - Replicas parciais ou servico sem replicas esperadas
+
+### Passo 2: Identificar servicos DOWN (0/N replicas)
+
+```bash
+docker service ls --format "{{.Name}} {{.Replicas}}" | awk '$2 ~ /^0\//'
+```
+
+Para cada servico DOWN, obter logs:
+
+```bash
+docker service logs <nome-servico> --tail 10 --no-trunc 2>&1
+```
+
+### Passo 3: Uso de recursos via API (preferido)
+
+```bash
+TOKEN=$(cat /etc/easypanel/.api-token)
+
+# Stats do sistema — retorna estrutura aninhada
+curl -s "http://localhost:3000/api/trpc/monitor.getSystemStats" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+**Estrutura real da resposta (verificado 24-03-2026):**
+```json
+{
+  "result": {
+    "data": {
+      "json": {
+        "uptime": 3118351.41,
+        "memInfo": {
+          "totalMemMb": 32096.51,
+          "usedMemMb": 16885.52,
+          "freeMemMb": 15210.99,
+          "usedMemPercentage": 52.61,
+          "freeMemPercentage": 47.39
+        },
+        "diskInfo": {
+          "totalGb": "192.7",
+          "usedGb": "89.7",
+          "freeGb": "103.0",
+          "usedPercentage": "46.5",
+          "freePercentage": "53.5"
+        },
+        "cpuInfo": {
+          "usedPercentage": 13.65,
+          "count": 6,
+          "loadavg": [5.58, 6.34, 6.51]
+        },
+        "network": {
+          "inputMb": 0,
+          "outputMb": 0
+        }
+      }
+    }
+  }
+}
+```
+
+**Campos a usar:**
+- CPU: `cpuInfo.usedPercentage`
+- RAM: `memInfo.usedMemPercentage` e `memInfo.usedMemMb`
+- Disco: `diskInfo.usedPercentage` e `diskInfo.usedGb`
+
+**Fallback via SSH (se API indisponivel):**
+```bash
+docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.MemPerc}}\t{{.NetIO}}\t{{.BlockIO}}"
+```
+
+**Thresholds:**
+
+| Metrica | OK | WARN | CRITICAL |
+|---------|-----|------|----------|
+| CPU | <70% | 70-90% | >90% |
+| RAM | <70% | 70-85% | >85% |
+| RAM absoluto | <512MB | 512MB-1GB | >1GB |
+
+### Passo 4: Espaco em disco (via API ou fallback)
+
+Usar `diskInfo` da resposta do passo 3. Fallback:
+
+```bash
+df -h / /var/lib/docker
+```
+
+**Thresholds:**
+
+| Disco | OK | WARN | CRITICAL |
+|-------|-----|------|----------|
+| / | <70% | 70-85% | >85% |
+| /var/lib/docker | <70% | 70-85% | >85% |
+
+Verificar imagens Docker nao utilizadas:
+
+```bash
+docker system df
+```
+
+### Passo 5: Logs de erros recentes (servicos com problemas)
+
+Para servicos DOWN ou WARN:
+
+```bash
+docker service logs <nome-servico> --tail 10 --no-trunc 2>&1 | grep -iE "error|fatal|panic|oom|killed|fail"
+```
+
+### Passo 6: Verificar tarefas falhadas
+
+```bash
+docker service ls -q | xargs -I {} docker service ps {} --format "{{.Name}} {{.CurrentState}} {{.Error}}" --filter "desired-state=shutdown" 2>/dev/null | grep -i "failed\|rejected\|error" | head -20
+```
+
+---
+
+## Template de output
+
+```markdown
+## EasyPanel Monitor - [DATA]
+
+**Servidor:** easy.descomplicar.pt (5.9.90.70)
+
+### Estado dos servicos
+
+| Servico | Replicas | Estado | CPU | RAM | Notas |
+|---------|----------|--------|-----|-----|-------|
+| descomplicar_api | 1/1 | OK | 2.3% | 128MB | - |
+| descomplicar_n8n | 1/1 | OK | 5.1% | 256MB | - |
+| descomplicar_db | 0/1 | DOWN | - | - | Connection refused |
+| descomplicar_redis | 1/1 | WARN | 85% | 490MB | CPU elevado |
+
+**Resumo:** X/Y servicos OK | Z DOWN | W WARN
+
+### Disco
+
+| Mount | Usado | Disponivel | % | Estado |
+|-------|-------|------------|---|--------|
+| / | 45G | 55G | 45% | OK |
+| /var/lib/docker | 30G | 70G | 30% | OK |
+
+Docker system: X imagens, Y containers, Z volumes (