Saltar a contenido

La Directa WooCommerce Observability Strategy Intake

Fecha: 2026-06-17

Resumen ejecutivo

El requerimiento integral de observabilidad WooCommerce para La Directa queda dividido en 4 fases para no mezclar responsabilidades entre OpenClaw y el stack nativo del ecommerce.

  • OpenClaw puede avanzar ahora solo con Fase 1 usando observabilidad sintetica y publica ya compatible con el contrato actual.
  • Fase 2, Fase 3 y Fase 4 requieren handoff al repo La Directa para que La Directa Ops publique endpoints, exporters o agregados seguros.
  • No corresponde consultar la DB productiva WooCommerce desde Grafana, Prometheus ni dashboards de OpenClaw.
  • Toda metrica futura debe evitar PII, order_id, emails, telefonos, nombres de clientes y labels de alta cardinalidad.

Lo que ya cubren los docs existentes

Cobertura ya documentada en OpenClaw

  • docs/governance/CROSS-PROJECT-OPERATIONS.md ya fija el contrato consumidor/productor y la separacion obligatoria por repo y VPS.
  • docs/runbooks/SAFE-POINT-040-ladirecta-observability-contract.md ya deja formalizada la metodologia multi-proyecto.
  • docs/tenants/ladirecta/observability/OBSERVABILITY-CONTRACT.md ya define que OpenClaw observa y La Directa produce datos, metricas y eventos.
  • docs/tenants/ladirecta/observability/METRICS-CATALOG.md ya lista la primera capa de metricas actuales y futuras.
  • docs/tenants/ladirecta/observability/DASHBOARD-PLAN.md y ALERTS-PLAN.md ya separan cobertura actual y futura por fases.
  • docs/OBSERVABILITY-PLAN.md ya certifica que Fase 1 existe hoy en OpenClaw con Blackbox, SSL, latencia y alertas sinteticas.

Cobertura ya materializada hoy

  • monitoreo Blackbox de https://ladirecta.com.ar/ y https://ladirecta.ar/
  • SSL days remaining
  • latencia HTTP publica
  • disponibilidad publica
  • dashboard Ecommerce La Directa
  • alertas de sitio caido, SSL y latencia
  • acceso Grafana por monitor.ladirecta.com.ar y monitor.ladirecta.ar
  • canal SMTP de alertas La Directa operativo del lado OpenClaw

Gaps detectados

Gaps de Fase 1

  • falta explicitar como coverage formal las paginas criticas publicas adicionales a home
  • falta documentar redirects esperados y validarlos como señal de salud
  • falta distinguir mejor dashboards basicos operativos vs ejecutivos
  • falta un intake unico que ordene el requerimiento integral extremo a extremo

Gaps de Fase 2

  • no existe evidencia versionada en OpenClaw de endpoint/exporter seguro publicado por La Directa Ops
  • no hay productor formal para backup freshness
  • no hay productor formal para restore drill age/status
  • no hay productor formal para health WordPress/WooCommerce
  • no hay productor formal para Redis/cache, SMTP, servicios criticos o logs resumidos sin PII
  • no hay productor formal para metricas de infraestructura del VPS WooCommerce

Gaps de Fase 3

  • no existe agregado seguro para pedidos, ventas, ticket promedio ni estados de pedido
  • no existe agregado seguro para stock, productos sin imagen ni embudo de carrito/checkout
  • no existe contrato de retencion, frecuencia ni ownership para KPIs comerciales WooCommerce

Gaps de Fase 4

  • no existe modelo de integracion para ERP, campañas, WhatsApp, recurrencia, prediccion de quiebre, anomalias ni reportes IA
  • no existe definicion de si esas salidas viviran en Prometheus, snapshots analiticos o un canal de reportes separado

Matriz OpenClaw vs La Directa

