Developers often struggle to debug distributed systems where requests jump between multiple services, leaving scattered logs and lost context. A new open-source project, the NATS Flow Gateway, tackles this by creating a traceable API gateway. It automatically logs every operation step-by-step, eliminating the need for manual instrumentation and making production issues far easier to diagnose.

The architecture uses a flow-based design where a request travels from a Fastify server to NATS, which handles the messaging between decoupled services. This approach embeds Chain of Thought Tracing directly into the business logic. Each flow function logs its reasoning and execution path, providing a clear audit trail without sacrificing the performance benefits of asynchronous communication.

Getting started is straightforward, with a Docker Compose setup that spins up a Fastify server, PostgreSQL database, and NATS infrastructure. The project includes ready-to-use endpoints for health checks and authentication, organized into clear directories for flows, middleware, and schemas. This structure allows teams to adopt the pattern incrementally, adding Schema Validation at the edge to block bad data before it reaches core logic.