osFoundry / Platform
Hot replay e histórico
Cada canal mantém os últimos N dias de eventos. Reset de cursor, replay a partir de qualquer seq id.
O que é
Hot replay e histórico é o log de eventos por canal do osFoundry. Cada canal, ou seja, os fluxos por trás dos seus chats, agentes e ferramentas, retém os eventos dos últimos N dias, e cada evento carrega um id de sequência monótono (seq id). Os consumidores leem para frente acompanhando um cursor que aponta para o último seq id que processaram. Como a janela recente é mantida «quente», você não precisa tratar um canal como um fluxo do tipo dispara e esquece: o histórico está ali para ser lido novamente.
A operação central é simples. Mova um cursor de volta para qualquer seq id e reproduza a partir daquele ponto. Um agente que travou no meio de uma execução, um consumidor novo que acabou de entrar num canal ou uma ferramenta que processou eventos de forma incorreta podem reler exatamente a mesma sequência, em vez de perder a lacuna ou adivinhar o que aconteceu. Como o osFoundry é um espaço de trabalho desktop com a sua própria chave (BYOK), esse histórico vive com o seu espaço de trabalho, e não nos servidores de um fornecedor: a janela de eventos é local-first, de modo que reproduzir eventos antigos não significa enviar seus dados de volta para terceiros. Você reinicia o cursor, reproduz, e o consumidor vê os mesmos eventos ordenados que teria visto ao vivo.
Por que isso importa: fluxos de agentes e multicanal têm estado, e esse estado só é tão confiável quanto a sua capacidade de reconstruí-lo. Uma janela retida e endereçável por seq id transforma a pergunta «o que este canal realmente viu?» de um palpite em uma releitura determinística. Ela torna a depuração reproduzível (reproduza a sequência exata que causou um bug), torna a recuperação barata (retome do último cursor válido em vez de do zero) e torna a integração de um novo consumidor segura (preencha a partir de um seq id escolhido). A janela é limitada por design aos últimos N dias, de modo que o histórico permanece útil e atual sem crescer indefinidamente.
Principais recursos
- Cada canal retém os eventos dos últimos N dias, cada um carimbado com um id de sequência monótono (seq id)
- Reinicie o cursor de um consumidor para qualquer seq id e reproduza a sequência exata e ordenada de eventos a partir daquele ponto
- Recupere agentes que travaram ou execuções interrompidas retomando do último cursor processado, em vez de começar de novo
- Reproduza bugs de forma determinística repetindo a sequência precisa de eventos que os disparou, ou preencha um consumidor recém-adicionado a partir de um seq id escolhido
- Uma retenção limitada e local-first mantém o histórico recente «quente» no seu dispositivo, sem crescimento ilimitado nem idas e vindas ao fornecedor
Casos de uso
- Desenvolvedor de agentes: um agente trava no meio da execução, então você rebobina o cursor dele para o último seq id confirmado e reproduz o canal para retomar exatamente de onde parou
- Depurador de fluxos: uma ferramenta posterior produziu um resultado errado, então você reproduz o mesmo intervalo de eventos para reproduzir e confirmar a correção de forma determinística
- Construtor de integrações: você adiciona um consumidor novo a um canal movimentado e o preenche a partir de um seq id escolhido para que ele se atualize com os últimos N dias antes de entrar em produção
Perguntas frequentes
Até quando consigo reproduzir os eventos de um canal?
Cada canal mantém uma janela deslizante com os eventos dos últimos N dias. Tudo o que estiver dentro dessa janela é endereçável pelo id de sequência e pode ser reproduzido; eventos mais antigos que o período de retenção vão expirando, por isso o hot replay foi pensado para o histórico recente e a recuperação, não para arquivamento permanente.
O que reiniciar um cursor faz de fato?
Um cursor marca o último seq id que um consumidor processou. Reiniciá-lo para um seq id anterior diz a esse consumidor para reler o canal daquele ponto em diante, recebendo novamente os mesmos eventos ordenados. Isso não apaga nem reescreve os eventos: apenas muda de onde a leitura recomeça.
Reproduzir o histórico do meu canal envia dados aos servidores do osFoundry?
Não. O osFoundry é um espaço de trabalho desktop local-first com a sua própria chave (BYOK), e a janela de eventos é retida com o seu espaço de trabalho. Reproduzir relê eventos que já estão guardados localmente, então recuperar ou reprocessar o histórico não exige enviar os dados do seu canal para um serviço de terceiros.