Analyser les données de test PHPUnit dans New Relic

Si vous utilisez pour gérer et exécuter vos tests unitaires,PHPUnit l'agent PHP New Relic peut capturer automatiquement les résultats du résumé des tests et les envoyer à New Relic sous forme d'événement où vous pouvez interroger et visualiser les données de test en un coup d'œil. Cette fonctionnalité a été sortie dans la version 6.7.0 de l'agent PHP et prend en charge les versions PHPUnit 3.7 à 8.x

Activer l'événement de test PHPUnit

Pour activer l'événement de test PHPUnit :

1. Recherchez ou ajoutez le paramètre newrelic.phpunit_events.enabled dans votre fichier newrelic.ini et définissez-le sur true.
2. Redémarrez votre serveur Web (Apache, PHP-FPM, Nginx, etc.) pour que la modification des paramètres prenne effet.

Afficher l'attribut disponible

Lorsqu'il est activé, l'agent PHP détecte les commandes PHPUnit et remplit New Relic avec deux types d'événements contenant des données pour la suite de tests (nommée TestSuite) et les tests individuels (nommés Test). Vous pouvez interroger les données avec la requêteNRQL et créer un dashboard des informations importantes pour vous.

Pour interroger votre événement de test, utilisez FROM TestSuite et FROM Test lors de la spécification de vos instructions SELECT :

SELECT uniqueCount(name) FROM TestSuite

Exemple de requête

Un dashboard des données récapitulatives des tests vous permet de voir rapidement un aperçu de la réussite globale des tests ainsi que d'explorer les suites défaillantes pour déterminer leur cause. Ces exemples illustrent les types de widgets que vous pouvez créer avec les types d'événements TestSuite et Test .

Pourcentage de réussite

Quel pourcentage de suites ou de tests réussissent ?

SELECT percentage(count(*), WHERE successful IS true) FROM TestSuite

Copier

SELECT percentage(count(*), WHERE outcome = 'passed') FROM Test

Copier

Résultat du test

Quelle est la répartition des résultats des tests ?

SELECT count(*) FROM Test FACET outcome

Copier

Échecs des tests

Quel pourcentage de fois chaque test réussit-il ?

SELECT percentage(count(*), WHERE outcome = 'failed') FROM Test FACET name

Copier

Échecs de la suite de tests

Quel pourcentage de temps chaque suite réussit-elle, et est-ce cohérent dans le temps ?

SELECT histogram((passedCount / testCount)*100, 100, 10) FROM TestSuite FACET name

Copier

Durée

Combien de temps faut-il pour exécuter chaque suite de tests et ce temps est-il cohérent dans le temps ?

SELECT histogram(duration*1000, 10, 20) FROM TestSuite FACET name

Copier

Facettes liées

Étant donné qu'une suite de tests PHPUnit est liée à des tests individuels via son ID d'exécution, vous pouvez utiliser le widgetFACET pour filtrer les résultats d'une exécution de test spécifique.

Par exemple, si vous avez créé un widget avec les suites de tests les plus récentes ayant échoué et que vous l'avez lié au dashboard actuel, vous pouvez cliquer sur un test et le widget environnant sera mis à jour avec les informations correspondant uniquement à cette exécution de suite de tests.

Dans l'exemple ci-dessus, vous pouvez voir qu'en cliquant sur Exécuter 5bb37ccee2a1dbc7, nous apprenons que l'un des deux tests, testFoo, a échoué. Voici les requêtes NRQL qui composent cet exemple :

Recent unsuccessful suites:

SELECT latest(timestamp), latest(name) FROM TestSuite WHERE successful IS false FACET runId

Last unsuccessful suite:

SELECT host, name, duration * 1000 
AS 'duration (ms)', assertionCount, testCount, passedCount, failedCount, incompleteCount, skippedCount, errorCount, riskyCount, warningCount 
FROM TestSuite WHERE successful IS false LIMIT 1

Last unsuccessful test:

SELECT host, name, testSuiteName, duration * 1000 
AS 'duration (ms)', outcome, assertionCount, message 
FROM Test WHERE outcome != 'passed' LIMIT 1

Attribut d'événement PHPUnit

TestSuite et Test événement contient l'attribut suivant sur lequel vous pouvez effectuer une requête :