Skip to main content
jelou metrics lee el mismo catálogo de analítica que ven los dashboards de Studio — ocho categorías: inbox, ecommerce, payments, voice, biometrics, brain, ai, general. El catálogo es propio de cada empresa y se sirve en vivo, así que descubre antes de pedir — nunca asumas una key de memoria.
list combina tres orígenes de catálogo. Si uno falla, el comando de todas formas sale con código 0 con las métricas que sí pudo leer y nombra las demás en errors[] — revisa failed antes de asumir que una key no existe. Las siete keys heredadas de antes de v2 (dau_total, dau_ai_total, unique_users_total, unique_users_per_day, brain_sessions, bic_billing_sessions, hsm_by_sent_status) siguen resolviendo y devuelven su envelope de siempre — aparecen marcadas con legacy: true en --json.

​
Traer una métrica

Las keys no distinguen mayúsculas/minúsculas, y el final del invocation_name funciona cuando no es ambiguo. En terminal interactiva se renderiza como tarjeta o gráfico; en modo --json/--agent (o con stdout redirigido) emite el envelope JSON.

​
Ventanas de tiempo

Precedencia: --start+--end gana sobre --last, que gana sobre --period.

​
Filtros

Cada métrica declara qué filtros acepta — pasar uno que no declara sale con código 2 y te dice cuáles sí acepta. Revisa filters en jelou metrics list --json antes de llamar una métrica nueva.

​
Un tablero completo

Las métricas de un tablero se piden en paralelo — una que falle no tumba el tablero completo: la respuesta --json trae failed y errors[], y el resto se renderiza igual. Sin nombre ni --template, dashboard muestra el tablero principal de la empresa; el envelope de ese comando lista en workspaces los nombres de tableros guardados que encontró.

​
Códigos de salida

Los números que devuelve este comando tienen matices reales, no son verdad contable:
  • Los agregados de ecommerce vienen de tablas de rollup refrescadas cada ~10 min (solo hoy/ayer + días recientemente tocados); el detalle (detail) es en vivo y puede no coincidir con los resúmenes.
  • total_sales excluye modificadores de producto — es una estimación de GMV, no ingreso contable. AOV hereda esta limitación.
  • cart_conversion es una cohorte por fecha de creación sin TTL de abandono — las ventanas recientes se subestiman; breakdown.abandoned suele ser 0.
  • sales_by_category cuenta doble (relación M:N) — no va a sumar igual a total_sales.
  • La familia de métricas de catálogo ignora from/to por completo (es una foto global).
  • ai_usage_cost en las métricas de búsqueda es costo interno de Jelou.
  • Los totales de términos de búsqueda excluyen consultas de navegación/sentinel, pero total_searches sí las incluye — las listas no van a sumar igual.
  • Se necesita el scope analytics:read (+ ecommerce:access para shop). No lo valides de antemano — deja que el 401/403 de la API llegue tal cual.
Si tu agente ya va a pedir el resto del contexto del workspace, jelou context --agent no incluye métricas — este comando sigue siendo la única puerta de entrada a la analítica de la empresa.