Logo de Cryo Studio : un cristal de glace

Cryo Studio

Trouvez la ligne PHP qui fuit, à partir de snapshots mémoire .cryo.

▶ Ouvrir Cryo Studio
Cryo Studio : le delta de 5 snapshots désigne SqlLogger::log comme fuite, avec le code de la ligne 17 qui crée les objets et de la ligne 18 qui les accroche
Cinq snapshots d'un worker : SqlLogger::log crée 80 objets par lot à la ligne 17 et la ligne 18 les accroche tous dans SqlLogger::$log.

Ce que fait Cryo Studio

Un processus PHP qui tourne longtemps (worker, démon, serveur applicatif) grossit lot après lot ? L'extension ext-cryo écrit des snapshots du graphe d'objets avec cryo_snapshot(), et retient pour chaque objet la ligne qui l'a créé. Cryo Studio compare ces snapshots et classe les sites d'allocation : combien d'objets chacun crée par intervalle, combien survivent jusqu'au dernier snapshot, et lesquels ne libèrent jamais rien — ceux-là sont marqués [LEAK].

Essayer en 3 étapes

  1. 1. Ouvrir
    Cliquez sur Ouvrir Cryo Studio : la démo (un worker de commandes) est chargée.
  2. 2. Lire les fuites
    La première ligne est la fuite : son code de création, la ligne qui l'accroche, le chemin qui la garde. Puis passez d'un écran à l'autre avec les boutons du haut.
  3. 3. Vos fichiers
    « Ouvrir .cryo » ouvre vos propres snapshots (plusieurs à la fois) et vos séries .cryom ; ils restent dans votre navigateur.

Produire des snapshots

php -d extension=cryo -d cryo.track_alloc=stack worker.php

// dans worker.php :
cryo_metrics_sample(50, __DIR__ . "/worker.cryom");   // la mémoire toutes les 50 ms
// ... après chaque lot :
cryo_snapshot(__DIR__ . "/snap-$batch.cryo");
cryo_metrics_mark("lot $batch");

Puis ouvrez les fichiers snap-*.cryo et worker.cryom dans Cryo Studio, ou en ligne de commande : cryo-inspect delta snap-*.cryo. cryo.track_alloc=site suffit pour les sites de création et d'écriture ; stack ajoute la pile d'appels.

Mode Live : un script qui tourne

php -d extension=cryo -d cryo.track_alloc=site -d cryo.metrics=1 worker.php

// au début de worker.php :
cryo_metrics_serve(9600, "127.0.0.1", [
    "cors"  => "*",                      // ou "https://jumphp.net" : la page peut l'interroger
    "token" => getenv("CRYO_TOKEN"),     // optionnel : ?token= ou Authorization: Bearer
]);

Dans Cryo Studio, écran Live : l'adresse http://127.0.0.1:9600, le jeton, « Connecter ». L'exportateur est un petit processus fils : le script n'attend jamais la page. Il sert aussi /metrics (Prometheus), /metrics.json, /series.json et POST /snapshot.

Écran Live : courbe mémoire d'un script en cours, deux snapshots pris à distance marqués sur la courbe et ajoutés à la liste des snapshots
Le mode Live : la mémoire en direct et deux snapshots pris à distance.

Captures

Questions fréquentes

Qu'est-ce qu'un fichier .cryo ? Un snapshot du graphe d'objets d'un processus PHP écrit par ext-cryo : objets, tableaux, chaînes, références, racines et, avec cryo.track_alloc=site ou stack, la ligne qui a créé chaque objet, celle qui l'a stocké et la pile d'appels.

Et un fichier .cryom ? Une série de mesures de la mémoire écrite par cryo_metrics_sample(), avec les repères de cryo_metrics_mark() : l'écran Série la dessine.

Faut-il ext-cryo pour lire ? Non : dans le navigateur, Cryo Studio lit les fichiers avec son lecteur écrit en PHP, qui donne les mêmes résultats que l'extension. ext-cryo sert à produire les snapshots.

Mes fichiers sont-ils envoyés ? Non, ils sont lus par le PHP qui tourne dans votre navigateur.

Le mode Live marche-t-il depuis le navigateur ? Oui : la page interroge directement le script, grâce aux en-têtes CORS de cryo_metrics_serve() (option cors ; le préflight et l'accès d'une page publique à 127.0.0.1 sont gérés). Votre navigateur peut demander l'autorisation d'accéder au réseau local : acceptez-la. Les données vont du script à votre navigateur, sans serveur entre les deux. Avec token, seul celui qui connaît le jeton lit les mesures et prend des snapshots.

Et si le script dort ? Le snapshot est pris au prochain point sûr de la machine virtuelle PHP ; un script bloqué plus de 10 secondes dans un sleep() ou une entrée-sortie renvoie une erreur 504, la courbe continue.

▶ Analyser des snapshots