Aller au contenu
Réussir mon BTS SIO

Tape une notion, une commande ou le nom d'une épreuve.

Par exemple

Exercice 8 / 8Moyen

Middleware Request ID

À toi

Écris un middleware qui :

  1. Lit req.headers["x-request-id"] s'il existe (le client/proxy peut en fournir un).
  2. Sinon, génère un nouvel ID via crypto.randomUUID() (disponible globalement).
  3. Pose req.id = <id>.
  4. Pose le header de réponse x-request-id: <id>.
  5. 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

javascript
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 :

javascript
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 :

javascript
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

javascript
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.

Ton code

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