rai telemetry

Consulta datos de telemetría desde la base de datos SQLite local de RaiSE o desde raise-server. Dos subcomandos sirven propósitos distintos:

Subcomando	Fuente de datos	¿Requiere servidor?
query	~/.rai/raise.db local	No
tokens	API de raise-server	Sí

---

rai telemetry query

Consulta la tabla local de señales en SQLite. Lee ~/.rai/raise.db directamente — sin servidor, sin credenciales requeridas.

Flag	Corta	Descripción
--type	-t	Filtrar por tipo de señal (ej. work_lifecycle)
--source	-s	Filtrar por fuente (ej. claude_code)
--limit	-n	Máximo de filas a devolver. Por defecto: 20. Rango: 1–500
--since		Fecha/hora ISO 8601 — solo señales posteriores a este momento
--db		Ruta a un archivo raise.db específico (por defecto: BD del proyecto)

# Mostrar las últimas 20 señales
rai telemetry query

# Filtrar por tipo de señal
rai telemetry query --type work_lifecycle --limit 5

# Filtrar por fuente
rai telemetry query --source claude_code

# Mostrar señales desde una fecha específica
rai telemetry query --since 2026-05-04T00:00:00Z

# Consultar una base de datos diferente
rai telemetry query --db /path/to/other/raise.db

Salida:

                          Signals (showing 3)
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
┃ Timestamp          ┃ Type           ┃ Source      ┃ Session         ┃ Tokens ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━┩
│ 2026-05-06T16:16:… │ work_lifecycle │ claude_code │ S-E-260506-0828 │      — │
│ 2026-05-06T16:15:… │ work_lifecycle │ claude_code │ S-E-260506-0828 │      — │
│ 2026-05-06T16:14:… │ work_lifecycle │ claude_code │ S-E-260506-0828 │      — │
└────────────────────┴────────────────┴─────────────┴─────────────────┴────────┘

Tipos de señal comunes: work_lifecycle, session_start, session_end, pattern_add, session_bind

Fuentes comunes: claude_code, mcp, cli

Relación con rai signal: rai telemetry query es una vista de solo lectura de las mismas señales que escribe rai signal emit-*. Úsalo para auditar lo que se registró durante una sesión o ejecución de pipeline.

---

rai telemetry tokens

Lista eventos de uso de tokens desde raise-server. Muestra el costo de inferencia por fase y story en todo el equipo.

Requiere raise-server

Este subcomando llama a la API de raise-server. Debes definir dos variables de entorno:

export RAISE_SERVER_URL=https://your-raise-server.fly.dev
export RAISE_API_KEY=your-api-key

Sin estas variables, el comando termina con error. Los datos de tokens no están disponibles en la BD local.

Flag	Corta	Descripción
--story	-s	Filtrar por ID de story (ej. S3044.4)
--phase	-p	Filtrar por fase (ej. implement, design)
--since		Fecha/hora ISO 8601 — devuelve registros posteriores a este momento
--limit	-n	Máximo de registros a devolver. Por defecto: 20. Rango: 1–100
--offset		Desplazamiento para paginación. Por defecto: 0

# Mostrar los últimos 20 eventos de tokens
rai telemetry tokens

# Filtrar por story
rai telemetry tokens --story S3044.4

# Filtrar por fase
rai telemetry tokens --phase implement --limit 10

# Mostrar solo eventos recientes
rai telemetry tokens --since 2026-05-01T00:00:00Z

# Paginar resultados
rai telemetry tokens --limit 20 --offset 20

Ver también: Configuración de raise-server para configurar RAISE_SERVER_URL y RAISE_API_KEY.