Lightpanda navigateur headless : le dépôt lightpanda-io/browser se présente comme un navigateur sans interface « construit de zéro pour les agents IA et l’automatisation ». Ni fork de Chromium, ni patch de WebKit : un moteur écrit en Zig, qui embarque V8 pour le JavaScript, html5ever pour l’analyse HTML et libcurl pour le réseau, et qui renonce volontairement à tout moteur de rendu graphique. La page du dépôt affiche environ 38 200 étoiles et 1 900 forks le 30 octobre 2026, sous licence AGPL-3.0.
Pour un SRE, l’intérêt est concret : les agents qui « naviguent » se multiplient, et chaque instance de Chrome headless coûte des centaines de mégaoctets. Lightpanda promet de faire tourner les mêmes scripts Puppeteer ou Playwright, via le protocole CDP, pour une fraction de cette mémoire. Que vaut cette promesse, et comment observe-t-on une flotte de navigateurs pilotés par des agents ?
Précision d’honnêteté : span.observer n’a pas exécuté Lightpanda. Les commandes viennent du README et de la documentation lightpanda.io ; les chiffres de performance sont ceux publiés par le projet, présentés comme tels ; les noms de métriques sont lus dans le code source du dépôt.
Lightpanda navigateur headless : ce que dit le dépôt
- Licence et langage : AGPL-3.0, vérifiée dans le fichier LICENSE le 30 octobre 2026. Le projet exige Zig 0.17.0 (README et champ
minimum_zig_versiondebuild.zig.zon) et une chaîne Rust pour compiler html5ever. - Versions : la page des releases liste 1.0.0 le 2 octobre 2026, 1.0.1 le 15 octobre et 1.0.2 le 23 octobre 2026 (« Latest »). La branche principale porte
1.1.0-dev. Des binaires « nightly » sont publiés pour Linux et macOS (x86_64 et aarch64) ; le README en fait la voie d’installation par défaut. - Maturité : le README ne parle plus de « beta » depuis la 1.0. La page d’architecture décrit toutefois une couverture des Web APIs « partielle mais croissante », et le projet publie chaque jour ses résultats aux Web Platform Tests sur perf.lightpanda.io/wpt. Chaque version ajoute des APIs (Web Crypto, analyse XML en 1.0.2) : le périmètre bouge encore.
- Interfaces : un serveur CDP (
lightpanda serve) pour Puppeteer, Playwright et chromedp ; WebDriver BiDi avec--protocol webdriver; un serveur MCP natif (lightpanda mcp) ; un modeagentpiloté par un LLM dans le même processus ; une commandefetchqui vide une page en HTML, Markdown ou JSON-LD.
Visite de l’architecture
La documentation résume le modèle en une hiérarchie : un App par processus (réseau, pool d’arènes mémoire, plateforme V8, télémétrie), des Browser qui enveloppent chacun un isolat V8, une Session par navigateur (cookies, Web Storage), puis des Page et des Frame qui portent le DOM et les Web APIs.

Deux choix expliquent la faible empreinte mémoire. L’absence de moteur de rendu : la page n’est jamais dessinée, les positions d’éléments sont approximées depuis le DOM, et Page.captureScreenshot renvoie une image de substitution. Et les arènes : une page emprunte une arène au chargement et la rend à la fermeture, ce qui rend son démontage presque gratuit.
Côté chiffres, le projet publie un benchmark de crawl : 933 pages d’un site de démonstration, un programme Go piloté par chromedp, Chrome 143 en face. Le README en tire « 16 fois moins de mémoire et 9 fois plus rapide ». Le document détaillé du dépôt lightpanda-io/demo donne les valeurs : à 25 unités parallèles, 4,81 s et 123 Mo de pic pour Lightpanda contre 46,70 s et 2,0 Go pour Chrome.

