Exercice 8 / 8Moyen
Middleware Request ID
À toi
Écris un middleware qui :
- Lit
req.headers["x-request-id"]s'il existe (le client/proxy peut en fournir un). - Sinon, génère un nouvel ID via
crypto.randomUUID()(disponible globalement). - Pose
req.id = <id>. - Pose le header de réponse
x-request-id: <id>. next().
Applique-le, puis expose GET /me qui retourne { requestId: req.id }.
Request ID : tracer une requête à travers les logs
Quand un user te dit "ça a planté à 14h32", tu cherches dans tes logs. Mais 14h32, c'est peut-être 200 requêtes en parallèle. Comment isoler la sienne ?
→ Tu donnes à chaque requête un ID unique, présent dans :
- Tous les logs émis pendant cette requête
- Le header de réponse (que le user peut te donner)
Pattern complet
app.use((req, res, next) => {
req.id = req.headers["x-request-id"] ?? crypto.randomUUID();
res.setHeader("x-request-id", req.id);
next();
});
app.use((req, res, next) => {
console.log(JSON.stringify({ reqId: req.id, msg: "incoming", url: req.url }));
next();
});
Si une exception se produit dans controller.create, tu logges aussi avec reqId: req.id. Tu peux ensuite filtrer dans Datadog/Loki par cet ID et reconstruire toute la séquence.
Pourquoi accepter un ID en entrée
Si la requête vient d'un autre service interne (microservices) qui a déjà un request-id, tu réutilises le sien plutôt que d'en créer un nouveau. Ça permet le distributed tracing :
[mobile-app reqId=ABC] → [API Gateway reqId=ABC] → [auth-service reqId=ABC] → [user-service reqId=ABC]
Tous les logs de tous les services peuvent être corrélés par ABC. C'est inestimable pour debugger un incident en prod.
crypto.randomUUID()
Depuis Node 19+ (et dans les Web Workers / browsers modernes), crypto.randomUUID() est global :
crypto.randomUUID(); // "550e8400-e29b-41d4-a716-446655440000"
- 128 bits aléatoires sécurisés (utilisable comme token éphémère)
- Format UUID v4 standard
- Pas de collision en pratique (probabilité < 1 sur 2^61 sur des trillions d'IDs)
Avant Node 19, il fallait require("node:crypto").randomUUID().
Alternative : compteur monotone
Si tu veux des IDs lisibles et ordonnables :
let counter = 0;
const newId = () => `${Date.now()}-${++counter}`;
Avantages : tri chronologique trivial, taille fixe. Inconvénients : pas adapté à du multi-instance (chaque process a son propre counter), ID prévisible (à éviter pour des tokens).
Pour la plupart des cas API : UUID v4.
Exposer dans la réponse
Mettre l'ID dans X-Request-Id permet :
- Au client de le donner au support : "j'ai eu une erreur, voilà mon X-Request-Id : ABC"
- Aux outils de monitoring frontend de corréler avec les logs backend
- Aux proxies/load balancers de tracer leur passage
C'est une convention de fait. Ne pas l'omettre.
En prod : pino + pino-http
const pinoHttp = require("pino-http");
app.use(pinoHttp({ genReqId: req => req.headers["x-request-id"] || crypto.randomUUID() }));
pino-http pose req.id automatiquement et l'inclut dans tous les logs émis via req.log.info(...). Tu n'as quasi rien à faire.
Tu es bloqué ?
Ouvre les indices un par un, le corrigé en dernier.
Indice 1
const id = req.headers["x-request-id"] ?? crypto.randomUUID();
Indice 2
Pose le header AVANT next() : res.setHeader("x-request-id", id);.
Indice 3
crypto.randomUUID() est globalement disponible depuis Node 19 (et dans les Web Workers).
Voir le corrigé
Connecte-toi pour voir le corrigé
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données
Pour revoir la notion : chapitre 10 du cours Node.js, CORS et sécurité d'une API Express : helmet, limitation de débit.
Connecte-toi pour faire cet exercice
C'est gratuit, avec ton compte Google : un clic, et tu reviens ici. Ta progression te suit ensuite sur tous tes appareils.
Le site garde ton nom et ton email, rien d'autre. Tes données