Diagrama de flujo de observabilidad
Section titled “Diagrama de flujo de observabilidad”flowchart TD U["OpenCode / OpenWebUI / API"] --> G["Gateway :8008"] G --> C["Client/Profile Guard"] C --> R["Route Classifier"] R --> P["Payload Builder"] P --> M["Memory Injector"] M --> T["Tool Policy"] T --> MR["Model Router"] MR --> LM["LM Studio RX9070"] LM --> RESP["Response"] RESP --> AUD["Governance Audit JSONL"] RESP --> MET["Prometheus Metrics"] RESP --> QD["Qdrant Memory"] MET --> PR["Prometheus :9090"] PR --> GF["Grafana :3000"] AUD --> REP["Request Replay API"] REP --> OPS["Ops Debug"]
Infraestructura
Section titled “Infraestructura”| Componente | Host | Puerto | Estado |
|---|---|---|---|
| Prometheus | 192.168.1.40 | 9090 | Active |
| Grafana | 192.168.1.40 | 3000 | Active |
| Router métricas | 192.168.1.30 | 8083 | Active |
| Gateway métricas | 192.168.1.30 | 8008 | Active |
| LM Studio | 192.168.1.50 | 1234 | Active (RX9070) |
Dashboards — TIER 1 (Operación diaria)
Section titled “Dashboards — TIER 1 (Operación diaria)”| # | Dashboard | UID | Descripción |
|---|---|---|---|
| 00 | Executive Overview | ai-lab-overview | Salud general, burn-in mode, route dominance, contamination |
| 01 | Routing & Models | ai-lab-runtime | Rutas, latencia, tokens, modelos seleccionados |
| 02 | Cognitive Profiles | ai-lab-profiles | Distribución de perfiles, modelo por perfil |
| 03 | Tool Governance | ai-lab-tools | Tools bloqueadas, 428 gate, question stripped, bash sanitizer |
| 04 | Memory Runtime | ai-lab-memory | Recall, skip reasons, contamination, hard caps, quality score |
| 05 | Route Family Observability | ai-lab-route-family | Latencia p95/p99, errores, prompt tokens por familia |
| 06 | Incidents & Audit | ai-lab-incidents | Bloqueos, governance, fallback loops |
| 07 | Request Traceability | ai-lab-traceability | Replay API guide, drift signals, errors |
Dashboards — TIER 2 (Troubleshooting)
Section titled “Dashboards — TIER 2 (Troubleshooting)”| Dashboard | UID | Uso |
|---|---|---|
| AI-LAB Execution & Safety | ai-lab-safety | Seguridad y bloqueos detallados |
| AI-LAB GPUs | ai-lab-gpus | VRAM, temperatura, uso GPU |
| AI-LAB Infrastructure | ai-lab-infra | Docker, host, red |
| AI-LAB Production Burn-In | ai-lab-burnin | Burn-in dashboard (temporal) |
Métricas Prometheus (todas)
Section titled “Métricas Prometheus (todas)”Perfiles cognitivos
Section titled “Perfiles cognitivos”ailab_profile_total{profile, route_family, model}Tool governance
Section titled “Tool governance”ailab_tool_call_total{tool_name, result, policy, mode}ailab_tool_fastpath_totalailab_tool_fastpath_fallback_totalailab_tool_calls_malformed_totalailab_tool_empty_arguments_totalailab_tool_question_stripped_totalailab_confirmation_required_totalMemory runtime
Section titled “Memory runtime”ailab_memory_recall_total{policy, hit}ailab_memory_chars_injected{policy} (histogram)ailab_memory_items_total{policy, source}ailab_memory_contamination_risk{policy} (histogram)ailab_memory_quality_score{policy} (histogram)ailab_context_cap_exceeded_total{policy}Routing
Section titled “Routing”ailab_route_family_total{family}ailab_route_family_latency_ms{family} (histogram)ailab_route_family_prompt_tokens_total{family}ailab_route_family_completion_tokens_total{family}ailab_route_family_errors_total{family}ailab_route_family_blocked_total{family}Governance
Section titled “Governance”ailab_governance_blocked_actions_totalailab_governance_blocked_actions_by_reason_total{reason}Alertas Prometheus (18 reglas)
Section titled “Alertas Prometheus (18 reglas)”| Alerta | Severidad | Detecta |
|---|---|---|
MinimalRouteRegression | warning | Contexto pesado en ruta ligera |
ToolFastpathLatencySpike | critical | Fastpath roto |
CognitiveRouteExplosion | warning | Recall runaway |
RouteFamilyErrorRate | critical | Errores recientes |
GovernanceBlocksSpike | warning | Abuso de prompts/tools |
ProfileUnknown | warning | Perfil no clasificado |
ToolBudgetExceeded | warning | Tools bloqueadas por politica |
MemoryFallback | warning | Memory injector fallando |
MemoryActivatedInMinimal | critical | Fuga de memoria en minimal |
MemoryCharsOverBudget | warning | Light policy excediendo budget |
MemoryContaminationHigh | warning | Contaminacion alta en recall |
MemoryHitRatioLow | warning | Bajo ratio de hits |
QuestionToolLeakage | critical | Question tool detectada |
EmptyArgumentsSpike | warning | Bash tools sin argumentos |
ConfirmationRequired | info | 428 gate activado |
MinimalRouteDominance | warning | Minimal perdiendo dominancia |
ToolFastpathLeakage | warning | Tool fastpath inesperado |
ContextCapExceeded | warning | Hard cap excedido |
Replay y Analytics API
Section titled “Replay y Analytics API”# Full request replaycurl http://192.168.1.30:8083/api/request/replay/{request_id}
# Timeline estructuradacurl http://192.168.1.30:8083/api/request/flow/{request_id}
# Drift analyticscurl http://192.168.1.30:8083/api/analytics/drift
# Recall ROIcurl http://192.168.1.30:8083/api/analytics/recall-roi
# Memory replaycurl http://192.168.1.30:8083/api/memory/replay?limit=10Provisioning
Section titled “Provisioning”Los dashboards se cargan desde:
/home/albert/docker/monitorizacion/grafana/provisioning/dashboards/AI-LAB/Reload sin reiniciar:
docker exec grafana kill -HUP 1Alertas:
/home/albert/docker/monitorizacion/prometheus/config/rules/ai-lab-route-family-alerts.ymlBurn-In Mode (FASE 26.1)
Section titled “Burn-In Mode (FASE 26.1)”- Nodo único: RX9070 (192.168.1.50:1234)
- Scheduler multi-GPU: OFF
- Duración: 48-72h
- Dashboards: Executive Overview + Burn-In + Route Family
- Grafana:
http://192.168.1.40:3000(admin / 19682507) - Prometheus:
http://192.168.1.40:9090 - Router métricas:
http://192.168.1.30:8083/metrics - Gateway métricas:
http://192.168.1.30:8008/metrics