Historial de ejecución de reglas

El registro de auditoría de Jira Automation anota cada ejecución de regla. ajat audit-log lo incorpora a un directorio de exportación, para que ajat report risk pueda ver cómo se comportan realmente tus reglas, y no solo cómo están configuradas:

• qué reglas limitó Jira (throttling) por superar un límite del servicio;
• qué reglas se ejecutan una y otra vez sin hacer nada;
• qué ejecuciones tocaron cientos de work items;
• qué reglas se ejecutan más, junto a su puntuación de riesgo.

Jira factura la automatización por pasos, y su página de consumo da el total sin decir por qué. El historial de ejecución es lo que convierte el informe de riesgo en una revisión de coste: una regla que se ejecuta miles de veces y casi nunca realiza una acción es el ahorro más barato del inventario. Disponible desde v1.0.8.

Dos formas de entrada

Ambas escriben el mismo fichero, y el informe de riesgo lo lee de la misma forma.

Usa import cuando quieras quedarte en las funciones soportadas de Jira, o para mirar unas pocas reglas. Usa fetch para cubrir todo el sitio sin exportar a mano.

Importar exportaciones CSV

Exportar el CSV desde Jira

1. Abre el registro de auditoría de Automation. Para todo el sitio, ve a Configuración › Sistema › Reglas de automatización y abre la pestaña Registro de auditoría; requiere derechos de administrador de Jira. Para un proyecto, ve a Configuración del proyecto › Automatización › Registro de auditoría. Para una regla, abre la regla y su registro de auditoría.
2. Ajusta los filtros, como el rango de fechas, a lo que quieras analizar.
3. Elige la exportación CSV en el menú …. El fichero contiene todas las entradas que coinciden con los filtros.

Importarlo

ajat export --output-dir ./jira-automations-backup
ajat audit-log import --input-dir ./jira-automations-backup ~/Downloads/automation-audit-logs-*.csv
ajat report risk --input-dir ./jira-automations-backup --output-file risk.html

• Varios ficheros se combinan. Una ejecución que aparece en dos ficheros se cuenta una sola vez, así que las exportaciones solapadas son seguras.
• Solo lo que contienen los ficheros. Las estadísticas cubren las reglas y los días de los ficheros. Las reglas que no están en ningún fichero no tienen estadísticas, y el informe indica que los datos proceden de una importación CSV.
• Los cambios de configuración no son ejecuciones. La exportación también lista las ediciones de una regla (CONFIG_CHANGE). Quedan fuera de todos los recuentos.
• Las fechas siguen la configuración regional del navegador. El comando distingue por sí mismo las fechas con el día primero de las que tienen el mes primero. Si todas las fechas de un fichero pueden leerse de las dos formas, pide --date-order.
• Las horas siguen la zona horaria de tu perfil de Jira. Pasa --timezone cuando no sea UTC. La zona horaria solo desplaza los bordes de la ventana unas horas; no cambia ningún hallazgo.
• Las reglas que faltan en la exportación se notifican. Si los ficheros nombran reglas que la exportación no contiene, el comando dice cuántas. Suele significar una exportación obsoleta o un --input-dir equivocado.

La importación usa únicamente la exportación de Jira, así que no es experimental.

Descargar desde Jira (experimental)

ajat audit-log fetch lee las ejecuciones recientes directamente del registro de auditoría, para todas las reglas del sitio.

ajat export --output-dir ./jira-automations-backup
ajat audit-log fetch --input-dir ./jira-automations-backup
ajat report risk --input-dir ./jira-automations-backup --output-file risk.html

Cuánto tarda una descarga

El registro llega de más reciente a más antiguo, 50 ejecuciones por petición, y cada petición es más lenta cuanto más atrás llega (alrededor de un tercio de segundo para las ejecuciones más recientes, varios segundos tres meses atrás). Por tanto, el coste lo fija la ventana, no toda la retención. El valor predeterminado de 15 días coincide con la comprobación de «ejecuciones sin acciones» descrita abajo; pasa --days 30 para una vista más larga.

Medido en un sitio real con unas 4.100 ejecuciones de regla al día:

