Lendo o painel de cota

O destino Report e os comandos por trás dele. O que cada palavra da linha de assinatura significa, nos termos que o source define, e o que muda entre o painel, o relatório e o autodev quota.

Onde fica #

O destino Report do painel a guarda. autodev report imprime o mesmo modelo num terminal, para as últimas 12 horas a menos que --hours diga outra coisa, e --json o imprime como JSON. autodev quota imprime só a metade de cota, para os últimos 7 dias a menos que --days diga outra coisa. Todos os comandos da CLI descreve os dois.

O relatório cobre este projeto. autodev quota cobre todos os projetos da máquina, porque uma assinatura é compartilhada por todos eles.

O que o relatório traz #

O relatório se lê, de cima para baixo:

• Status. Uma grade com status, daemon, iteration e est. cost. Acima dela, uma linha dá o motivo do estado: alive para uma execução viva e, para uma parada, o último evento que encerrou algo. O est. cost é uma estimativa que a execução mantém: cobrança real para quem usa API, estimativa para quem usa um plano.
• Needs you. O que espera por uma pessoa, os mesmos itens da barra de status. A execução parou e por quê trata deles.
• Activity. Só quando nada rodou na janela, ela diz isso. Uma noite vazia é um resultado, não uma página em branco.
• Done e Blocked. As tarefas e os commits na janela, com os títulos mais recentes, e contagens dos erros que foram repetidos. No painel, a contagem de erros é um botão que abre Needs you.
• Subscription. A barra e as três cifras abaixo dela.
• Quota. Uma linha por provedor, e depois um gráfico.
• Duas linhas sobre failover, quando se aplicam.
• Other workspaces. Os outros projetos da máquina.

A linha de assinatura #

A linha tem quatro palavras: subscribed, used, idle e converted. O source define cada uma, e nenhuma delas mede tokens nem a franquia de um plano:

No painel, o rótulo da janela fica acima de uma barra, com o tempo subscribed à direita. A barra tem duas larguras, used e idle, e a parte idle é hachurada, porque representa uma ausência. converted, used e idle são as três cifras sob a barra. autodev report imprime as quatro palavras numa linha.

Então idle diz por quanto tempo a assinatura ficou sem nenhum agente rodando. Não diz quanto de uma franquia ficou sem uso. O que é medido diz de onde cada palavra é derivada.

Por provedor #

Cada provedor tem uma linha. Ela abre com o nome do provedor e um veredito: limit crossed quando o provedor informou um limite de uso na janela, no limit hit quando não. Abaixo ficam quatro cifras. commits são os commits registrados para aquele provedor. turns são as chamadas dele. held é o tempo de agente dele, que é a soma das durações das chamadas, então duas chamadas que rodaram ao mesmo tempo se somam. limits crossed são os limites de uso que ele informou.

Os provedores nunca são fundidos numa só linha, porque um limite pertence a uma assinatura.

O gráfico #

O gráfico tem uma barra para cada dia local que teve uma chamada, um commit ou um limite. A altura da barra é a fração do tempo daquele dia em que qualquer coisa rodou. O divisor é a duração própria do dia, então um primeiro ou último dia que a janela corta, e um dia mais longo ou mais curto por mudança de horário, não são desenhados errado. Um dia que cruzou um limite ganha a cor de aviso. Passar o mouse numa barra mostra o dia, o tempo ocupado, os commits e os limites.

Um dia sem nada não é desenhado, e a linha de assinatura ainda o conta como ocioso.

Failover e outros workspaces #

Duas linhas podem seguir o gráfico. <n> failover(s) kept the run moving conta as vezes em que um participante avançou pela sua lista failover. Um colega que assume um turno limitado não entra nessa conta. <n> time(s) every provider was limited at once conta as vezes em que o time inteiro esteve limitado ao mesmo tempo e a execução esperou o primeiro retorno.

Em Other workspaces, cada outro projeto tem uma marca de se a execução dele está viva, o nome, o status e os commits dele na janela. Um status que afirma uma execução ativa enquanto nenhum daemon está vivo aparece como (stale). Projetos sem atividade são contados, não listados.

Num terminal #

autodev quota imprime três partes, e uma quarta quando algo está errado:

• Providers, com as chamadas, o tempo de agente, os commits e os limites de cada um. Um provedor que declara reportar cota e não enviou nada mostra no quota reported (expected) como aviso. Cada linha traz também o número de inferências, as chamadas ao modelo que um turno fez, ou inferences unknown quando a CLI não diz, e o maior contexto em que qualquer chamada do período rodou, como peak context.
• Totals: o tempo de agente, e a fração da janela que esteve ocupada e ociosa.
• Windows, por provedor e por tipo de janela, nunca combinados. Cada uma mostra a maior utilização que o provedor informou, o que isso deixa, os commits dentro da janela, e exhausted quando um limite foi registrado dentro dela. Aqui idle é a parte da franquia da janela que o pico não alcançou, o que faz dela o único lugar em que a palavra fala da franquia e não do tempo. Só uma janela de cinco horas foi capturada até hoje, e só o claude envia as cifras.
• Integrity, quando linhas do ledger não podem ser lidas, um registro tem um timestamp que não é uma data, um snapshot não tem hora de reposição, ou uma chamada leva uma janela de contexto que o provedor dela não declara. Um arquivo danificado não parece um mês tranquilo.

--series imprime o mesmo ledger por dia local e por provedor.

Onde o ledger fica descreve o arquivo que o painel lê.