Comando probe
Tabla de Contenidos
Introducción
El comando probe gestiona las ejecuciones de probes. Los comandos de observación como watch, trace, monitor y top registran probes dentro del target cuando se ejecutan, y probe es el punto de control unificado para esas probes: listar registros, inspeccionar eventos recientes, detener probes en ejecución y limpiar las antiguas.
Con list, status, inspect, stop y cleanup se pueden filtrar las probes por target, tipo (watch, trace, etc.) o estado, lo cual es útil para recuperar observaciones que se hayan olvidado y que de otro modo seguirían generando carga en el target.
Sintaxis
peeka-cli probe <subcommand> [options]
Subcomandos
| Subcomando | Descripción |
|---|---|
list |
Lista ejecuciones de probe |
status --probe <id> |
Muestra el estado del probe |
inspect --probe <id> |
Muestra detalles y eventos recientes |
stop --probe <id> |
Detiene un probe en ejecución |
cleanup |
Limpia probes antiguos |
Opciones comunes:
| Opción | Descripción |
|---|---|
--target <id> |
Filtra o ubica el target propietario |
--type <type> |
Filtra list por tipo de probe, como watch o trace |
--status <status> |
Filtra list por estado |
--events <n> |
Número de eventos recientes devueltos por inspect, predeterminado 100 |
--all |
En cleanup, también limpia probes created/paused; nunca probes active |
--older-than <duration> |
En cleanup, limpia probes más antiguos que la duración; predeterminado 10m |
--format table/json |
Formato de salida, predeterminado table |
Ejemplos
peeka-cli probe list --target target_abcd1234
peeka-cli probe list --type watch --status active
peeka-cli probe inspect --probe probe_123 --events 20 --format json
peeka-cli probe stop --probe probe_123
peeka-cli probe cleanup --older-than 1h
Historial de Versiones
| Versión | Fecha de lanzamiento | Cambios |
|---|---|---|
| 0.1.16 | 2026-06-07 | Añadido el grupo de comandos probe |