Dominio OpenClaw La Directa
probes publicos consume y alerta no requerido
dashboards disena, provisiona y publica aporta definiciones de negocio
alertas evalua, enruta y documenta aporta umbrales y owner funcional
blackbox HTTP/SSL si, hoy no requerido
health interno Woo consume solo si existe productor seguro debe producir
backups y restore consume estado resumido debe producir
SMTP Woo consume estado resumido debe producir
logs Woo resumidos consume conteos y severidad debe producir sin PII
host metrics Woo consume exporter privado debe producir
KPIs comerciales consume agregados anonimizados debe producir
integraciones avanzadas visualiza y alerta si aplica debe producir y curar

Fases resultantes

Fase 1 - OpenClaw sin tocar WooCommerce

Alcance habilitado ahora

  • disponibilidad web publica
  • SSL
  • latencia
  • HTTP status
  • redirects publicos
  • paginas criticas publicas
  • Blackbox
  • dashboards basicos
  • alertas sitio/SSL/latencia

Que puede hacer OpenClaw ahora

  • ampliar probes publicos sin tocar WordPress, WooCommerce ni el VPS Woo
  • agregar targets por pagina critica publica como:
  • /
  • /shop/ o equivalente publico aprobado
  • /cart/
  • /checkout/
  • validar HTTP 200/301/302 esperados y detectar loops o desvio anomalo
  • construir dashboards basicos separados:
  • disponibilidad web
  • estado SSL
  • latencia y codigos HTTP
  • paginas criticas publicas
  • definir alertas sinteticas sobre sitio, SSL, latencia y paginas criticas

Metricas nuevas o ampliadas

  • http_status_code por target publico
  • redirect_ok por target publico esperado
  • critical_page_up por target publico
  • critical_page_latency_seconds
  • critical_page_ssl_days_remaining cuando aplique

Dashboards propuestos

  • La Directa - Web Availability
  • La Directa - Public Critical Pages
  • La Directa - Executive Overview reforzado con cobertura actual real

Alertas propuestas

  • sitio principal caido
  • sitio secundario caido
  • SSL warning
  • SSL critical
  • latencia alta sostenida
  • pagina critica publica caida
  • redirect inesperado o loop
  • HTTP status fuera de baseline esperado

Dependencias

  • no requiere handoff tecnico al repo La Directa para home y dominios ya publicos
  • si requiere validacion funcional del listado final de paginas criticas publicas permitido monitorear

Fase 2 - Requiere endpoint/exporter seguro La Directa Ops

Alcance

  • backup freshness
  • restore drill
  • SMTP status
  • health WordPress/WooCommerce
  • Redis/cache
  • servicios criticos
  • logs resumidos sin PII
  • infraestructura VPS Woo

Que requiere handoff al repo La Directa

  • exporter o endpoint privado autenticado para salud Woo
  • esquema de respuesta con timestamps, estados y contadores
  • definicion de SLA y ventanas para backup y restore drill
  • definicion de conteos de logs por severidad y componente sin payload bruto
  • producer de CPU, RAM, disco y servicios criticos del host Woo

Metricas nuevas o ampliadas

  • backup_last_success_age_seconds
  • restore_drill_last_success_age_seconds
  • smtp_last_check_success
  • wp_health_status
  • woo_health_status
  • redis_health_status
  • critical_service_status
  • critical_log_events_total por severity y component
  • host_cpu_usage_ratio
  • host_memory_usage_ratio
  • host_disk_usage_ratio

Dashboards propuestos

  • La Directa - Woo Operations
  • La Directa - Backups and Restore
  • La Directa - Infrastructure
  • La Directa - Email and Notifications

Alertas propuestas

  • backup fuera de SLA
  • restore drill vencido
  • WordPress degradado
  • WooCommerce degradado
  • Redis/cache degradado
  • SMTP fallando
  • servicio critico caido
  • logs criticos por encima de umbral
  • disco alto
  • CPU alta sostenida
  • RAM alta sostenida

Fase 3 - Metricas comerciales WooCommerce agregadas

Alcance

  • pedidos
  • ventas
  • ticket promedio
  • estados de pedido
  • productos activos/sin stock/bajo stock
  • productos sin imagen
  • carrito/checkout
  • metricas sin PII

