# Log de ejecuciones

[← Índice](readme.md)

Accede desde el botón **Log** en la tarjeta del tipo de trabajo. Muestra el historial completo de ejecuciones de ese tipo, ordenadas de más reciente a más antigua.

---

## Filtros disponibles

- **Estado** — filtra por el estado actual del trabajo: en proceso, completado, con errores, pendiente
- **Tipo de trabajo** — disponible en la vista global de log para filtrar entre varios tipos

---

## Información de cada ejecución

### Encabezado

- **Estado** — estado actual del trabajo
- **Identificador** — código interno de la ejecución (`#xxxxxxxx`)
- **Disparado por** — quién o qué inició el trabajo: nombre de usuario, nombre del cron, identificador del sistema externo
- **Fecha de inicio** y **fecha de fin** cuando aplica

### Barra de progreso

Muestra el avance del trabajo. En trabajos en proceso la barra está animada. El color indica el resultado:

| Color | Significado |
|---|---|
| Azul animado | En proceso |
| Verde | Completado sin errores |
| Rojo | Completado con errores |
| Gris | Pendiente, aún no iniciado |

### Estadísticas

| Indicador | Qué muestra |
|---|---|
| Total | Número de elementos en la lista original |
| OK | Elementos procesados exitosamente |
| Errores | Elementos que fallaron tras agotar los reintentos |
| Avance | Porcentaje de elementos procesados sobre el total |

### Lotes

Cuando el trabajo se dividió en más de un lote, se muestra el estado de cada uno con el formato `L1 · procesados/total`. Útil para identificar en cuál lote ocurrieron los errores.

---

## Estados posibles de un trabajo

| Estado | Descripción |
|---|---|
| **Pendiente** | Encolado, aún no ha comenzado |
| **En proceso** | El sistema está procesando elementos |
| **Completado** | Todos los elementos fueron procesados sin errores |
| **Con errores** | El trabajo terminó pero uno o más elementos fallaron |
| **Cancelado** | El trabajo fue detenido manualmente antes de completarse |

Un trabajo **con errores** no es necesariamente un fallo total — puede que 140 de 142 elementos se procesaron correctamente y solo 2 fallaron. Revisa el detalle de lotes para identificar qué ocurrió.

---

## Retención de datos

Los registros de ejecución se conservan durante el periodo de retención configurado en la plataforma (por defecto 7 días desde que el trabajo termina). Pasado ese plazo el sistema elimina automáticamente las tablas de datos — el registro del trabajo en el log puede mantenerse según la configuración del administrador de la plataforma.

---

[← Lanzar un trabajo](06-lanzar.md) · [Conceptos de referencia →](08-referencia.md)