Ember : Le monitoring temps réel pour Caddy et FrankenPHP est disponible

Nous sommes ravis de vous annoncer la sortie de Ember dans sa première version, un outil d'observabilité taillé pour FrankenPHP et Caddy. En tant que mainteneurs de ces différents projets open-source, nous souhaitons proposer à tous la meilleure expérience de monitoring et la plus intégrée possible à travers ce nouveau compagnon. FrankenPHP et Ember avancent main dans la main pour une toute nouvelle synergie dans l'écosystème. Nous connaissons tous ce moment où vous voulez juste savoir ce qui se passe sur notre serveur Caddy, et on se retrouve à scroller dans un mur de texte Prometheus ou à configurer un énième dashboard Grafana.

C'est exactement pour cette raison que Ember a été créé : un dashboard temps réel dans votre terminal, zero-config, qui se lance en une commande. Un htop pour votre serveur Caddy, si vous voulez. Et si vous utilisez FrankenPHP, Ember va encore plus loin. Aujourd'hui, la v1.0.0 est disponible.

Looking for the English version of this article? It's right here! 🇬🇧

Caddy expose des métriques riches via son API d'administration et son endpoint Prometheus. C'est une excellente base. Mais dans la pratique, deux options s'offrent à vous : lire du texte Prometheus brut (bonne chance pour repérer un problème dans un mur de caddy_http_request_duration_seconds_bucket{le="0.025"} 1847), ou monter un stack Grafana + Prometheus complet, avec sa configuration, ses dashboards à importer, et son infrastructure à maintenir.

Pour jeter un œil rapide au trafic en développement ou pour les projets qui se veulent simple et/ou léger, c'est disproportionné.

Et côté FrankenPHP, le constat était encore plus frappant : il n'existait tout simplement aucun outil pour observer en temps réel ce que faisaient les threads PHP. Combien sont occupés ? Lequel traite quelle requête ? Depuis combien de temps ? Quelle consommation mémoire ? Ces questions restaient sans réponse simple.

C'est un véritable challenge, surtout quand la performance est au coeur de votre vision. Comment connaitre de manière rapide les meilleurs paramètres d'autoscaling de FrankenPHP pour votre infrastructure ?

L'idée derrière Ember : rendre l'observabilité accessible, visuelle, et même agréable. Que ça donne envie de lancer l'outil pour comprendre ce qui se passe immédiatement, avec des mesures dérivées prêtes à lire plutôt que des compteurs bruts.

Pas de fichier de configuration à écrire, pas de YAML, pas d'infrastructure supplémentaire. Deux commandes suffisent :

Ce wizard vérifie votre configuration Caddy, détecte si les métriques sont activées, et les active automatiquement via l'API d'administration si besoin, le tout sans redémarrer Caddy.

Il détecte également la présence de FrankenPHP et vous prévient si quelque chose manque.

Ensuite :

C'est tout. Ember se connecte à l'API d'administration de Caddy, auto-détecte FrankenPHP si présent, et affiche un dashboard interactif dans votre terminal.

Et si votre serveur est distant, Ember propose le flag --addr pour vous permettre de donner l'URL du serveur.

Que vous utilisiez Caddy seul ou avec FrankenPHP, le dashboard principal affiche un tableau de trafic par host avec des métriques dérivées calculées en temps réel :

Il est possible de trier sur n'importe quelle colonne, de filtrer par nom de host, et de basculer en graphes ASCII plein écran pour visualiser l'évolution du CPU, des RPS et de la mémoire RSS sur les 300 derniers échantillons. Ember détecte aussi automatiquement les redémarrages de Caddy et réinitialise ses compteurs en conséquence.

Ce ne sont pas des métriques brutes : ce sont des mesures dérivées, calculées par Ember, prêtes à être lues et comprises instantanément.

Si vous utilisez FrankenPHP, Ember débloque une fonctionnalité phare, difficilement réalisable jusqu'à aujourd'hui. Quand FrankenPHP est détecté, un second onglet apparaît automatiquement et offre une visibilité totale sur chaque thread PHP :

Les threads sont groupés intelligemment : threads workers d'abord (regroupés par script), puis les threads classiques. Pour les workers, Ember affiche en plus la profondeur de la file d'attente, le nombre de crashs et de redémarrages. Vous pouvez même redémarrer les workers directement depuis le dashboard avec la touche r.

Pour rendre tout cela possible, nous avons contribué une PR upstream dans FrankenPHP (à partir de la prochaine version 1.13) pour exposer les informations par thread nécessaires. Nous profitons également de cette occasion pour ajouter une page dédiée à l'observabilité dans la documentation de FrankenPHP, où Ember sera recommandé comme outil de monitoring.

Ember n'est pas qu'un dashboard interactif : l'outil est aussi adapté à une utilisation dans un environnement cloud. Un seul binaire, plusieurs modes d'utilisation :

Côté performances, Ember reste très léger : ~15 Mo de RSS et ~0.3 ms par cycle de poll, même avec 100 threads FrankenPHP et 10 hosts Caddy. L'outil de monitoring ne ralentira pas ce qu'il est censé monitorer. Ajoutez à cela :

Avec Homebrew :

Avec Go :

Avec Docker (mode démon par défaut) :

Les binaires sont disponibles pour Linux, macOS et Windows, en amd64 et arm64.

Que serait un outil pareil s'il n'était pas open-source, comme le sont nos autres contributions à l'écosystème PHP ? Ember est open source sous licence MIT. C'est la v1.0.0 et ce n'est que le début.

Si vous utilisez Caddy ou FrankenPHP, nous vous invitons à tester Ember, à ouvrir des issues si vous rencontrez des problèmes, et à proposer des pull-requests si l'envie vous prend. Chaque retour compte pour faire d'Ember l'outil de référence pour le monitoring de l'écosystème Caddy.

Le code source et la documentation complète sont disponibles sur GitHub : alexandre-daubois/ember. L'outil vous plaît ? N'oubliez pas d'ajouter une star sur GitHub. Nous attendons vos retours avec impatience !