Skip to main content
jelou metrics lê o mesmo catálogo de analytics que os dashboards do Studio leem — oito categorias: inbox, ecommerce, payments, voice, biometrics, brain, ai, general. O catálogo é próprio de cada empresa e é servido em tempo real, então descubra antes de buscar — nunca fixe uma key de memória.
list combina três origens de catálogo. Se uma falhar, o comando ainda sai com código 0 com as métricas que conseguiu ler, e nomeia as demais em errors[] — confira failed antes de concluir que uma key não existe. As sete keys legadas de antes da v2 (dau_total, dau_ai_total, unique_users_total, unique_users_per_day, brain_sessions, bic_billing_sessions, hsm_by_sent_status) continuam funcionando e retornam o envelope de sempre — aparecem marcadas com legacy: true no --json.

​
Buscar uma métrica

As keys não diferenciam maiúsculas/minúsculas, e o final do invocation_name funciona quando não é ambíguo. Em terminal interativo renderiza como cartão ou gráfico; no modo --json/--agent (ou com stdout redirecionado) emite o envelope JSON.

​
Janelas de tempo

Precedência: --start+--end vence --last, que vence --period.

​
Filtros

Cada métrica declara quais filtros aceita — passar um que ela não declara sai com código 2 e informa quais ela aceita. Confira filters em jelou metrics list --json antes de chamar uma métrica nova.

​
Um painel completo

As métricas de um painel são buscadas em paralelo — uma que falhar não derruba o painel inteiro: a resposta --json traz failed e errors[], e o resto renderiza normalmente. Sem nome nem --template, dashboard mostra o painel principal da empresa; o envelope desse comando lista em workspaces os nomes de painéis salvos que encontrou.

​
Exit codes

Os números que este comando retorna têm ressalvas reais — não os trate como verdade contábil:
  • Os agregados de ecommerce vêm de tabelas de rollup atualizadas a cada ~10 min (só hoje/ontem mais os dias recentemente tocados); os dados de detail são em tempo real e podem não coincidir com os resumos.
  • total_sales exclui modificadores de produto — é uma estimativa de GMV, não receita contábil. AOV herda essa limitação.
  • cart_conversion é uma coorte por data de criação sem TTL de abandono — janelas recentes ficam subestimadas; breakdown.abandoned costuma ser 0.
  • sales_by_category conta em dobro (relação M:N) — não vai somar igual a total_sales.
  • A família de métricas de catálogo ignora from/to completamente (é uma foto global).
  • ai_usage_cost nas métricas de busca é custo interno da Jelou.
  • Os totais dos termos de busca mais buscados excluem consultas de navegação/sentinel, mas total_searches as inclui — as listas não vão somar igual.
  • É necessário o scope analytics:read (mais ecommerce:access para shop). Não valide isso antes — deixe o 401/403 da API chegar como está.
Se o seu agente já vai buscar o resto do contexto do workspace, jelou context --agent não inclui métricas — este comando continua sendo a única porta de entrada para a analítica da empresa.