Observabilidad y monitoreo

Zentto incluye un stack de observabilidad empresarial que monitorea toda la plataforma en tiempo real.

Acceso a dashboards

Herramienta	URL	Uso
Kibana	kibana.zentto.net	Dashboards, logs, alertas
Kafka UI	kafka.zentto.net	Cola de eventos, topics

¿Qué se monitorea?

Operaciones en tiempo real

• Requests por segundo a la API
• Códigos de respuesta (200, 400, 500)
• Latencia promedio por endpoint
• Usuarios activos concurrentes

📸 Captura: Dashboard de operaciones en Kibana

Errores y excepciones

• Errores por hora con tendencia
• Top 10 errores más frecuentes
• Stack traces para debugging
• Alertas automáticas cuando el error rate sube

Auditoría y seguridad

• Logins exitosos y fallidos
• Cambios en configuración
• Accesos por empresa y usuario
• Mapa geográfico de conexiones

Rendimiento

• Percentiles de latencia (P50, P95, P99)
• Requests lentos (>1 segundo)
• Throughput por servicio

Business Intelligence

• Facturas emitidas por día
• Ventas POS vs Web
• Leads CRM creados vs cerrados
• Nuevos clientes por semana
• Países de acceso

📸 Captura: Dashboard de Business Intelligence

Infraestructura

• CPU y memoria por contenedor Docker
• Logs por servicio
• Restarts de contenedores
• Uso de disco

Zentto Notify

• Emails enviados por hora
• Tasa de entrega, apertura y clicks
• Fallos por canal (Email, WhatsApp, SMS)

Mobile

• Sesiones por app (Store, Ops, Rest, CRM)
• Endpoints más usados desde móvil
• Push notifications enviadas vs abiertas

Alertas automáticas

Alerta	Cuándo se dispara	Notificación
Error spike	>10 errores 5xx en 5 min	Email + Slack
API lenta	P95 > 3s por 10 min	Slack
Fuerza bruta	>20 login fallidos de misma IP en 1 min	Bloqueo + Email
Disco lleno	>85% uso de disco	Email
Container caído	Unhealthy > 2 min	Slack + Email
Sin tráfico	0 requests por 5 min	Email urgente

Cómo usar Kibana

Buscar logs

1. Abre kibana.zentto.net
2. Ve a Discover en el menú lateral
3. Selecciona el index pattern zentto-api-logs-*
4. Usa la barra de búsqueda para filtrar:
   • statusCode:500 — Solo errores
   • method:POST AND path:"/v1/facturas" — Creación de facturas
   • companyId:1 AND durationMs>1000 — Requests lentos de una empresa
   • event:"invoice.created" — Eventos de negocio específicos

Crear visualizaciones

1. Ve a Visualize Library
2. Clic en Create visualization
3. Selecciona el tipo (línea, barra, pie, tabla, mapa)
4. Elige el index pattern y configura los ejes
5. Guarda y agrégala a un dashboard

Crear dashboards

1. Ve a Dashboard
2. Clic en Create dashboard
3. Agrega visualizaciones existentes
4. Configura el rango de tiempo (últimas 24h, 7 días, etc.)
5. Guarda el dashboard

Arquitectura del stack

Zentto API → Kafka (8 topics) → Logstash → Elasticsearch → Kibana
                                                ↑
Docker containers → Filebeat ─────────────────────┘

Topics de Kafka

Topic	Datos	Retención
zentto-api-logs	HTTP requests, info	7 días
zentto-api-errors	Errores 5xx, excepciones	30 días
zentto-api-audit	Login, cambios, accesos	90 días
zentto-api-performance	Latencia, queries lentas	7 días
zentto-api-events	Eventos de negocio	30 días
zentto-docker-logs	Logs de contenedores	3 días
zentto-notify-logs	Logs de Notify	14 días
zentto-mobile-events	Eventos de apps	14 días