Une page web ou une API est lente — comment trouvez-vous la cause ?

Question

Accepted Answer

**Ne devinez pas — mesurez d'abord.** La lenteur peut venir du client, du réseau, du serveur ou de la base de données. Une approche méthodique trouve *où* le temps s'écoule, puis corrige le **contributeur le plus important** au lieu d'optimiser au hasard.

## Une séquence méthodique

```text
1. MEASURE → where is the time spent? client render, network, server, DB?
2. REPRODUCE → confirm it reliably (same endpoint, payload, user)
3. TRACE → use APM/distributed traces to find the slow span
4. CHECK RECENT CHANGES → deploys, config, traffic, data growth
5. ISOLATE → layer by layer, narrow to one component
6. FIX the biggest contributor → re-measure to confirm
```

## Mesurez d'abord : où est le temps ?

Utilisez l'onglet **Network/Performance** du navigateur et le **timing** du serveur pour diviser le total. Une décomposition utile :

```text
Total 1200ms =
  DNS/connect      20ms
  server TTFB     900ms   ← the bottleneck is server-side
  download         80ms
  client render   200ms
```

Regardez les **percentiles, pas les moyennes** : **p50** (utilisateur typique) vs **p99** (pire cas). Un p50 rapide avec un p99 lent pointe vers des problèmes occasionnels — contention de verrous, caches froids, un réplica DB lent, ou des pauses GC — pas un problème uniforme.

## Tracez le span lent

Les outils APM (traces) montrent exactement où le temps s'écoule à l'intérieur d'une requête :

```text
GET /orders                       950ms
  ├─ auth check                    10ms
  ├─ SELECT orders                 30ms
  └─ loop: SELECT user per order  900ms   ← N+1 query, the real cause
```

La trace pointe directement vers l'appel fautif. Ensuite, vérifiez les **changements récents** — un déploiement, un index manquant, ou une croissance de données 10x expliquent souvent une régression soudaine.

## Pourquoi c'est important

Deviner gaspille des heures à optimiser la mauvaise couche. Mesurer d'abord, tracer le span lent et regarder **p50 vs p99** transforme un vague « c'est lent » en une cause spécifique et réparable — et remesurer prouve que la correction a vraiment fonctionné.