Trois réserves, issues du document lui-même : Chrome tournait avec des onglets dans un seul processus tandis que Lightpanda tournait en processus séparés ; la mémoire est mesurée en PSS avec smem toutes les 100 ms ; le README indique une instance m5.large là où le document détaillé parle d’une m5.xlarge. Ce sont des mesures du projet, reproductibles avec ses scripts, pas une mesure indépendante.
Installation pas à pas
Étape 1 — Récupérer un binaire
# Linux x86_64
curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && \
chmod a+x ./lightpanda
./lightpanda version
# macOS Apple Silicon
brew install lightpanda-io/browser/lightpanda
# Docker (serveur CDP sur 9222)
docker run -d --name lightpanda -p 127.0.0.1:9222:9222 lightpanda/browser:latest
Deux pièges signalés par le README : les binaires Linux sont liés à la glibc et échouent sur Alpine, et il n’existe pas de binaire Windows natif ; on l’installe dans WSL2, qui transmet localhost:9222 à l’hôte.
Étape 2 — Démarrer le serveur CDP
./lightpanda serve --obey-robots --log-format pretty --log-level info --host 127.0.0.1 --port 9222
Côté Puppeteer, remplacez le lancement de Chrome par puppeteer.connect({ browserWSEndpoint: "ws://127.0.0.1:9222" }). D’après la référence de la commande, serve accepte 16 connexions CDP simultanées par défaut (--cdp-max-connections) et expose un endpoint /metrics au format Prometheus, désactivable avec --disable-metrics.
Étape 3 — Brancher un agent par MCP
Le serveur MCP parle JSON-RPC 2.0 sur stdio par défaut. Avec --port, il sert plusieurs agents en HTTP : chaque connexion reçoit sa propre session de navigation (page, cookies, mémoire), identifiée par l’en-tête Mcp-Session-Id. La référence liste 32 outils, dont goto, markdown, extract, click, fill, consoleLogs et session_new.
lightpanda mcp --port 9223
curl -s http://127.0.0.1:9223/mcp -H 'Content-Type: application/json' -d '{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "markdown", "arguments": { "url": "https://example.com" } }
}'

