1. Introduction au profilage continu #
Le profilage continu avec Pyroscope.
Le quatrième signal #
Disponible dans : ✓ OSS ✓ Enterprise ✓ Cloud
Les métriques disent que le service consomme trop, les traces disent où la requête perd du temps, et les profils disent quelle fonction en est responsable. Un profil échantillonne ce que fait le programme : pile d'appels sur le CPU, allocations mémoire, goroutines.
| Signal | Question | Exemple de réponse |
|---|---|---|
| Métrique | Y a-t-il un problème ? | CPU à 90 % |
| Trace | Quelle étape est lente ? | Le calcul du panier : 800 ms |
| Profil | Quelle ligne de code ? | calculTVA() : 60 % du CPU |
Pourquoi « continu » ? #
Le profilage classique se lance à la main, une fois le problème repéré, et il est souvent trop tard pour le reproduire. Le profilage continu enregistre en permanence, avec un faible surcoût. Vous pouvez alors comparer la version d'hier à celle d'aujourd'hui, ou examiner un incident survenu cette nuit.
Les types de profils #
| Type | Mesure | Pour trouver |
|---|---|---|
| CPU | Temps passé par fonction | Calculs coûteux, boucles |
| Mémoire (allocations) | Ce qui est alloué | Pression sur le ramasse-miettes |
| Mémoire (utilisée) | Ce qui reste en mémoire | Fuites |
| Goroutines, threads | Nombre et piles | Blocages, fuites de goroutines |
| Mutex, blocage | Temps d’attente | Contention |
Lire un flame graph #
Pyroscope affiche les profils sous forme de flame graph : chaque rectangle est une fonction, sa largeur indique sa part du total. Cherchez les rectangles larges : ce sont eux qu'il faut optimiser. L'axe horizontal n'est pas le temps.
Pyroscope est le successeur de Grafana Phlare. Voir la formation dédiée Grafana Pyroscope pour aller plus loin.
2. Mise en place de la collecte #
Configuration du scraping et de l'expédition pour Pyroscope.
Trois façons de collecter #
| Composant | Principe | Prérequis |
|---|---|---|
pyroscope.scrape | Interroge les points pprof en HTTP | L’application expose pprof (Go…) |
pyroscope.ebpf | Observe le CPU depuis le noyau | Linux, droits root ; CPU uniquement |
pyroscope.java | Attache async-profiler aux JVM | Accès aux processus Java |
Collecter par HTTP #
En Go, il suffit d'exposer les points pprof :
import _ "net/http/pprof"
go func() {
http.ListenAndServe(":6060", nil)
}()Alloy les interroge comme des métriques :
pyroscope.scrape "app" {
targets = [{ "__address__" = "app:6060", "service_name" = "boutique" }]
scrape_interval = "15s"
forward_to = [pyroscope.write.backend.receiver]
profiling_config {
profile.process_cpu {
enabled = true
}
profile.memory {
enabled = true
}
profile.goroutine {
enabled = true
}
}
}
pyroscope.write "backend" {
endpoint {
url = "http://pyroscope:4040"
}
external_labels = { env = "prod" }
}| Réglage | Défaut |
|---|---|
scrape_interval | 15s |
scrape_timeout | 10s |
delta_profiling_duration | 14s |
Testé en profilant Alloy lui-même, qui expose pprof sur son port HTTP : en un peu plus de 30 secondes, le backend a reçu 6 envois sur /push.v1.PusherService/Push.
Le nom du service compte : ajoutez service_name à vos cibles : c'est par lui que vous retrouverez l'application dans Pyroscope. Et n'exposez jamais le port pprof sur Internet.Sans toucher au code : eBPF #
discovery.process "tous" {
}
pyroscope.ebpf "hote" {
targets = discovery.process.tous.targets
forward_to = [pyroscope.write.backend.receiver]
}
pyroscope.write "backend" {
endpoint {
url = "http://pyroscope:4040"
}
}pyroscope.ebpf profile les processus depuis le noyau, tous langages confondus. Il demande de lancer Alloy en root (ou en conteneur privilégié), et il ne mesure que le CPU. Nous avons validé cette configuration avec alloy validate, sans l'exécuter : l'essai demande des droits root.
Choisir #
| Situation | Choix |
|---|---|
| Applications Go | pyroscope.scrape : mémoire, goroutines et CPU |
| Parc hétérogène, code non modifiable | pyroscope.ebpf |
| Applications Java | pyroscope.java |
| Besoin d’étiquettes métier fines | SDK Pyroscope dans l’application, envoi direct |
Vous pouvez relier les profils aux traces : ajoutez les mêmes étiquettes (service_name, env) des deux côtés pour naviguer de l'un à l'autre dans Grafana.
Mise à jour 2026 : ce qui a changé #
Évolutions récentes à connaître (vérifiées en novembre 2026).
Profilage et OpenTelemetry #
- Le signal profils d'OpenTelemetry est en alpha publique depuis mars 2026 : le format OTLP des profils peut encore changer, à réserver aux essais.
pyroscope.ebpfreste disponible en version stable dans Alloy ; il s'appuie sur l'agent de profilage eBPF d'OpenTelemetry (dans une version maintenue par Grafana). Certains de ses arguments sont devenus sans effet : supprimez-les si Alloy les signale comme dépréciés.- Le composant demande les droits root et l'espace de noms PID de l'hôte, ou à défaut les capacités Linux précises indiquées dans la documentation.
À savoir : Grafana Alloy publie une version mineure environ toutes les trois semaines ; la 1.21 (octobre 2026) est la plus récente au moment de cette mise à jour. Consultez les notes de version avant chaque montée : certaines versions embarquent une nouvelle branche de Prometheus ou du Collector OpenTelemetry, avec des changements cassants signalés.