Esa ejecución encontró 2 reglas limitadas, 96 reglas ejecutándose sin acciones y 8 reglas cuyas ejecuciones tocaron 100 o más work items; las cuatro reglas más activas se ejecutaron unas 4.300 veces cada una en 15 días, y el 99 % de esas ejecuciones no realizó ninguna acción.

Más workers descargan más rápido pero cargan más a Jira; 4 es un buen punto de partida. El progreso se muestra en stderr salvo que pases --no-progress.

El fichero de estadísticas

Ambos comandos escriben un único fichero, .ajat_audit_stats.json, en la raíz de la exportación. Contiene recuentos por regla, no el registro en bruto: ejecuciones, ejecuciones por resultado, ejecuciones que realizaron una acción, la última ejecución, la última ejecución que hizo algo y el mayor número de work items que tocó una sola ejecución. Vuelve a ejecutar cualquiera de los dos comandos para refrescarlo; sustituye el fichero, e import avisa cuando sustituyó estadísticas que ya existían. Como los demás ficheros ocultos de la exportación, ningún comando lo confunde nunca con una regla.

Qué hace el informe de riesgo con él

Una tabla Reglas más activas ordena las 20 reglas con más ejecuciones en la ventana, con cuántas de esas ejecuciones no hicieron nada, cuántas fueron limitadas, el mayor número de work items que tocó una ejecución y la puntuación de riesgo de la regla. Una regla muy activa cuyas ejecuciones casi nunca realizan una acción suele ser el ahorro más barato: un disparador más estrecho o una condición más temprana evita que se ejecute siquiera.

Sin el fichero de estadísticas, los dos hallazgos de ejecución muestran «ejecuta ajat audit-log import o fetch para habilitar esta comprobación» y la tabla no se muestra. La tabla lleva la marca CSV import o experimental según de dónde procedan las estadísticas.

Qué significan los números

• Ejecuciones, no pasos. Jira factura la automatización en pasos (cada disparador, condición, acción e iteración de rama que se ejecuta). ajat cuenta ejecuciones, no pasos. Sirven para ordenar reglas con fiabilidad; no son tu factura. La página de consumo de Jira en Configuración › Sistema › Automatización es la cifra facturada.
• «Realizó una acción» significa que el resultado de la ejecución fue Success o Some errors. No actions performed significa que una condición detuvo la ejecución.
• Una observación de la ventana. Una regla que no se ejecutó en la ventana no tiene estadísticas. Una descarga pagina sobre un registro vivo y puede perderse un puñado de ejecuciones que llegan mientras lee; una importación cuenta exactamente las filas de sus ficheros. Los recuentos sirven para ordenar y para umbrales, no para auditar una cifra exacta.
• La vista de tu cuenta. El registro muestra lo que puede ver la cuenta configurada, o la persona que exportó el CSV.

Resolución de problemas

• «not an automation audit-log export: missing column(s)» — el fichero no es un CSV del registro de auditoría, o se ha editado. Vuelve a exportarlo desde la página del registro de auditoría y pásalo sin cambios.
• «cannot tell whether dates are day first or month first» — todas las fechas del fichero pueden leerse de las dos formas, como 03/04/2026. Pasa --date-order dmy o --date-order mdy.
• «Jira’s internal audit-log endpoint did not answer as expected» — Atlassian ha cambiado el endpoint. Los informes siguen funcionando sin historial de ejecución; exporta el registro de auditoría como CSV y usa import en su lugar, y avisa a support@climakers.com.
• «The audit log ended before the start of the window» — el registro de tu sitio contiene menos de --days de historial (por ejemplo, un sitio nuevo); las estadísticas cubren el periodo más corto, y el informe dice cuántos días.
• Es lento. Reduce --days, o sube --workers un poco.

Relacionado

• Risk — el informe de riesgo y cada hallazgo.
• Medir el tamaño de las búsquedas — --probe-jql mide las búsquedas antes de que se ejecuten; el registro de auditoría muestra lo que las ejecuciones tocaron realmente.
• Revisión del coste de automatización — la receta que junta las dos cosas.
• Utilidades — doctor, tree, support y el resto de la superficie de diagnóstico.