Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Analyse des résultats des tests dans AWS Device Farm
Dans l'environnement de test standard, vous pouvez utiliser la console Device Farm pour consulter les rapports de chaque test de votre cycle de test. La consultation des rapports vous permet de comprendre quels tests ont été réussis ou ont échoué, et vous fournit des informations détaillées sur les performances et le comportement de votre application sur les différentes configurations d'appareils.
Device Farm rassemble également d'autres artefacts tels que des fichiers, des journaux et des images que vous pouvez télécharger une fois votre test terminé. Ces informations peuvent vous aider à analyser le comportement de votre application sur de vrais appareils, à identifier les problèmes ou les bogues et à diagnostiquer les problèmes.
**Topics**
+ [Afficher les rapports de test dans Device Farm](how-to-use-reports.md)
+ [Téléchargement d'artefacts dans Device Farm](artifacts.md)
# Afficher les rapports de test dans Device Farm
Utilisez la console Device Farm pour consulter vos rapports de test. Pour de plus amples informations, veuillez consulter [Rapports dans AWS Device FarmRapports](reports.md).
**Topics**
+ [Conditions préalables](#how-to-use-reports-prerequisites)
+ [Afficher les rapports](#how-to-use-reports-viewing-reports)
+ [Statuts des résultats des tests Device Farm](how-to-use-reports-displaying-results.md)
## Conditions préalables
Configurez une exécution de test et vérifiez qu'elle est terminée.
1. Pour créer une exécution, consultez [Création d'un test dans Device Farm](how-to-create-test-run.md), puis revenez à cette page.
1. Vérifiez que l'exécution est terminée. Pendant votre test, la console Device Farm affiche une icône en attente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-calendar.png) pour les exécutions en cours. Chaque appareil en cours d'exécution démarrera également par l'icône en attente, puis passera à l'![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-progress.png)icône en cours d'exécution lorsque le test débutera. À la fin de chaque test, une icône de résultat de test s'affiche à côté du nom de l'appareil. Lorsque tous les tests sont terminés, l'icône en attente à côté de l'exécution devient une icône de résultat de test. Pour de plus amples informations, veuillez consulter [Statuts des résultats des tests Device Farm](how-to-use-reports-displaying-results.md).
## Afficher les rapports
Vous pouvez consulter les résultats de votre test dans la console Device Farm.
**Topics**
+ [Afficher la page récapitulative du test](#how-to-use-reports-console-summary)
+ [Afficher des rapports de problèmes uniques](#how-to-use-reports-console-unique-problems)
+ [Afficher les rapports sur les appareils](#how-to-use-reports-console-by-device)
+ [Afficher les rapports de la suite de tests](#how-to-use-reports-console-by-suite)
+ [Affichage des rapports de test](#how-to-use-reports-console-by-test)
+ [Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport](#how-to-use-reports-console-log)
### Afficher la page récapitulative du test
1. Connectez-vous à la console Device Farm à l'adresse [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm).
1. Dans le volet de navigation, choisissez **Mobile Device Testing**, puis **Projects**.
1. Dans la liste des projets, choisissez le projet pour l'exécution.
**Astuce**
Pour filtrer la liste des projets par nom, utilisez la barre de recherche.
1. Choisissez une exécution terminée pour afficher la page de son rapport récapitulatif.
1. La page récapitulative de l'exécution de test affiche une présentation de vos résultats de test.
+ La section **Unique problems (Problèmes uniques)** répertorie les avertissements et échecs uniques. Pour afficher les problèmes uniques, suivez les instructions fournies dans [Afficher des rapports de problèmes uniques](#how-to-use-reports-console-unique-problems).
+ La section **Devices (Appareils)** affiche le nombre total de tests, par résultat, pour chaque appareil.
![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)
Dans cet exemple, il existe plusieurs appareils. Dans la première entrée du tableau, l'appareil Google Pixel 4 XL exécutant la version 10 d'Android signale trois tests réussis dont l'exécution a duré 02:36 minutes.
Pour afficher les résultats par appareil, suivez les instructions fournies dans [Afficher les rapports sur les appareils](#how-to-use-reports-console-by-device).
+ La section **Captures d'écran** affiche la liste de toutes les captures d'écran capturées par Device Farm pendant l'exécution, regroupées par appareil.
+ Dans la section **Résultat de l'analyse**, vous pouvez télécharger le résultat de l'analyse.
### Afficher des rapports de problèmes uniques
1. Dans **Unique problems (Problèmes uniques)**, choisissez le problème que vous souhaitez afficher.
1. Choisissez l'appareil. Le rapport affiche des informations sur le problème.
La section **Video (Vidéo)** affiche un enregistrement vidéo téléchargeable du test.
La section **Résultat** affiche le résultat du test. Le statut est représenté par une icône de résultat. Pour de plus amples informations, veuillez consulter [Statuts d'un test individuel](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
La section **Logs** affiche toutes les informations enregistrées par Device Farm pendant le test. Pour afficher ces informations, suivez les instructions fournies dans [Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport](#how-to-use-reports-console-log).
L'onglet **Fichiers** affiche la liste de tous les fichiers associés au test (tels que les fichiers journaux) que vous pouvez télécharger. Pour télécharger un fichier, cliquez sur le lien du fichier dans la liste.
L'onglet **Captures d'écran** affiche la liste de toutes les captures d'écran capturées par Device Farm pendant le test.
### Afficher les rapports sur les appareils
+ Dans la section **Devices (Appareils)**, choisissez l'appareil.
La section **Video (Vidéo)** affiche un enregistrement vidéo téléchargeable du test.
La section **Suites** affiche un tableau contenant des informations sur les suites de l'appareil.
Dans ce tableau, la colonne **Résultats des tests** récapitule le nombre de tests par résultat pour chacune des suites de tests exécutées sur le périphérique. Ces données comportent également une composante graphique. Pour de plus amples informations, veuillez consulter [Statuts pour plusieurs tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Pour afficher les résultats complets par suite, suivez les instructions figurant dans[Afficher les rapports de la suite de tests](#how-to-use-reports-console-by-suite).
La section **Logs** affiche toutes les informations que Device Farm a enregistrées pour l'appareil pendant l'exécution. Pour afficher ces informations, suivez les instructions fournies dans [Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport](#how-to-use-reports-console-log).
La section **Fichiers** affiche la liste des suites pour l'appareil et tous les fichiers associés (tels que les fichiers journaux) que vous pouvez télécharger. Pour télécharger un fichier, cliquez sur le lien du fichier dans la liste.
La section **Captures d'écran** affiche la liste de toutes les captures d'écran capturées par Device Farm pendant l'exécution de l'appareil, regroupées par suite.
### Afficher les rapports de la suite de tests
1. Dans la section **Devices (Appareils)**, choisissez l'appareil.
1. Dans la section **Suites**, choisissez la suite dans le tableau.
La section **Video (Vidéo)** affiche un enregistrement vidéo téléchargeable du test.
La section **Tests** affiche un tableau contenant des informations sur les tests de la suite.
Dans le tableau, la colonne **Résultats du test** affiche le résultat. Ces données comportent également une composante graphique. Pour de plus amples informations, veuillez consulter [Statuts pour plusieurs tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Pour afficher les résultats complets par test, suivez les instructions de[Affichage des rapports de test](#how-to-use-reports-console-by-test).
La section **Logs** affiche toutes les informations enregistrées par Device Farm lors de l'exécution de la suite. Pour afficher ces informations, suivez les instructions fournies dans [Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport](#how-to-use-reports-console-log).
La section **Fichiers** affiche la liste des tests pour la suite et tous les fichiers associés (tels que les fichiers journaux) que vous pouvez télécharger. Pour télécharger un fichier, cliquez sur le lien du fichier dans la liste.
La section **Captures d'écran** affiche une liste de toutes les captures d'écran capturées par Device Farm lors de l'exécution de la suite, regroupées par test.
### Affichage des rapports de test
1. Dans la section **Devices (Appareils)**, choisissez l'appareil.
1. Dans la section **Suites**, choisissez la suite.
1. Dans la section **Tests**, choisissez le test.
1. La section **Video (Vidéo)** affiche un enregistrement vidéo téléchargeable du test.
La section **Résultat** affiche le résultat du test. Le statut est représenté par une icône de résultat. Pour de plus amples informations, veuillez consulter [Statuts d'un test individuel](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
La section **Logs** affiche toutes les informations enregistrées par Device Farm pendant le test. Pour afficher ces informations, suivez les instructions fournies dans [Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport](#how-to-use-reports-console-log).
L'onglet **Fichiers** affiche la liste de tous les fichiers associés au test (tels que les fichiers journaux) que vous pouvez télécharger. Pour télécharger un fichier, cliquez sur le lien du fichier dans la liste.
L'onglet **Captures d'écran** affiche la liste de toutes les captures d'écran capturées par Device Farm pendant le test.
### Afficher les informations du journal relatives à un problème, à un appareil, à une suite ou à un test dans un rapport
La section **Logs** affiche les informations suivantes :
+ **Source** représente la source d'une entrée de journal. Les valeurs possibles incluent :
+ **Harness** représente une entrée de journal créée par Device Farm. Ces entrées de journal sont généralement créées lors du démarrage et de l'arrêt d'événements.
+ Le **périphérique** représente une entrée de journal créée par le périphérique. Pour Android, ces entrées de journal sont compatibles avec logcat. Pour iOS, ces entrées de journal sont compatibles avec syslog.
+ **Test** représente une entrée de journal créée par un test ou son framework de test.
+ **Time (Temps)** représente le temps écoulé entre la première entrée de journal et cette entrée de journal. Le temps est exprimé sous *MM:SS.SSS* forme de *M* minutes et *S* de secondes.
+ **PID** représente l'identifiant de processus (PID) ayant créé l'entrée de journal. Toutes les entrées de journal créées par une application sur un appareil ont le même PID.
+ **Level (Niveau)** représente le niveau de journalisation de l'entrée de journal. Par exemple, `Logger.debug("This is a message!")` consigne un **Level (Niveau)** `Debug`. Voici les valeurs possibles :
+ **Alert (Alerte)**
+ **Critical (Critique)**
+ **Debug (Débogage)**
+ **Emergency (Urgence)**
+ **Error (Erreur)**
+ **Errored (Erroné)**
+ **Échec**
+ **Info (Infos)**
+ **Internal (Interne)**
+ **Notice (Avis)**
+ **Passed (Réussite)**
+ **Ignoré**
+ **Arrêté(e)**
+ **Verbose (Détaillé)**
+ **Warned (Averti)**
+ **Warning (Avertissement)**
+ **Tag (Balise)** représente les métadonnées arbitraires de l'entrée de journal. Par exemple, Android logcat peut s'en servir pour décrire la partie du système ayant créé l'entrée de journal (par exemple, `ActivityManager`).
+ **Message** représente le message ou les données de l'entrée de journal. Par exemple, `Logger.debug("Hello, World!")` journalise le **Message** `"Hello, World!"`.
Pour afficher uniquement une partie des informations :
+ Pour afficher toutes les entrées du journal correspondant à la valeur d'une colonne spécifique, entrez la valeur dans la barre de recherche. Par exemple, pour afficher toutes les entrées du journal dont la valeur **Source** est égale à`Harness`, entrez **Harness** dans la barre de recherche.
+ Pour supprimer tous les caractères d'une zone d'en-tête de colonne, cliquez sur le **X** de cette zone d'en-tête de colonne. Supprimer tous les caractères d'une zone d'en-tête de colonne revient à entrer **\$1** dans cette zone d'en-tête de colonne.
Pour télécharger toutes les informations de journal de l'appareil, y compris toutes les suites et tous les tests que vous avez exécutés, choisissez **Télécharger les journaux**.
# Statuts des résultats des tests Device Farm
La console Device Farm affiche des icônes qui vous aident à évaluer rapidement l'état de votre cycle de test terminé. Pour plus d'informations sur les tests dans Device Farm, consultez[Rapports dans AWS Device FarmRapports](reports.md).
**Topics**
+ [Statuts d'un test individuel](#how-to-use-reports-displaying-results-individual)
+ [Statuts pour plusieurs tests](#how-to-use-reports-displaying-results-summary)
## Statuts d'un test individuel
Pour les rapports décrivant un test individuel, Device Farm affiche une icône représentant l'état des résultats du test :
| Description | Icône |
| --- | --- |
| Le test a abouti. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-success.png) |
| Le test a échoué. | ![\[The test failed.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-failure.png) |
| Device Farm a sauté le test. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-skipped.png) |
| Le test s'est arrêté. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-stopped.png) |
| Device Farm a renvoyé un avertissement. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-warning.png) |
| Device Farm a renvoyé un message d'erreur. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-run-error.png) |
## Statuts pour plusieurs tests
Si vous choisissez une exécution terminée, Device Farm affiche un graphique récapitulatif indiquant le pourcentage de tests dans différents états.
![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/df-summary-results-graph.png)
Par exemple, ce graphique des résultats de test montre que 4 tests ont été interrompus, 1 test ayant échoué et 10 tests réussis.
Les graphiques sont toujours codés par couleur et étiquetés.
# Téléchargement d'artefacts dans Device Farm
Device Farm rassemble des artefacts tels que des rapports, des fichiers journaux et des images pour chaque test en cours d'exécution.
Vous pouvez télécharger les artefacts créés au cours de votre série de tests :
**Fichiers**
Fichiers générés pendant le test, y compris les rapports Device Farm. Pour de plus amples informations, veuillez consulter [Afficher les rapports de test dans Device Farm](how-to-use-reports.md).
**Journaux**
Résultat de chaque test de la série de tests.
**Captures d'écran**
Images d'écran enregistrées pour chaque test de la série de tests.
![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in AWS Cloud.\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/hierarchy.png)
## Télécharger des artefacts (console)
1. Sur la page des rapports de test, à partir de **Devices (Appareils)**, choisissez un appareil mobile.
1. Pour télécharger un fichier, choisissez-en un dans la liste **Files (Fichiers)**.
1. Pour télécharger les journaux de votre série de tests, à partir de **Logs (Journaux)**, choisissez **Download logs (Télécharger les journaux)**.
1. Pour télécharger une capture d'écran, choisissez-en une à partir de **Screenshots (Captures d'écran)**.
Pour plus d'informations sur le téléchargement d'artefacts dans un environnement de test personnalisé, consultez [Téléchargement d'artefacts dans un environnement de test personnalisé](using-artifacts-custom.md).
## Télécharger des artefacts (AWS CLI)
Vous pouvez utiliser le AWS CLI pour répertorier les artefacts de vos tests.
**Topics**
+ [Étape 1 : Obtenez vos noms de ressources Amazon (ARN)](#artifacts-cli-step1)
+ [Étape 2 : Répertoriez vos artefacts](#artifacts-cli-step2)
+ [Étape 3 : Téléchargez vos artefacts](#artifacts-cli-step3)
### Étape 1 : Obtenez vos noms de ressources Amazon (ARN)
Vous pouvez répertorier vos artefacts par exécution, tâche, série de tests ou test. Vous avez besoin de l'ARN correspondant. Ce tableau indique l'ARN d'entrée pour chacune des commandes de la AWS CLI liste :
| AWS CLI Commande de liste | ARN requis |
| --- | --- |
| list-projects | Cette commande renvoie tous les projets et ne requiert aucun ARN. |
| list-runs | project |
| list-jobs | run |
| list-suites | job |
| list-tests | suite |
Par exemple, pour trouver l'ARN d'un test, exécutez **list-tests** en utilisant l'ARN de votre suite de tests comme paramètre d'entrée.
Exemple :
```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```
La réponse inclut l'ARN de chaque test de la série de tests.
```
{
"tests": [
{
"status": "COMPLETED",
"name": "Tests.FixturesTest.testExample",
"created": 1537563725.116,
"deviceMinutes": {
"unmetered": 0.0,
"total": 1.89,
"metered": 1.89
},
"result": "PASSED",
"message": "testExample passed",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:test:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 1,
"errored": 0,
"total": 1
}
}
]
}
```
### Étape 2 : Répertoriez vos artefacts
La commande AWS CLI [list-artefacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) renvoie une liste d'artefacts, tels que des fichiers, des captures d'écran et des journaux. Chaque artefact possède une URL vous permettant de télécharger le fichier.
+ Appelez la commande **list-artifacts** en spécifiant un ARN d'exécution, de tâche, de série de tests ou de test. Spécifiez le type FILE, LOG ou SCREENSHOT.
Cet exemple renvoie une URL de téléchargement pour chaque artefact disponible pour un test :
```
aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
```
La réponse contient une URL de téléchargement pour chaque artefact.
```
{
"artifacts": [
{
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"extension": "txt",
"type": "APPIUM_JAVA_OUTPUT",
"name": "Appium Java Output",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:artifact:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
}
]
}
```
### Étape 3 : Téléchargez vos artefacts
+ Téléchargez votre artefact à l'aide de l'URL de l'étape précédente. Cet exemple utilise **curl** pour télécharger un fichier de sortie Appium Java Android :
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyArtifactName.txt
```
## Télécharger des artefacts (API)
La [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)méthode Device Farm API renvoie une liste d'artefacts, tels que des fichiers, des captures d'écran et des journaux. Chaque artefact possède une URL vous permettant de télécharger le fichier.
# Téléchargement d'artefacts dans un environnement de test personnalisé
Dans un environnement de test personnalisé, Device Farm collecte des artefacts tels que des rapports personnalisés, des fichiers journaux et des images. Ces artefacts sont disponibles pour chaque appareil de la série de tests.
Vous pouvez télécharger les artefacts suivants créés au cours de votre série de tests :
**Résultat de spécification de test**
Résultat de l'exécution des commandes du fichier YAML de spécification de test.
**Artefacts client**
Fichier compressé qui contient les artefacts de la série de tests. Il est configuré dans la section **artifacts:** de votre fichier YAML de spécification de test.
**Script shell de spécification de test**
Fichier de script shell intermédiaire créé à partir de votre fichier YAML. Étant donné qu'il est utilisé dans la série de tests, le fichier de script shell peut être utilisé pour déboguer le fichier YAML.
**Fichier de spécification de test**
Fichier YAML utilisé dans la série de tests.
Pour de plus amples informations, veuillez consulter [Téléchargement d'artefacts dans Device Farm](artifacts.md).
![\[Hiérarchie des opérations Device Farm dans un environnement de test personnalisé\]](http://docs.aws.amazon.com/fr_fr/devicefarm/latest/developerguide/images/hierarchy.png)