Métricas de transacciones de nómina (admin)
Métricas es una sección de administración en Global Payroll que muestra estadísticas de tiempo de procesamiento de las transacciones de nómina de tu empresa. Se basa en el historial de transacciones finalizadas y ayuda a entender cuánto demora procesar nóminas según el volumen (una sola, decenas o cientos/miles en lote).
¿Qué problema resuelve?
Situación | Antes | Ahora |
|---|---|---|
Planificar un cierre con lote grande | Estimar tiempos sin visibilidad centralizada en el producto | Consultar estimaciones históricas para lotes ~1.000 nóminas |
Detectar demoras inusuales | Revisar caso a caso o depender de soporte | Ver resumen, tendencia mensual y transacciones recientes del tenant |
Comparar operación unitaria vs. masiva | Sin benchmark interno en la UI | Escenarios de referencia una nómina y lote ~1.000 en la misma pantalla |
¿Quién puede usarla?
Solo usuarios con rol admin del tenant. Perfiles sin rol admin no ven la sección en el menú lateral ni pueden obtener los datos por API.
¿Dónde está en la aplicación?
Nómina → Gestión → Administración → Métricas
La ruta sigue el patrón de otras secciones de administración (por ejemplo, Auditoría) y respeta la legislación configurada en tu tenant.
Configuración y administración (solo admin)
Habilitación
No requiere configuración adicional ni activación por tenant: tras el despliegue de payroll-api y payroll-app, la sección está disponible para todos los tenants donde el usuario tenga rol admin.
Permisos y seguridad
Aspecto | Comportamiento |
|---|---|
Rol requerido | Admin del tenant |
Usuarios no admin | No ven la sección; si intentan consumir el servicio de análisis reciben error de autorización |
Alcance de datos | Solo transacciones del tenant actual |
Tipo de operación | Solo lectura — no altera nóminas, períodos ni transacciones |
Qué datos se analizan
El análisis considera transacciones de nómina que cumplan todas estas condiciones:
- Estado finalizado (finished)
- Cantidad de nóminas procesadas mayor que cero (quantity > 0)
- Duración calculada como tiempo entre creación y última actualización de la transacción
Las transacciones en otros estados o sin cantidad no entran en las métricas agregadas.
Rango de fechas
- Debes indicar fecha desde y fecha hasta (inclusive).
- El rango máximo permitido es de 12 meses.
- Rangos inválidos (fechas mal formadas, desde posterior a hasta, o más de 12 meses) muestran un mensaje de error claro; no se devuelve un error genérico del servidor.
Escenarios de estimación práctica
La pantalla destaca dos escenarios de referencia para interpretar tiempos en operación real:
Escenario | Qué representa | Criterio de selección |
|---|---|---|
Una nómina(single_payroll) | Procesamiento unitario | Transacciones con cantidad = 1 |
Lote ~1.000 (bulk_1000) | Cierre masivo típico | Cantidad entre 990 y 1.030, procesamiento en lote (bulk) asociado a un período |
Para cada escenario se muestran mediana, promedio, percentil 90 (P90), tiempo por nómina y cantidad de muestras. Si hay pocas muestras, usa el conteo para valorar la confianza del dato.
Análisis por tamaño de lote
Además de los escenarios prácticos, el resumen agrupa transacciones por buckets de tamaño:
Bucket | Cantidad de nóminas en la transacción |
|---|---|
1 | Exactamente 1 |
2–10 | De 2 a 10 |
11–50 | De 11 a 50 |
51–200 | De 51 a 200 |
201+ | Más de 200 |
Otros bloques de la pantalla
- Resumen global del período seleccionado
- Desglose por estado de transacciones
- Regresión lineal (relación duración vs. cantidad), cuando hay suficientes datos
- Tendencia mensual de duración
- Transacciones recientes para contexto operativo
Si hay menos de dos transacciones finalizadas en el rango, la regresión puede no mostrarse. Si no hay transacciones, los contadores aparecen en cero o vacíos sin error.
Fuera de alcance
- No modifica la forma en que se ejecutan procesamientos bulk ni jobs en segundo plano.
- No sustituye monitoreo de infraestructura (APM, logs centralizados).
- No está disponible para roles distintos de admin.
Guía de uso (usuario final)
Consultar métricas de procesamiento
- Inicia sesión con un usuario admin en Global Payroll.
- Abre Gestión → Administración → Métricas en el menú lateral.
- Selecciona el rango de fechas que quieres analizar (máximo 12 meses).
- Revisa el resumen global y el desglose por estado.
- Compara los escenarios Una nómina y Lote ~1.000 para planificar cierres.
- Explora los buckets por tamaño de lote si necesitas granularidad por volumen.
- Consulta la tendencia mensual para ver si los tiempos mejoran o empeoran.
- Usa el listado de transacciones recientes para casos puntuales.
Cómo interpretar las estimaciones
- Mediana y promedio indican el tiempo total típico del escenario en el rango elegido.
- P90 muestra un caso conservador: el 90 % de las transacciones del escenario tardó menos que ese valor.
- Tiempo por nómina ayuda a extrapolar lotes de distinto tamaño.
- Cantidad de muestras (samples_count) y porcentaje del total (share_percent) indican si el dato es representativo. Con pocas muestras en Lote ~1.000, trata mediana y P90 como orientativos.
Benchmark de referencia (lote ~1.000)
En validaciones internas con ~42 muestras históricas del escenario bulk_1000 se observaron órdenes de magnitud similares a:
Métrica | Valor orientativo |
|---|---|
Tiempo total promedio | ~6,6 min |
Mediana total | ~6,8 min |
P90 total | ~8,4 min |
Por nómina | ~0,39 s |
Los valores reales de tu tenant pueden diferir según volumen, infraestructura y legislación. Usa siempre el rango y las muestras de tu empresa.
Qué hacer si no ves datos
- Amplía el rango de fechas (sin superar 12 meses).
- Confirma que en ese período hubo procesamientos finalizados con cantidad mayor que cero.
- Para el escenario Lote ~1.000, verifica que existan transacciones bulk de período con cantidad cercana a mil; si tu operación no usa lotes de ese tamaño, ese bloque puede mostrar pocas o ninguna muestra.
Preguntas frecuentes
¿Por qué no veo la sección Métricas?
Solo está visible para usuarios con rol admin. Si necesitas acceso, solicítalo al administrador de tu cuenta Rankmi.
¿Puedo cambiar o reprocesar nóminas desde Métricas?
No. Es una vista de solo lectura para análisis; el procesamiento sigue haciéndose desde los flujos habituales de nómina y períodos.
¿Los datos incluyen transacciones en curso?
No. Solo entran transacciones finalizadas con cantidad mayor que cero.
¿Por qué el escenario Lote ~1.000 tiene pocas muestras?
Ese escenario filtra transacciones bulk de período con cantidad entre 990 y 1.030. Si tu operación no genera lotes de ese tamaño con frecuencia, las estimaciones serán limitadas; revisa el contador de muestras en pantalla.
¿Puedo consultar más de un año?
No. El rango máximo es de 12 meses para equilibrar utilidad y rendimiento de la consulta.
¿Aplica a mi país / legislación?
Sí, en todas las legislaciones donde opera Global Payroll, siempre dentro del aislamiento de datos de tu tenant.
¿Un usuario de solo lectura en nómina puede ver estas métricas?
No, salvo que tenga rol admin en la plataforma.
¿Las métricas reemplazan el monitoreo de TI?
No. Complementan la operación de nómina con visibilidad en producto; el monitoreo de infraestructura sigue siendo responsabilidad del equipo técnico.