Gestión de KPIs
Los KPIs (Indicadores Clave de Rendimiento) son métricas que se actualizan automáticamente según un calendario. Alimentan tus dashboards, el Business Pulse y el sistema de alertas.
Entendiendo los KPIs
Un KPI se define por:
- Nombre — Etiqueta legible (p. ej., "Ingresos Mensuales")
- Consulta SQL — La consulta que calcula el valor de la métrica
- Calendario — Una expresión cron que define con qué frecuencia se actualiza (p. ej., cada hora, diariamente a las 6am)
- Estado — Activo (ejecutándose según calendario) o Pausado
Crear KPIs
Método 1: Planificador con IA
La forma más rápida de crear KPIs es con el Planificador con IA:
- Ve a Dashboards → KPIs → pestaña Planificador
- Describe los objetivos de tu negocio en el campo de texto
- Haz clic en Generar Sugerencias
La IA sugerirá KPIs relevantes basados en tus datos y objetivos. Para cada sugerencia, puedes:
- Previsualizar el nombre, descripción, consulta SQL y calendario
- Editar cualquier campo antes de activar
- Configurar el backfill — cuántos datos históricos calcular inicialmente
- Activar para comenzar a recolectar datos
Método 2: Asistente de Contexto de Negocio
Durante la configuración del Contexto de Negocio, la IA realiza un análisis de viabilidad y sugiere KPIs como parte del proceso. Puedes seleccionar cuáles crear.
Método 3: Creación Manual
Los usuarios avanzados pueden crear KPIs directamente proporcionando:
- Una consulta SQL que retorne un valor numérico
- Una expresión cron para el calendario
- Un nombre y una descripción
Administrar KPIs
Lista de KPIs
La pestaña de KPIs Activos muestra todos tus KPIs con:
| Columna | Descripción |
|---|---|
| Nombre | Etiqueta del KPI |
| Calendario | Calendario legible (p. ej., "Todos los días a las 6:00 AM") |
| Próxima Ejecución | Cuándo se actualizará el KPI |
| Estado | Activo ✅ o Pausado ⏸️ |
Acciones
| Acción | Descripción |
|---|---|
| Ver Detalles | Ver valores históricos y tendencias |
| Alternar Pulse | Agregar/quitar del Business Pulse en el Dashboard Principal (máx. 6) |
| Pausar/Reanudar | Detener o reiniciar temporalmente la recolección de datos |
| Ejecutar Ahora | Activar un cálculo inmediato |
| Eliminar | Eliminar permanentemente (escribe "delete" para confirmar) |
Business Pulse
Marca hasta 6 KPIs como "Pulse" para mostrarlos de forma prominente en el Dashboard Principal. Los KPIs de Pulse muestran:
- Valor actual con formato
- Indicador de tendencia (▲ sube / ▼ baja / — estable)
- Mini gráfico sparkline de valores recientes
Vista de Detalle del KPI
Haz clic en cualquier KPI para ver su página de detalle:
- Valor Actual — Último valor calculado
- Gráfico Histórico — Gráfico de todos los valores históricos
- Metadatos — Calendario, zona horaria, unidad de medida, configuración de visibilidad
- Ejecutar Ahora — Ejecutar la consulta inmediatamente
Consejos de Calendario: Los calendarios más comunes incluyen:
0 6 * * *— Todos los días a las 6:00 AM0 */4 * * *— Cada 4 horas0 9 * * 1— Todos los lunes a las 9:00 AM0 0 1 * *— Primer día de cada mes a medianoche
La plataforma muestra versiones legibles: "Todos los días a las 6:00 AM"