Configurações - Telemetria
Telemetria mostra uso, engajamento, custos, usuários e indicadores de eficiência do AI Cockpit One para a organização ativa. Os dados mudam conforme filtros de período, time e agrupamento disponíveis em cada aba.
Quando usar
- Use Telemetria para entender adoção e atividade na organização.
- Use para revisar indicadores de custo e faturamento.
- Use para inspecionar engajamento por usuário.
- Use para gerar relatórios PDF ou HTML para compartilhar, revisar ou arquivar.
Antes de começar
- Confirme a organização ativa.
- Esta seção aparece apenas para usuários com acesso administrativo.
- Escolha o período correto antes de comparar números.
- Relatórios grandes podem demorar mais para gerar.
Navegação de telemetria
| Aba | O que mostra |
|---|---|
| Visão Geral | KPIs consolidados, usuários ativos, taxa de ativação, uso por módulo e linha do tempo. |
| Análises | Tendências de atividade, comandos, tokens, tempo de sessão, erros, auditoria e métricas upstream. |
| Usuários | Detalhamento por usuário, status, comandos, tempo médio de sessão e atividade. |
| Faturamento | Custos, modelos, tokens, usuários por custo e detalhamento por modelo ou usuário. |
| Relatório | Gera arquivos PDF ou HTML com seções selecionadas. |
Passo a passo: usar filtros de telemetria
- Abra Configurações > Telemetria.
- Escolha a aba que deseja revisar.
- Selecione o período.
- Selecione time ou agrupamento quando disponível.
- Aplique os filtros ou aguarde a atualização automática, conforme a tela.
- Revise gráficos, tabelas e estados vazios.
O que revisar em cada aba
| Área | O que conferir |
|---|---|
| Visão Geral | Total de usuários, usuários ativos, taxa de ativação, módulos ativos, uso por módulo e linha do tempo de atividade. |
| Análises | Atividade operacional, tarefas concluídas, usuários ativos, código gerado ou modificado, comandos, tokens, tempo de sessão, erros, eventos de auditoria, logins, dias ativos e eficiência upstream. |
| Usuários | Busca por nome, e-mail ou empresa; filtro por empresa; somente inativos; status de usuário; tabela de usuários; modal de detalhes com engajamento e auditoria. |
| Faturamento | Custo total, custo médio mensal, total de rastreios, modelos ativos, distribuição de custos por modelo, top usuários por custo, tokens por modelo, abas Por Modelo e Por Usuário e exportação CSV quando disponível. |
Passo a passo: gerar relatório de telemetria
- Abra Configurações > Telemetria > Relatório.
- Selecione período inicial e final.
- Se incluir Faturamento, escolha o mês principal de billing.
- Escolha formato PDF ou HTML.
- Selecione os módulos do relatório.
- Dentro de cada módulo, selecione os itens que deseja incluir.
- Revise avisos de processamento quando houver muitos dados.
- Clique em Gerar Relatório.
- Revise a prévia.
- Exporte ou baixe o arquivo final.
Entenda as opções do relatório
| Item | O que significa |
|---|---|
| Período | Intervalo de datas usado para buscar os dados do relatório. |
| Mês de billing | Mês principal usado para blocos de faturamento. |
| Documento paginado para compartilhar ou imprimir. | |
| HTML | Relatório interativo aberto no navegador. |
| Módulos | Grandes seções do relatório, como Visão Geral, Análises, Usuários e Faturamento. |
| Itens do relatório | Gráficos, KPIs e tabelas dentro de cada módulo. |
| Fidelidade dos filtros | Indica se um bloco respeita exatamente os filtros ou usa a aproximação disponível. |
| Snapshot de usuários | Indica se a lista de usuários foi carregada completa, parcial ou indisponível. |
Resultado esperado
A Telemetria deve mostrar dados para os filtros selecionados. Ao gerar relatório, você deve conseguir visualizar a prévia e baixar o arquivo PDF ou HTML selecionado.
Dicas e problemas comuns
- Se um gráfico estiver vazio, revise período, time, agrupamento e organização ativa.
- Se o botão de relatório estiver desabilitado, confirme período e seções selecionadas.
- Se Faturamento estiver selecionado, confirme o mês de billing.
- Se algum bloco do relatório falhar, recarregue o bloco ou tente novamente as chamadas com erro.
- Períodos grandes podem demorar mais para processar.