Logs de un worker

Muestra las últimas ejecuciones de un worker (las más recientes primero) con su estado, duración, origen y error. Con --follow se queda escuchando y muestra las ejecuciones nuevas a medida que ocurren.

bash

01plazbot workers logs <nombre> [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Nombre	`<nombre>`	Sí	Nombre del worker.
Límite	`-l, --limit <number>`	No	Cantidad de ejecuciones a mostrar, de 1 a 1000. Por defecto `20`.
Estado	`-s, --status <status>`	No	Filtra por estado: `success`, `error`, `timeout`.
Seguir	`-f, --follow`	No	Consulta cada 3 segundos e imprime las ejecuciones nuevas. Se detiene con Ctrl+C (código de salida 0).
JSON	`--json`	No	Imprime los logs como JSON, con el mensaje de error completo.

Ejemplos

bash

01# Últimas 20 ejecuciones
02plazbot workers logs get-stock
03 
04# Últimas 100 ejecuciones con error
05plazbot workers logs get-stock -l 100 -s error
06 
07# Seguir las ejecuciones en tiempo real
08plazbot workers logs get-stock --follow
09 
10# Logs en JSON con los errores completos
11plazbot workers logs get-stock --json

Resultado

text

01  Logs for "get-stock" (3)
02  ────────────────────────────────────────
03┌───────────────────────┬─────────┬──────────┬──────────────┬──────────────────────────────────────────┐
04│ Date                  │ Status  │ Duration │ Source       │ Error                                    │
05├───────────────────────┼─────────┼──────────┼──────────────┼──────────────────────────────────────────┤
06│ Oct 6, 2026, 03:12 PM │ ok      │ 245ms    │ tool_calling │ —                                        │
07├───────────────────────┼─────────┼──────────┼──────────────┼──────────────────────────────────────────┤
08│ Oct 6, 2026, 03:10 PM │ error   │ 102ms    │ cli-test     │ INVENTORY_API_KEY is not configured i... │
09├───────────────────────┼─────────┼──────────┼──────────────┼──────────────────────────────────────────┤
10│ Oct 6, 2026, 08:00 AM │ timeout │ 10000ms  │ scheduler    │ —                                        │
11└───────────────────────┴─────────┴──────────┴──────────────┴──────────────────────────────────────────┘
12 
13  Successful: 1
14  Errors: 1
15  Timeouts: 1
16  Average duration: 3449ms
17  Errors are truncated; use --json to see the full message.

Status muestra ok (éxito), error o timeout.
Source es el origen de la ejecución: tool_calling (agente IA), action (acción de una automatización o agente), scheduler (cron), webhook o cli-test (plazbot workers test).
La tabla corta los errores a 40 caracteres; usa --json para ver el mensaje completo.

Con --follow, primero se imprimen las ejecuciones actuales y luego cada nueva en una línea:

text

01  Following logs for "get-stock"
02  ────────────────────────────────────────
03  Press Ctrl+C to stop.
04 
05  Oct 6, 2026, 03:10 PM  error  102ms  cli-test  INVENTORY_API_KEY is not configured in secrets
06  Oct 6, 2026, 03:12 PM  ok  245ms  tool_calling

Si una consulta falla por red, muestra Could not fetch logs (...). Retrying... y sigue intentando; con errores de autenticación o si el worker no existe, se detiene con código 1.

Salida JSON

json

01[
02  {
03    "id": "...",
04    "workerName": "get-stock",
05    "workerType": "tool",
06    "status": "error",
07    "durationMs": 102,
08    "triggerSource": "cli-test",
09    "error": "INVENTORY_API_KEY is not configured in secrets",
10    "createdAt": "2026-10-06T20:10:00Z"
11  }
12]

Con --follow --json, cada ejecución se imprime como un objeto JSON por línea (NDJSON).

Errores comunes

Mensaje	Causa	Solución
`--limit must be a whole number between 1 and 1000.`	Valor de `-l` fuera de rango o no entero.	Usa un entero entre 1 y 1000: `-l 100`.
`No logs found for "<nombre>"`	El worker no tiene ejecuciones o el nombre no existe.	Revisa el nombre con `plazbot workers list`.
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.