Observer une flotte de navigateurs headless
Métriques. Le fichier src/Metrics.zig du dépôt définit ce que /metrics expose : un build_info{version}, des compteurs suffixés _total (serve_commands_total{driver}, http_requests_total{mode}, http_error_total{reason}, js_errors_total{kind}, js_heap_limits_total pour les pages tuées à la limite du tas V8), des jauges (serve_active_connections{driver}, arena_memory_bytes, js_heap_physical_bytes sommé sur tous les isolats vivants) et des histogrammes (http_duration_ms, js_heap_size_bytes). Pour un fetch ponctuel, le code prévoit un drapeau --metrics qui écrit ces séries à la sortie. Vérifiez les noms sur votre version avant d’écrire une alerte : ce fichier change avec le projet.
Logs. Les options communes fixent le niveau (--log-level, warn par défaut) et le format (--log-format logfmt ou pretty) ; --log-filter inclut ou exclut des scopes. Depuis la 1.0.2, les erreurs JavaScript de la page sortent sous le scope page_error au niveau WARN. Le guide MCP recommande de garder warn en production ; tout va sur stderr.
Traces. Lightpanda n’émet pas de traces OpenTelemetry : le projet ne documente aucun export OTLP. La trace de session reste donc côté agent : instrumentez le client (script Puppeteer, hôte MCP) pour ouvrir un span par outil appelé et y attacher l’URL visitée et le statut HTTP ; nous avons détaillé cette approche pour Chrome DevTools MCP et les agents de code. Côté application cible, les appels XHR et fetch du navigateur headless se repèrent comme n’importe quelle requête : voir superviser les requêtes XHR.
Et Dynatrace ?
Aucune intégration Dynatrace n’est documentée par le projet ; nous n’affirmons rien de plus que ce que permet un endpoint Prometheus. En Kubernetes, la documentation Dynatrace SaaS décrit la collecte des exporteurs Prometheus par le module Kubernetes de l’ActiveGate via les annotations metrics.dynatrace.com/scrape, et recommande pour les nouveaux déploiements un Collector OpenTelemetry (receiver prometheus, export OTLP). Ce second chemin vaut aussi pour Dynatrace Managed, où l’OTLP arrive par un Environment ActiveGate. js_heap_physical_bytes et serve_active_connections sont alors des candidates naturelles à une alerte de saturation par nœud.
Limites et points ouverts
- Pas de rendu : capture d’écran réelle, détection d’éléments visuellement masqués et tests visuels sortent du périmètre. La page de benchmarks du projet note elle-même que la sortie texte peut manquer du contenu qu’une page rendue afficherait.
- Couverture des Web APIs « partielle mais croissante » : un site qui dépend d’une API absente échouera silencieusement. Surveillez
js_errors_totaletscript_errors_total. - Rythme : trois versions en trois semaines en octobre 2026, chacune avec une section « Behavior changes » (suppression de
setImmediateen 1.0.1). Épinglez une version plutôt que le nightly. - AGPL-3.0 et télémétrie : exposer le navigateur comme service réseau déclenche les obligations de l’AGPL ; et le README indique que Lightpanda envoie par défaut des données d’usage, à couper avec
LIGHTPANDA_DISABLE_TELEMETRY=true.
Bonnes pratiques
- Réglez
LIGHTPANDA_DISABLE_TELEMETRY=truedans l’image ou le manifeste, pas dans un script lancé à la main. - Bornez chaque instance :
--v8-max-heap-mb,--watchdog-ms(30 000 ms par défaut),--http-timeout(15 000 ms par défaut) et--cdp-max-connections; puis alertez surjs_heap_limits_total, qui compte les pages tuées par cette borne. - Activez
--block-private-networksquand l’agent visite des URL qu’il choisit lui-même : un navigateur qui obéit à un LLM est une surface de SSRF. Cela complète l’isolation du pod décrite dans agent-sandbox, le bac à sable Kubernetes pour agents IA, et les garde-fous des agents IA en production. - Gardez
--obey-robotset un--user-agent-suffixqui identifie votre service ;--user-agentrefuse d’ailleurs toute valeur contenant « Mozilla ». - Une session MCP par agent (
Mcp-Session-Iddistinct) ; le partage d’une page entre agents doit rester un choix explicite.
Questions fréquentes
Mes scripts Puppeteer ou Playwright fonctionnent-ils sans modification ?
Le README le promet pour la partie CDP : on remplace le lancement de Chrome par une connexion à ws://127.0.0.1:9222. Tout ce qui attend un rendu ne donnera pas le même résultat, et une Web API manquante peut casser un site donné.
Quelles métriques surveiller en priorité ?
D’après src/Metrics.zig : serve_active_connections et js_heap_physical_bytes pour la saturation, js_heap_limits_total et js_errors_total pour les pages qui échouent, http_error_total{reason} et http_duration_ms pour le réseau sortant.
Lightpanda produit-il des traces OpenTelemetry ?
Non, rien de tel n’est documenté. Les traces d’une session se construisent dans le client qui pilote le navigateur, avec un span par outil ou par navigation ; les métriques Prometheus complètent cette vue côté ressources.
Conclusion
Lightpanda s’attaque à un coût réel : la mémoire de Chrome headless multipliée par le nombre d’agents. Le pari technique est cohérent, les chiffres publiés sont documentés et reproductibles, et l’endpoint /metrics montre que le projet pense à l’exploitation. Les contreparties sont tout aussi réelles : Web APIs incomplètes, versions fréquentes, licence AGPL et télémétrie par défaut. Un bon candidat pour un pilote mesuré, pas un remplacement aveugle. Sources : dépôt lightpanda-io/browser, référence de la commande serve et benchmarks du dépôt demo.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle.