> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Logs

> Ver logs de ejecucion de un worker

Muestra el historial de ejecuciones de un worker con su resultado, duracion y logs internos.

## Uso

```bash theme={null}
plazbot workers logs <nombre>
```

## Argumentos

| Argumento  | Descripcion        |
| ---------- | ------------------ |
| `<nombre>` | Nombre del worker. |

## Opciones

| Opcion              | Descripcion                                      |
| ------------------- | ------------------------------------------------ |
| `--limit <n>`       | Numero de registros a mostrar (por defecto: 20). |
| `--status <estado>` | Filtra por estado: `success`, `error`.           |
| `--dev`             | Muestra logs del entorno de desarrollo.          |

## Ejemplo

```bash theme={null}
# Ver ultimas 20 ejecuciones
plazbot workers logs consultar-inventario

# Ver solo errores
plazbot workers logs webhook-stripe --status error

# Ver ultimas 50 ejecuciones
plazbot workers logs reporte-nocturno --limit 50
```

## Campos del log

Cada entrada de log muestra:

| Campo     | Descripcion                                                              |
| --------- | ------------------------------------------------------------------------ |
| Status    | `success` o `error`.                                                     |
| Duration  | Tiempo de ejecucion en milisegundos.                                     |
| Trigger   | Fuente que disparo la ejecucion (cron, webhook, dashboard-test, action). |
| Timestamp | Fecha y hora de la ejecucion.                                            |
| Output    | Resultado retornado por el worker.                                       |
| Logs      | Entradas de `plz.log.info/warn/error` registradas durante la ejecucion.  |

## Logs internos (plz.log)

Si el worker usa `plz.log.info`, `plz.log.warn` o `plz.log.error`, esas entradas se muestran agrupadas por invocacion:

```
[2024-01-15 22:00:01] success (245ms) - cron
  INFO  Worker iniciado { contactId: "abc123" }
  INFO  Contacto identificado { name: "Juan" }
  WARN  Campo email vacio
  INFO  Notificacion enviada exitosamente

[2024-01-15 21:30:00] error (102ms) - dashboard-test
  INFO  Worker iniciado { contactId: "def456" }
  ERROR SLACK_WEBHOOK_URL no configurado en secrets
```