RouteMesh

What it does

RouteMesh is a service-platform project that gives distributed applications one reliable entry point for routing, resilience, and observability.

Why it exists

As a system grows, every service should not have to solve discovery, failure handling, and traffic visibility independently. RouteMesh centralizes those concerns while keeping downstream services easier to operate.

What to look for

• Service discovery and request routing
• Circuit breakers for failing downstream services
• Kafka-backed events and Grafana-ready telemetry

How it works

1. 1A client sends a request to the gateway instead of addressing an individual service directly.
2. 2RouteMesh discovers a healthy destination and forwards the request using the configured routing rules.
3. 3Circuit breakers stop repeated calls to an unhealthy service and recover when it becomes available again.
4. 4Operational events and metrics make traffic, latency, and failures visible in the telemetry stack.

How to start it

1. 1Clone the project repository and install the Java 21 toolchain.
2. 2Start the local Kafka and service-discovery dependencies.
3. 3Configure routes, downstream service addresses, and telemetry exporters.
4. 4Start the gateway and example services with the repository's build commands.

How to use it

• Register or configure a downstream service and give it a route.
• Send client traffic to the gateway URL rather than directly to the service.
• Simulate a downstream failure to see the circuit breaker protect callers.
• Use Grafana dashboards and emitted events to inspect the request path.