Registro de comandos
Cada ação de uma máquina CLI deixa um rastro no seu registro: ativação, lista de hosts, execução, snippet, ferramenta MCP, confirmação, rotação, desconexão, revogação. Ele pode ser consultado em Configurações › Máquinas CLI, abrindo a máquina, e em https://app.konsolity.com/cli-machines.
Início e fim
Para uma execução, a CLI grava uma linha antes de executar o comando e uma segunda no final, com o código de retorno e a duração. Se a gravação do início falhar (rede caída, servidor inacessível), o comando não é executado: nada roda sem deixar rastro.
O próprio servidor grava os eventos que dizem respeito a ele: ativação, rotação do token, revogação, confirmações, recusas de escopo.
Conteúdo de uma linha
- Quando: a data e a hora;
- Qual ferramenta:
hosts,run,snippet,sessions,mcp:<tool>,serve:<tool>,login,rotate,logout; - Qual host: o rótulo dele;
- Qual comando: o texto dele, limitado a 4.000 caracteres;
- Decisão: permitido (com a regra que o permitiu), negado, confirmado ou recusado na confirmação;
- Código de retorno e duração da execução;
- a sessão CLI e, quando for o caso, a solicitação de confirmação.
O que o registro não contém
Nunca a saída do comando. Nunca uma senha, uma chave, um token ou uma chave de máquina.
Retenção
As linhas são criptografadas em repouso e mantidas por 90 dias, depois excluídas. Revogar uma máquina não exclui o registro dela: ele continua disponível até o fim dos 90 dias.
Filtros
Filtre por máquina (na página de máquinas), por período (de, até) e por decisão (permitida, recusada, confirmada, não confirmada): as linhas mais recentes aparecem primeiro e “Linhas mais antigas” carrega o restante. A exportação usa os mesmos filtros.
Exportação
Exportar gera um arquivo CSV (planilha, cabeçalhos em inglês) ou JSON (ferramentas, arquivamento) para o período escolhido. Guarde uma exportação mensal se precisar manter um rastro além de 90 dias.
Boas práticas
- Revise o registro depois de ampliar um escopo: as recusas mostram o que foi tentado.
- Uma recusa repetida de um comando legítimo indica uma regra a adicionar; uma recusa inesperada, uma solicitação a examinar.
- Uma linha de início sem linha de fim indica um comando interrompido (revogação, encerramento de sessão, queda).