Que requiere handoff al repo La Directa

  • agregados anonimizados por ventana temporal
  • contrato de negocio por metrica, formula y timezone
  • definicion de estados Woo agrupados a taxonomia estable
  • definicion de fuente para productos sin imagen y bajo stock
  • definicion de embudo carrito/checkout sin exponer sesiones individuales

Metricas nuevas o ampliadas

  • orders_total
  • orders_revenue_total
  • average_order_value
  • orders_by_status_total
  • active_products_total
  • out_of_stock_products_total
  • low_stock_products_total
  • products_without_image_total
  • cart_starts_total
  • checkout_starts_total
  • checkout_completions_total
  • checkout_conversion_ratio

Dashboards propuestos

  • La Directa - Orders and Revenue
  • La Directa - Catalog Health
  • La Directa - Cart and Checkout
  • La Directa - Executive Overview ampliado solo cuando existan productores

Alertas propuestas

  • pedidos fallidos sobre baseline
  • pedidos pendientes anormalmente altos
  • conversion checkout debajo de baseline
  • sin stock por encima de umbral
  • productos sin imagen por encima de umbral

Fase 4 - Integracion avanzada

Alcance

  • ERP/stock real
  • campañas Meta/Google/email
  • WhatsApp
  • clientes recurrentes agregados
  • prediccion de quiebre
  • anomalias comerciales
  • reportes IA

Que requiere handoff al repo La Directa

  • fuentes curadas multi-sistema
  • modelo de identidad comercial agregado
  • reglas de attribution por canal
  • definicion de si las salidas son metricas de series, snapshots o reportes
  • controles de privacidad y explicabilidad para salidas IA

Metricas nuevas o ampliadas

  • real_stock_coverage_days
  • campaign_spend_total
  • campaign_revenue_attributed_total
  • repeat_customers_ratio
  • whatsapp_conversations_total
  • stockout_risk_score
  • commercial_anomaly_score

Dashboards propuestos

  • La Directa - Revenue Attribution
  • La Directa - Demand and Stock Risk
  • La Directa - Retention and Repeat Customers
  • La Directa - AI Commercial Reports

Alertas propuestas

  • riesgo de quiebre alto
  • anomalia comercial persistente
  • desviacion severa entre stock real y stock web agregado
  • ROI de campaña por debajo de umbral durante ventana acordada

Riesgos de privacidad, PII y cardinalidad

  • no usar order_id, customer_id, email, telefono, nombre, direccion ni contenido de pedido como labels
  • no exponer payload de logs, excepciones ni mensajes de checkout con datos de cliente
  • no usar sku o product_name como labels de alta cardinalidad; si hiciera falta segmentar, usar categorias acotadas o snapshots fuera de Prometheus
  • no exportar listas de pedidos, clientes o carritos abandonados a OpenClaw
  • no inferir salud interna Woo a partir de sintomas externos como si fueran causa raiz

Proximos safe points recomendados

  1. SAFE-POINT OpenClaw Fase 1 public critical pages para ampliar solo Blackbox, dashboards y alertas publicas.
  2. SAFE-POINT La Directa producer contract Fase 2 en el repo C:\APV\vps-woocommerce-ladirecta para definir exporter o endpoint seguro operativo.
  3. SAFE-POINT OpenClaw Fase 2 consumer onboarding para consumir el productor seguro ya documentado del lado La Directa.
  4. SAFE-POINT La Directa commercial aggregates Fase 3 para formalizar KPIs WooCommerce agregados sin PII.
  5. SAFE-POINT OpenClaw Fase 3 executive and commercial dashboards una vez que los agregados existan y tengan contrato estable.

Decision operativa actual

  • OpenClaw puede seguir hoy con monitoreo publico, SSL, latencia, status, redirects y paginas criticas publicas.
  • Todo lo que dependa de salud interna Woo, backups, restore, SMTP, logs, host metrics o KPIs comerciales queda PENDIENTE DE LA DIRECTA.
  • Ninguna metrica futura queda declarada como existente hasta que haya productor seguro versionado y validado.