li-jin-gou/requestid

RequestID is a small utility for web applications built with the Hertz framework. It solves a common problem: when you're running a busy web service with hundreds of requests flying around simultaneously, it can be really difficult to tell which log entry or error belongs to which specific user request. This tool solves that by giving every single request a unique tracking label. When a request comes in, the middleware checks if the caller already provided a tracking ID in a standard header called X-Request-ID. If one is there, it passes that same ID back in the response. If not, it automatically generates a new one. This tracking label is attached to the response headers, so whoever made the request can read it and use it as a reference point if something goes wrong and they need to ask you to investigate an issue. You can also pull this ID from within your own code to include it in your application's log files. This is primarily useful for backend developers and teams running APIs or web services where things can occasionally fail in confusing ways. Imagine a mobile app developer reports that your server is returning a strange error. Instead of asking them to describe exactly what they clicked, you can ask them for the request ID. With that unique label, you can instantly search your server logs to find the exact request and see exactly what went wrong, rather than digging through thousands of similar-looking entries. By default, the tool uses the standard X-Request-ID header label and automatically generates random tracking IDs. However, the project is built to be flexible. If your system already has its own way of generating tracking labels, you can easily plug that custom generator in. You can also change the header name entirely if your application expects a different label. The project is a community-driven effort inspired by similar tools built for other web frameworks, bringing a familiar pattern to Hertz developers.