Análise
Uso e cobrança
Revise o tempo de execução de workspaces por cliente, a atividade da IA gerenciada do Archibot, o uso de recursos da plataforma, a postura de reconciliação e a prontidão para cobrança nas abas de Análise, e defina limites de gastos.
Última atualização
A Análise é onde você revisa como uma conta de cliente está usando o Archibot: tempo de execução de workspaces, IA gerenciada do Archibot, recursos da plataforma como CI e Unidade compartilhada, a postura de reconciliação e a prontidão para cobrança. Ela fica em Análise na navegação do Console e é a mesma superfície que o suporte usa para o repasse de cobrança.
Este guia descreve a página como ela é renderizada hoje: uma janela fixa de 30 dias, uma barra de filtros compartilhada, cartões de métricas restritos por função, sete abas e uma aba Limites de gastos que grava limites mensais de volta no livro-razão de uso.
Quem pode ver o uso
O que você vê depende da sua função.
| Função | O que a Análise mostra |
|---|---|
| Membro de cliente | Sua própria postura de uso apenas para o seu locatário. Sem totais de todo o cliente, sem uso de usuários pares e sem valores de cobrança. |
| Administrador de cliente | Sua conta de cliente, incluindo estimativas faturáveis, detalhamento por membro, workspaces e Limites de gastos para o cliente selecionado. |
| Operador de plataforma / operador de cobrança | Revisão entre clientes com contexto de custo do provedor e margem bruta para integração, suporte e repasse de cobrança. |
Se sua conta ainda não tiver associação de locatário, a Análise informa isso e aguarda até que a integração crie um locatário antes de restringir o uso. O acesso à conta e o mapeamento de funções são abordados em Funções de acesso.
A janela e a barra de filtros
A Análise sempre reporta uma janela fixa de 30 dias. Não há seletor de período; o instantâneo são os últimos 30 dias, e o escopo ativo e a janela são resumidos no painel Instantâneo da janela à direita.
No topo da página, uma barra compartilhada controla todas as abas:
- A Busca filtra usuários, serviços, workspaces e linhas de uso.
- O filtro de serviço (o controle todos) restringe a um único serviço faturável, por exemplo tempo de execução de workspaces ou IA gerenciada.
- O seletor de cliente (apenas administradores e operadores) escolhe Todos os clientes visíveis ou uma conta de cliente. Os membros não veem este seletor porque já estão restritos a si mesmos.
- Atualizar recarrega o uso e os limites de gastos.
O cliente que você escolher nesta barra é o escopo das abas Membros, Workspaces e Limites de gastos. Confirme-o antes de ler ou alterar qualquer coisa.
Métricas principais
Abaixo da barra de filtros, os cartões de Métricas principais resumem a janela. Os cartões exibidos dependem da sua função:
| Cartão | Significado | Visível para |
|---|---|---|
| Conta atual | Estimativa faturável voltada ao cliente para a janela, detalhada por workspace, Archibot e recursos. | Administradores e operadores |
| Tempo de execução de workspaces | Horas de workspace observadas, do livro-razão Kubernetes de nível de cobrança quando disponível. | Todos |
| Custo do provedor | Custo reconciliado do lado do provedor e status do provedor. | Apenas operadores |
| Margem bruta | Margem bruta de custo conhecido em relação à meta. | Apenas operadores de cobrança |
| Archibot gerenciado | Totais de tokens da IA gerenciada do Archibot e contagens de sessões a partir dos metadados de sessão. | Todos |
| Recursos de plataforma | Contagem de eventos de CI, revisão, QA, ambiente persistente e Unidade compartilhada, com indicação de quaisquer eventos sem precificação. | Todos |
Você pode recolher este bloco com Ocultar métricas e reabri-lo com Mostrar métricas.
As sete abas
A Análise organiza os detalhes em abas. Duas delas (Membros e Limites de gastos) ficam ocultas para os membros.
| Aba | O que ela cobre |
|---|---|
| Visão geral | Gráfico de estimativa faturável ou de uso ao longo do tempo e o resumo da janela atual. |
| Tendências | Série diária para que você detecte picos antes de ler os itens de linha. |
| Custos (Uso para membros) | Detalhamento de custo ou uso por linha de cobrança, isenções de exatidão e showback de recursos. |
| Membros | Tempo de execução de workspaces, IA gerenciada e eventos de recursos agrupados por membro. Apenas administradores e operadores. |
| Workspaces | Gráfico de tempo de execução ao longo do tempo, consenso de tempo de execução e uma tabela por workspace. |
| Limites de gastos | Limites de serviço mensais que você pode editar e salvar. Apenas administradores e operadores. |
| Segurança de dados | O que é rastreado, onde, e o que é explicitamente excluído. |
A terceira aba é rotulada como Custos quando você pode ver valores faturáveis e Uso para membros que não podem.
Visão geral e Tendências
Visão geral abre por padrão. Mostra o gráfico de estimativa faturável ao longo do tempo (ou de uso ao longo do tempo para membros) e um resumo da janela atual descrevendo a contagem de dias, o escopo e a cobertura. Tendências divide os mesmos dados em uma série diária para que você possa ler o impulso e detectar um pico antes de abrir itens de linha individuais.
Custos
A aba Custos (mostrada acima) lista cada linha de cobrança com seu uso e, para administradores e operadores, uma estimativa faturável e o estado incluído ou acima da franquia. Use a busca da tabela para restringir linhas.
Dois avisos podem aparecer aqui:
- Um banner de estimativa de conta atual reafirma o total da janela. Esta é uma orientação de showback para a janela selecionada; as exportações de medidor do Stripe e os débitos de pré-pago permanecem controlados por jobs do backend.
- Para operadores de cobrança, um aviso de margem bruta compara a margem de custo conhecido com a meta.
Um cartão de Isenções de exatidão explica as regras de cálculo de custo que mantêm as estimativas honestas, por exemplo que chamadas de IA gerenciada que falham sem contadores de uso não são debitadas, e que a IA gerenciada é incluída nas estimativas faturáveis apenas quando a reconciliação está completa para o escopo visível.
Um cartão de Showback de recursos lista o uso somente de metadados para CI, revisão, QA, ambientes persistentes e Unidade compartilhada, com atribuição de ator e franquias de recursos. Se ainda houver linhas sem precificação, uma nota âmbar nomeia os tipos de recurso que precisam de precificação.
Membros
A aba Membros agrupa o tempo de execução de workspaces, a IA gerenciada e os eventos de recursos por membro para a janela e o cliente selecionados. Use-a para ver quais membros impulsionam a atividade. Ela fica oculta para contas com função de membro.
Workspaces
A aba Workspaces mostra um gráfico de tempo de execução ao longo do tempo e um painel Consenso de tempo de execução comparando as horas do livro-razão Kubernetes, a comparação do histórico de builds do Coder e a divergência entre eles. Abaixo disso, a tabela Detalhamento de workspaces lista cada workspace com seu proprietário, alvo, tempo de execução, estimativa faturável (para administradores e operadores) e a última hora observada.
O tempo de execução é mostrado a partir do livro-razão Kubernetes de nível de cobrança quando disponível e recorre ao histórico de builds do Coder caso contrário; a tabela rotula a fonte.
Limites de gastos
A aba Limites de gastos é uma superfície de gravação para administradores de cliente e operadores. Primeiro selecione uma única conta de cliente na barra de filtros; com Todos os clientes visíveis selecionado, a aba pede que você escolha uma conta.
Cada linha é um limite de serviço. Para cada linha você pode definir:
| Coluna | O que ela faz |
|---|---|
| Escopo | Se o limite é o padrão do cliente ou uma substituição por membro. |
| Serviço faturável | O serviço ao qual o limite se aplica, como tempo de execução de workspaces, IA gerenciada, CI ou Unidade compartilhada. |
| Uso atual | O gasto e a quantidade observados na janela. |
| Limite de gasto mensal | O limite mensal em dólares. Defina como 0 para deixar o limite em dólares desativado. |
| Limite de uso mensal | O limite mensal de quantidade para a unidade do serviço. Defina como 0 para deixá-lo desativado. |
| Ação do limite | Como o limite se comporta: Apenas alertar, Bloquear novo trabalho ou Desativado. |
| Estado | Se o limite está Ativo ou Pausado. |
| Estado dos dados | Um selo Dentro do limite ou Acima do limite, além de quaisquer selos de dados de custo ou atribuição ausentes. |
Para alterar um limite, edite seus campos e escolha Salvar naquela linha. Cada linha é salva de forma independente, e o botão salvar permanece desativado até você alterar algo. O Console armazena essas políticas ao lado do livro-razão de uso para que a cobrança e os gates de lançamento leiam uma única fonte.
Um cartão separado de Lacunas de dados lista os serviços que ainda precisam de atribuição ou precificação antes que um limite possa se tornar aplicação rígida. Se um serviço mostrar um selo de dados ausentes, defina a ação do limite como Apenas alertar até que os dados subjacentes estejam completos; Bloquear novo trabalho depende de atribuição precisa.
Segurança de dados
A aba Segurança de dados documenta o que a Análise rastreia e o que ela nunca toca.
- Onde rastreamos lista as camadas de armazenamento para estimativas, agregações e alocação de custo faturado, cada uma com um selo de postura.
- Explicitamente excluído confirma que prompts brutos, respostas de modelo, transcrições completas, chaves de provedor brutas e ativos de política privados ficam fora da análise e das exportações de suporte a faturas.
- Contrato de eventos mostra os campos mínimos de metadados mantidos para uma análise segura para o cliente.
- Uso de proxy ao vivo mostra o uso estimado do livro-razão do proxy do Archibot, que é intencionalmente separado da cobrança reconciliada do provedor.
Trate os dados de uso como evidência da conta. Eles nunca devem incluir prompts, respostas, transcrições, payloads brutos do provedor, chaves de API, cookies ou valores de segredos de workspace.
Postura de reconciliação
A reconciliação do provedor pode ficar atrás dos sistemas de cobrança do provedor em cerca de um dia, e as janelas da API Admin se estabilizam depois do fato. Os painéis Instantâneo da janela e de postura do provedor à direita mostram o estado atual de reconciliação.
Se um número recente parecer baixo ou ausente, verifique a postura de reconciliação antes de escalar. A IA gerenciada é incluída nas estimativas faturáveis apenas depois que a reconciliação está completa para o escopo de cliente visível, então uma janela não reconciliada pode aparecer baixa por design.
Por que os IDs de provedor ficam ocultos
A Análise restrita por cliente oculta intencionalmente os IDs de projeto do provedor e os metadados do provedor que carregam segredos. Isso é esperado. A página foi construída para fornecer status útil de uso e cobrança sem expor identificadores operacionais. Operadores que precisam do detalhe de projeto mapeado o veem apenas no escopo de operador.
Prontidão para cobrança e criação de workspace
A criação de workspace depende do estado de cobrança da conta. Acesso pago verificado ou uma avaliação aprovada podem permitir a criação quando outros gates de prontidão estão liberados. Contas pré-pagas também precisam de saldos financiados de tempo de workspace e de IA gerenciada antes que a criação prossiga. O financiamento do catálogo e os gates de prontidão são abordados em Catálogo e prontidão.
Quando você faz uma pergunta à cobrança
Para uma pergunta formal de cobrança, inclua a conta de cliente, a janela de 30 dias, os totais visíveis e a postura de reconciliação. Não inclua segredos de pagamento, payloads de fatura, segredos de conta do provedor ou detalhes de webhook. O guia Repasse ao suporte descreve o que reunir, e Solução de problemas cobre o uso que parece errado antes de chegar ao suporte.
Guias relacionados
- Catálogo e prontidão — o financiamento e os gates que permitem a criação de workspace.
- Funções de acesso — quais funções veem os totais de todo o cliente e a superfície de gravação dos Limites de gastos.
- Tenant Admin para operadores — gerenciamento de conta e locatário restrito a operadores.
- Repasse ao suporte — o que coletar antes de abrir uma pergunta de cobrança.
- Solução de problemas — diagnóstico de uso ou prontidão que parece errado.
Concluído quando
- A Análise abre com uso restrito por função.
- O escopo de cliente selecionado está correto.
- A janela de 30 dias e a postura de reconciliação são compreendidas antes de citar um número.
- O estado de cobrança corresponde ao acesso de avaliação, pré-pago ou pago aprovado.
- As alterações nos limites de gastos são salvas por linha e refletem o modo de aplicação pretendido.