As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Analisar os resultados dos testes no AWS Device Farm
No ambiente de teste padrão, é possível usar o console do Device Farm para visualizar os relatórios de cada teste na execução do teste. A visualização dos relatórios ajuda você a entender quais testes foram aprovados ou falharam e fornece detalhes sobre a performance e o comportamento da sua aplicação em diferentes configurações de dispositivos.
O Device Farm também reúne outros artefatos, como arquivos, logs e imagens, que podem ser baixados quando a execução do teste for concluída. Essas informações podem ajudar você a analisar como sua aplicação está se comportando em dispositivos reais, identificar problemas ou bugs e diagnosticar problemas.
**Topics**
+ [Visualizar relatórios de testes no Device Farm](how-to-use-reports.md)
+ [Baixar artefatos no Device Farm](artifacts.md)
# Visualizar relatórios de testes no Device Farm
Use o console do Device Farm para visualizar seus relatórios de testes. Para obter mais informações, consulte [Relatórios no AWS Device FarmRelatórios](reports.md).
**Topics**
+ [Pré-requisitos](#how-to-use-reports-prerequisites)
+ [Visualizar relatórios](#how-to-use-reports-viewing-reports)
+ [Status dos resultados do teste do Device Farm](how-to-use-reports-displaying-results.md)
## Pré-requisitos
Configure uma execução de teste e verifique se ela foi concluída.
1. Para criar uma execução, consulte [Criar uma execução de teste no Device Farm](how-to-create-test-run.md) e retorne a esta página.
1. Verifique se a execução foi concluída. Durante a execução do teste, o console do Device Farm exibe um ícone pendente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-calendar.png) para execuções que estão em andamento. Cada dispositivo na execução também começará com o ícone pendente e, em seguida, mudará para o ícone em execução ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-progress.png) quando o teste começar. Quando cada teste é concluído, um ícone de resultado do teste é exibido ao lado do nome do dispositivo. Quando todos os testes tiverem sido concluídos, o ícone pendente ao lado da execução mudará para um ícone de resultado de teste. Para obter mais informações, consulte [Status dos resultados do teste do Device Farm](how-to-use-reports-displaying-results.md).
## Visualizar relatórios
Você pode visualizar os resultados do seu teste no console do Device Farm.
**Topics**
+ [Visualizar a página de resumo da execução de teste](#how-to-use-reports-console-summary)
+ [Visualizar relatórios de problemas exclusivos](#how-to-use-reports-console-unique-problems)
+ [Visualizar relatórios do dispositivo](#how-to-use-reports-console-by-device)
+ [Visualizar relatórios do conjunto de testes](#how-to-use-reports-console-by-suite)
+ [Visualizar relatórios de teste](#how-to-use-reports-console-by-test)
+ [Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório](#how-to-use-reports-console-log)
### Visualizar a página de resumo da execução de teste
1. Faça login no console do Device Farm em [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)
1. No painel de navegação, escolha **Teste para dispositivos móveis** e **Projetos**.
1. Na lista de projetos, escolha o projeto para a execução.
**dica**
Para filtrar a lista de projetos por nome, use a barra de pesquisa.
1. Escolha uma execução concluída para visualizar a página de relatório resumido.
1. A página de resumo da execução de teste exibe uma visão geral dos resultados do teste.
+ A seção **Problemas exclusivos** lista avisos e falhas exclusivos. Para visualizar problemas exclusivos, siga as instruções em [Visualizar relatórios de problemas exclusivos](#how-to-use-reports-console-unique-problems).
+ A seção **Dispositivos** exibe o número total de testes, por resultado, para cada dispositivo.
![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)
Neste exemplo, há vários dispositivos. Na primeira entrada da tabela, o dispositivo Google Pixel 4 XL com Android versão 10 relata três testes bem-sucedidos que levaram 2:36 minutos para serem executados.
Para visualizar os resultados por dispositivo, siga as instruções em [Visualizar relatórios do dispositivo](#how-to-use-reports-console-by-device).
+ A seção **Capturas de tela** exibe uma lista de todas as capturas de tela que o Device Farm fez durante a execução, agrupadas por dispositivo.
+ Na seção **Resultado da análise**, você pode baixar o resultado da análise.
### Visualizar relatórios de problemas exclusivos
1. Em **Problemas exclusivos**, escolha o problema que você deseja visualizar.
1. Escolha o dispositivo. O relatório exibe informações sobre o problema.
A seção **Vídeo** exibe a gravação em vídeo do teste disponível para download.
A seção **Resultado** exibe o resultado do teste. O status é representado como um ícone de resultado. Para obter mais informações, consulte [Status de um teste individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
A seção **Logs** exibe todas as informações que o Device Farm registrou durante o teste. Para visualizar essas informações, siga as instruções em [Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório](#how-to-use-reports-console-log).
A guia **Arquivos** exibe uma lista de todos os arquivos associados do teste (como arquivos de log) disponíveis para download. Para fazer download de um arquivo, selecione o link do arquivo na lista.
A guia **Capturas de tela** exibe uma lista de todas as capturas de tela que o Device Farm fez durante o teste.
### Visualizar relatórios do dispositivo
+ Na seção **Dispositivos**, escolha o dispositivo.
A seção **Vídeo** exibe a gravação em vídeo do teste disponível para download.
A seção **Conjuntos** exibe uma tabela com informações sobre os conjuntos do dispositivo.
Nessa tabela, a coluna **Resultados do teste** resume o número de testes por resultado para cada um dos conjuntos de testes que foram executados no dispositivo. Esses dados também têm um componente gráfico. Para obter mais informações, consulte [Status de vários testes](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Para visualizar os resultados completos por conjunto, siga as instruções em [Visualizar relatórios do conjunto de testes](#how-to-use-reports-console-by-suite).
A seção **Logs** exibe todas as informações que o Device Farm registrou para o dispositivo durante a execução. Para visualizar essas informações, siga as instruções em [Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório](#how-to-use-reports-console-log).
A seção **Arquivos** exibe uma lista de conjuntos para o dispositivo e todos os arquivos associados (como arquivos de log) que podem ser baixados. Para fazer download de um arquivo, selecione o link do arquivo na lista.
A seção **Capturas de tela** exibe uma lista de todas as capturas de tela que o Device Farm fez durante a execução do dispositivo, agrupadas por conjunto.
### Visualizar relatórios do conjunto de testes
1. Na seção **Dispositivos**, escolha o dispositivo.
1. Na seção **Conjuntos**, escolha o conjunto na tabela.
A seção **Vídeo** exibe a gravação em vídeo do teste disponível para download.
A seção **Testes** exibe uma tabela contendo informações sobre os testes no conjunto.
Na tabela, a coluna **Resultados do teste** exibe o resultado. Esses dados também têm um componente gráfico. Para obter mais informações, consulte [Status de vários testes](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Para visualizar os resultados completos por teste, siga as instruções em [Visualizar relatórios de teste](#how-to-use-reports-console-by-test).
A seção **Logs** exibe todas as informações que o Device Farm registrou durante a execução do conjunto. Para visualizar essas informações, siga as instruções em [Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório](#how-to-use-reports-console-log).
A seção **Arquivos** exibe uma lista de testes para o conjunto e todos os arquivos associados (como arquivos de log) que podem ser baixados. Para fazer download de um arquivo, selecione o link do arquivo na lista.
A seção **Capturas de tela** exibe uma lista de todas as capturas de tela que o Device Farm fez durante a execução do conjunto, agrupadas por teste.
### Visualizar relatórios de teste
1. Na seção **Dispositivos**, escolha o dispositivo.
1. Na seção **Conjuntos**, escolha o conjunto.
1. Na seção **Testes**, escolha o teste.
1. A seção **Vídeo** exibe a gravação em vídeo do teste disponível para download.
A seção **Resultado** exibe o resultado do teste. O status é representado como um ícone de resultado. Para obter mais informações, consulte [Status de um teste individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
A seção **Logs** exibe todas as informações que o Device Farm registrou durante o teste. Para visualizar essas informações, siga as instruções em [Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório](#how-to-use-reports-console-log).
A guia **Arquivos** exibe uma lista de todos os arquivos associados do teste (como arquivos de log) disponíveis para download. Para fazer download de um arquivo, selecione o link do arquivo na lista.
A guia **Capturas de tela** exibe uma lista de todas as capturas de tela que o Device Farm fez durante o teste.
### Visualizar informações de log de um problema, dispositivo, conjunto ou teste em um relatório
A seção **Logs** exibe as seguintes informações:
+ **Origem** representa a origem de uma entrada de log. Os possíveis valores incluem:
+ **Harness** representa uma entrada de log que o Device Farm criou. Essas entradas de log normalmente são criadas durante os eventos de início e interrupção.
+ **Dispositivo** representa uma entrada de log que o dispositivo criou. Para Android, essas entradas de log são compatíveis com logcat. Para iOS, essas entradas de log são compatíveis com syslog.
+ **Teste** representa uma entrada de log criada por um teste ou pela estrutura de teste.
+ **Hora** representa o tempo decorrido entre a primeira entrada de log e a entrada de log em questão. A hora é expressa em *MM:SS.SSS* formato, onde *M* representa minutos e *S* representa segundos.
+ **PID** representa o identificador de processo (PID) que criou a entrada de log. Todas as entradas de log criadas por um aplicativo em um dispositivo têm o mesmo PID.
+ **Nível** representa o nível de registro relativo à entrada de log. Por exemplo, `Logger.debug("This is a message!")` registra o **Nível** de `Debug`. Estes são os valores possíveis:
+ **Alerta**
+ **Crítico**
+ **Depure**
+ **Emergência**
+ **Erro**
+ **Com erro**
+ **Com falha**
+ **Informações**
+ **Interno**
+ **Aviso**
+ **Aprovada**
+ **Skipped**
+ **Interrompido**
+ **Detalhado**
+ **Avisado**
+ **Aviso**
+ **Tag** representa metadados arbitrários relativos à entrada de log. Por exemplo, o logcat para Android pode usar esse recurso para descrever qual parte do sistema criou a entrada de log (por exemplo, `ActivityManager`).
+ **Mensagem** representa a mensagem ou os dados relativos à entrada de log. Por exemplo, `Logger.debug("Hello, World!")` registra uma **Mensagem** de `"Hello, World!"`.
Para exibir apenas uma parte das informações:
+ Para mostrar todas as entradas de log que correspondem a um valor de uma coluna específica, insira o valor na barra de pesquisa. Por exemplo, para mostrar todas as entradas de log com o valor **Origem** de `Harness`, insira **Harness** na barra de pesquisa.
+ Para remover todos os caracteres de uma caixa de cabeçalho de coluna, escolha o **X** na caixa de cabeçalho de coluna. Remover todos os caracteres de uma caixa de cabeçalho de coluna é o mesmo que inserir **\$1** nessa caixa de cabeçalho de coluna.
Para fazer download de todas as informações de registro do dispositivo, incluindo todos os conjuntos e testes executados, selecione **Baixar logs**.
# Status dos resultados do teste do Device Farm
O console do Device Farm exibe ícones que ajudam a avaliar rapidamente o estado da execução de teste concluída. Para acessar mais informações sobre testes no Device Farm, consulte [Relatórios no AWS Device FarmRelatórios](reports.md).
**Topics**
+ [Status de um teste individual](#how-to-use-reports-displaying-results-individual)
+ [Status de vários testes](#how-to-use-reports-displaying-results-summary)
## Status de um teste individual
Para relatórios que descrevem um teste individual, o Device Farm exibe um ícone que representa o status do resultado do teste:
| Description | Ícone |
| --- | --- |
| O teste bem-sucedido. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-success.png) |
| Falha no teste. | ![\[The test failed.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-failure.png) |
| O Device Farm ignorou o teste. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-skipped.png) |
| O teste foi interrompido. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-stopped.png) |
| O Device Farm retornou um aviso. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-warning.png) |
| O Device Farm retornou um erro. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-run-error.png) |
## Status de vários testes
Se você escolher uma execução concluída, o Device Farm exibirá um grafo de resumo mostrando a porcentagem de testes em vários estados.
![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/df-summary-results-graph.png)
Por exemplo, esse grafo de resultados de execução de teste mostra que a execução teve 4 testes interrompidos, 1 teste com falha e 10 testes bem-sucedidos.
Os grafos são sempre codificados por cores e rotulados.
# Baixar artefatos no Device Farm
O Device Farm reúne artefatos como relatórios, arquivos de log e imagens para cada teste na execução.
Você pode fazer download dos artefatos criados durante a execução de teste:
**Arquivos**
Arquivos gerados durante a execução do teste, incluindo relatórios do Device Farm. Para obter mais informações, consulte [Visualizar relatórios de testes no Device Farm](how-to-use-reports.md).
**Logs**
A saída de cada teste na execução.
**Capturas de tela**
Imagens de tela gravadas para cada teste na execução.
![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in Nuvem AWS.\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/hierarchy.png)
## Baixar artefatos (console)
1. Na página de execução do relatório de teste, em **Dispositivos**, escolha um dispositivo móvel.
1. Para fazer download de um arquivo, escolha um dos **Arquivos**.
1. Para fazer download os logs da execução de teste, em **Logs**, escolha **Fazer download de logs**.
1. Para fazer download de uma captura de tela, escolha uma captura de tela **Capturas de tela**.
Para obter mais informações sobre como fazer download de artefatos em um ambiente de teste personalizado, consulte [Baixar artefatos em um ambiente de teste personalizado](using-artifacts-custom.md).
## Baixar artefatos (AWS CLI)
Você pode usar o AWS CLI para listar seus artefatos de execução de teste.
**Topics**
+ [Etapa 1: obter os nomes do recurso da Amazon (ARN)](#artifacts-cli-step1)
+ [Etapa 2: listar os artefatos](#artifacts-cli-step2)
+ [Etapa 3: fazer download dos artefatos](#artifacts-cli-step3)
### Etapa 1: obter os nomes do recurso da Amazon (ARN)
Você pode listar os artefatos por execução, trabalho, conjunto de testes ou teste. Você precisa do ARN correspondente. Esta tabela mostra o ARN de entrada para cada um dos comandos da AWS CLI lista:
| AWS CLI Comando de lista | ARN obrigatório |
| --- | --- |
| list-projects | Este comando retorna todos os projetos e não exige um ARN. |
| list-runs | project |
| list-jobs | run |
| list-suites | job |
| list-tests | suite |
Por exemplo, para encontrar um ARN de teste, execute **list-tests** usando o ARN do pacote de teste como um parâmetro de entrada.
Exemplo:
```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```
A resposta inclui um ARN de teste para cada um no pacote de testes.
```
{
"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
}
}
]
}
```
### Etapa 2: listar os artefatos
O comando AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) retorna uma lista de artefatos, como arquivos, capturas de tela e registros. Cada artefato tem um URL para que você possa fazer download do arquivo.
+ Chame **list-artifacts** especificando uma execução, um trabalho, um pacote de testes ou um ARN de teste. Especifique um tipo de ARQUIVO, LOG ou CAPTURA DE TELA.
Este exemplo retorna um URL de download para cada artefato disponível para um teste individual:
```
aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
```
A resposta contém um URL de download de cada artefato.
```
{
"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",
}
]
}
```
### Etapa 3: fazer download dos artefatos
+ Faça download do artefato usando o URL da etapa anterior. Este exemplo usa **curl** para fazer download de um arquivo de saída Android Appium Java:
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyArtifactName.txt
```
## Baixar artefatos (API)
O [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)método Device Farm API retorna uma lista de artefatos, como arquivos, capturas de tela e registros. Cada artefato tem um URL para que você possa fazer download do arquivo.
# Baixar artefatos em um ambiente de teste personalizado
Em um ambiente de teste personalizado, o Device Farm reúne artefatos como relatórios personalizados, arquivos de log e imagens. Esses artefatos estão disponíveis para cada dispositivo na execução de teste.
Você pode fazer download esses artefatos criados durante a execução de teste:
**Saída da especificação de teste**
A saída da execução dos comandos no arquivo YAML da especificação de teste.
**Artefatos do cliente**
Um arquivo compactado que contém os artefatos da execução de teste. Ele está pré-configurado na seção **artifacts:** do arquivo YAML da especificação de teste.
**Script de shell da especificação de teste**
Um arquivo de script de shell intermediário criado pelo arquivo YAML. Como é usado na execução de teste, o arquivo de script de shell pode ser usado para depurar o arquivo YAML.
**Arquivo de especificação de teste**
O arquivo YAML usado na execução de teste.
Para obter mais informações, consulte [Baixar artefatos no Device Farm](artifacts.md).
![\[Hierarquia de operações do Device Farm em um ambiente de teste personalizado\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/hierarchy.png)