Allan Simões AdegasEnglish
Menu
Voltar para o início

Event Lab

Pronto para deploy

Pipeline de eventos sintéticos com Redis Streams, reprocessamento, métricas Prometheus e consultas via MCP.

Papel
Projeto pessoal
Início
2026
Event Lab
Ilustração do projeto
Redis Streams
fila persistente com consumer group
MCP
consultas somente leitura via stdio

Visão geral

Um pipeline pequeno para observar o que acontece quando chegam entregas repetidas, um worker cai ou um evento esgota as tentativas. O projeto nasceu a partir das perguntas do case de monitoramento de transações.

O worker processa cenários sintéticos. As consultas ao histórico e às métricas ficam em uma interface de leitura, consumida pelo servidor MCP.

O que ele faz

Recuperação de entregas pendentes
Um worker pode retomar uma entrega que ficou pendente depois que outro parou.
DLQ e reprocessamento
O pipeline limita as tentativas e guarda eventos que esgotaram o limite. O operador pode pedir um novo processamento pela CLI.
Métricas do processamento
O Prometheus coleta contadores e estados do pipeline para acompanhar filas, tentativas e resultados.

Arquitetura

Arquitetura: Event LabCLI → Redis Streams. Redis Streams → Worker. Worker → DLQ. Redis Streams → API de leitura. API de leitura → Prometheus. API de leitura → MCPCLIRedis StreamsWorkerDLQAPI de leituraPrometheusMCP
O worker consome Redis Streams. O serviço de leitura expõe informações para o Prometheus e o MCP.

Decisões e trade-offs

Idempotência por ID
O efeito sintético, o estado do evento e o ACK ficam no Redis. A transição é atômica dentro dessa fronteira. Efeitos em sistemas externos exigiriam outro mecanismo.

Qualidade e operação

  • Testado localmente com queda do consumidor, reinício abrupto do Redis, replay concorrente, coleta Prometheus e consultas por MCP. O laboratório do site oferece uma simulação no navegador.

Estado e próximos passos

  • Publicar o código e conectar um painel público com apenas os totais do ambiente sintético.

Stack

TypeScriptNode.jsRedis StreamsLuaPrometheusMCPDocker Compose