

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Analisi dei risultati dei test in AWS Device Farm
<a name="analyzing-results"></a>

Nell'ambiente di test standard, è possibile utilizzare la console Device Farm per visualizzare i report di ogni test durante l'esecuzione del test. La visualizzazione dei report ti aiuta a capire quali test sono stati superati o meno e ti fornisce dettagli sulle prestazioni e sul comportamento dell'app in diverse configurazioni di dispositivi.

Device Farm raccoglie anche altri elementi come file, log e immagini che è possibile scaricare al termine del test. Queste informazioni possono aiutarti ad analizzare il comportamento dell'app su dispositivi reali, a identificare problemi o bug e a diagnosticare i problemi.

**Topics**
+ [Visualizzazione dei report dei test in Device Farm](how-to-use-reports.md)
+ [Scaricamento di artefatti in Device Farm](artifacts.md)

# Visualizzazione dei report dei test in Device Farm
<a name="how-to-use-reports"></a>

Usa la console Device Farm per visualizzare i report dei test. Per ulteriori informazioni, consulta [Report in AWS Device FarmReport](reports.md).

**Topics**
+ [Prerequisiti](#how-to-use-reports-prerequisites)
+ [Visualizza i report](#how-to-use-reports-viewing-reports)
+ [Stati dei risultati del test Device Farm](how-to-use-reports-displaying-results.md)

## Prerequisiti
<a name="how-to-use-reports-prerequisites"></a>

Configura un'esecuzione di un test e verifica che sia completa.

1.  Per creare un'esecuzione, consulta [Creazione di un'esecuzione di test in Device Farm](how-to-create-test-run.md) e torna a questa pagina.

1. Verifica che l'esecuzione sia completa. Durante l'esecuzione del test, la console Device Farm visualizza un'icona in sospeso ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-calendar.png) per le esecuzioni in corso. Ogni dispositivo in esecuzione inizierà anche con l'icona in sospeso, quindi passerà all'![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-progress.png)icona in esecuzione all'inizio del test. Al termine di ogni test, accanto al nome del dispositivo viene visualizzata l'icona del risultato del test. Una volta completati tutti i test, l'icona in sospeso accanto all'esecuzione diventa l'icona del risultato del test. Per ulteriori informazioni, consulta [Stati dei risultati del test Device Farm](how-to-use-reports-displaying-results.md).

## Visualizza i report
<a name="how-to-use-reports-viewing-reports"></a>

È possibile visualizzare i risultati del test nella console Device Farm.

**Topics**
+ [Visualizza la pagina di riepilogo dell'esecuzione del test](#how-to-use-reports-console-summary)
+ [Visualizza segnalazioni di problemi uniche](#how-to-use-reports-console-unique-problems)
+ [Visualizza i report sui dispositivi](#how-to-use-reports-console-by-device)
+ [Visualizza i report della suite di test](#how-to-use-reports-console-by-suite)
+ [Visualizzazione dei report di test](#how-to-use-reports-console-by-test)
+ [Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto](#how-to-use-reports-console-log)

### Visualizza la pagina di riepilogo dell'esecuzione del test
<a name="how-to-use-reports-console-summary"></a>

1. Accedere alla console Device Farm all'indirizzo [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)

1. **Nel riquadro di navigazione, scegli **Mobile Device Testing, quindi** scegli Progetti.**

1. Nell'elenco di progetti, scegli il progetto da eseguire.
**Suggerimento**  
Per filtrare l'elenco dei progetti per nome, usa la barra di ricerca.

1. Scegli un'esecuzione completata per visualizzarne la pagina con il report dei riepiloghi.

1. La pagina di riepilogo delle esecuzioni dei test mostra una panoramica dei risultati dei test.
   + La sezione **Unique problems (Problemi univoci)** elenca gli avvisi e gli errori univoci. Per visualizzare i problemi univoci, segui le istruzioni contenute in [Visualizza segnalazioni di problemi uniche](#how-to-use-reports-console-unique-problems).
   + La sezione **Devices (Dispositivi)** mostra il numero totale di test, per risultato, per ogni dispositivo.

     ![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)

     In questo esempio, ci sono diversi dispositivi. Nella prima voce della tabella, il dispositivo Google Pixel 4 XL con Android versione 10 riporta tre test riusciti, la cui esecuzione ha richiesto 02:36 minuti.

     Per visualizzare i risultati per dispositivo, segui le istruzioni contenute in [Visualizza i report sui dispositivi](#how-to-use-reports-console-by-device).
   + La sezione **Screenshots** mostra un elenco di tutte le schermate acquisite da Device Farm durante l'esecuzione, raggruppate per dispositivo.
   + Nella sezione **Risultati dell'analisi, puoi scaricare il risultato** dell'analisi.

### Visualizza segnalazioni di problemi uniche
<a name="how-to-use-reports-console-unique-problems"></a>

1. In **Unique problems (Problemi univoci)**, scegli il problema che desideri visualizzare. 

1. Scegli il dispositivo. Il report include informazioni sul problema.

   La sezione **Video** mostra una registrazione video scaricabile del test.

   La sezione **Risultato** mostra il risultato del test. Lo stato è rappresentato dall'icona del risultato. Per ulteriori informazioni, consulta [Stati di un singolo test](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).

   La sezione **Logs** mostra tutte le informazioni registrate da Device Farm durante il test. Per visualizzare queste informazioni, segui le istruzioni contenute in [Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto](#how-to-use-reports-console-log).

   La scheda **File** mostra un elenco di tutti i file associati al test (come i file di registro) che è possibile scaricare. Per scaricare un file, scegli il relativo link nell'elenco.

   La scheda **Screenshots** mostra un elenco di tutte le schermate acquisite da Device Farm durante il test.

### Visualizza i report sui dispositivi
<a name="how-to-use-reports-console-by-device"></a>
+ Nella sezione **Devices (Dispositivi)**, scegli il dispositivo.

  La sezione **Video** mostra una registrazione video scaricabile del test.

  La sezione **Suite** visualizza una tabella contenente informazioni sulle suite per il dispositivo.

  In questa tabella, la colonna **Risultati dei test** riepiloga il numero di test per risultato per ciascuna delle suite di test eseguite sul dispositivo. Questi dati hanno anche una componente grafica. Per ulteriori informazioni, consulta [Stati per test multipli](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).

  Per visualizzare i risultati completi per suite, segui le istruzioni riportate in[Visualizza i report della suite di test](#how-to-use-reports-console-by-suite).

  La sezione **Logs** mostra tutte le informazioni che Device Farm ha registrato per il dispositivo durante l'esecuzione. Per visualizzare queste informazioni, segui le istruzioni contenute in [Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto](#how-to-use-reports-console-log).

  La sezione **File** visualizza un elenco di suite per il dispositivo e tutti i file associati (come i file di registro) che è possibile scaricare. Per scaricare un file, scegli il relativo link nell'elenco.

  La sezione **Screenshots** mostra un elenco di tutte le schermate acquisite da Device Farm durante l'esecuzione per il dispositivo, raggruppate per suite.

### Visualizza i report della suite di test
<a name="how-to-use-reports-console-by-suite"></a>

1. Nella sezione **Devices (Dispositivi)**, scegli il dispositivo.

1. Nella sezione **Suite**, scegli la suite dalla tabella.

   La sezione **Video** mostra una registrazione video scaricabile del test.

   La sezione **Test** mostra una tabella contenente informazioni sui test della suite.

   Nella tabella, la colonna **Risultati dei test** mostra il risultato. Questi dati hanno anche una componente grafica. Per ulteriori informazioni, consulta [Stati per test multipli](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).

   Per visualizzare i risultati completi dei test, segui le istruzioni riportate in[Visualizzazione dei report di test](#how-to-use-reports-console-by-test).

   La sezione **Logs** mostra tutte le informazioni registrate da Device Farm durante l'esecuzione della suite. Per visualizzare queste informazioni, segui le istruzioni contenute in [Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto](#how-to-use-reports-console-log).

   La sezione **File** mostra un elenco di test per la suite e tutti i file associati (come i file di registro) che è possibile scaricare. Per scaricare un file, scegli il relativo link nell'elenco.

   La sezione **Screenshots** mostra un elenco di tutte le schermate acquisite da Device Farm durante l'esecuzione della suite, raggruppate per test.

### Visualizzazione dei report di test
<a name="how-to-use-reports-console-by-test"></a>

1. Nella sezione **Devices (Dispositivi)**, scegli il dispositivo.

1. Nella sezione **Suites (Suite)**, scegli la suite.

1. Nella sezione **Test**, scegli il test.

1. La sezione **Video** mostra una registrazione video scaricabile del test.

   La sezione **Risultato** mostra il risultato del test. Lo stato è rappresentato dall'icona del risultato. Per ulteriori informazioni, consulta [Stati di un singolo test](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).

   La sezione **Logs** mostra tutte le informazioni registrate da Device Farm durante il test. Per visualizzare queste informazioni, segui le istruzioni contenute in [Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto](#how-to-use-reports-console-log).

   La scheda **File** mostra un elenco di tutti i file associati al test (come i file di registro) che è possibile scaricare. Per scaricare un file, scegli il relativo link nell'elenco.

   La scheda **Screenshots** mostra un elenco di tutte le schermate acquisite da Device Farm durante il test.

### Visualizza le informazioni di registro relative a un problema, un dispositivo, una suite o un test in un rapporto
<a name="how-to-use-reports-console-log"></a>

La sezione **Registri** mostra le seguenti informazioni:
+ **Source (Origine)** indica l'origine di una voce di log. I valori possibili includono:
  + **Harness** rappresenta una voce di registro creata da Device Farm. Queste voci di registro vengono in genere create durante eventi di avvio e arresto.
  + **Device** rappresenta una voce di registro creata dal dispositivo. Per Android, queste voci di registro sono compatibili con logcat. Per iOS, queste voci di registro sono compatibili con syslog.
  + **Test** indica una voce di registro creata da un test o dal relativo framework.
+ **Time (Tempo)** indica il tempo trascorso tra la prima voce di log e questa. L'ora è espressa in un *MM:SS.SSS* formato, dove *M* rappresenta i minuti e *S* rappresenta i secondi.
+ **PID** indica l'identificatore del processo (PID) che ha creato la voce di log. Tutte le voci di log create da un'app su un dispositivo hanno lo stesso PID.
+ **Level (Livello)** indica il livello registrato per la voce di log. Ad esempio, `Logger.debug("This is a message!")` registra il **livello** `Debug`. I valori possibili sono:
  + **Avviso**
  + **Critico**
  + **Esegui il debug**
  + **Emergenza**
  + **Errore**
  + **Errore**
  + **Non riuscito**
  + **Informazioni**
  + **Interno**
  + **Comunicazione**
  + **Superato**
  + **Saltato**
  + **Arrestate**
  + **Modalità dettagliata**
  + **Notifica**
  + **Attenzione**
+ **Tag** indica metadati arbitrari per la voce di log. Ad esempio, il logcat Android può servirsene per descrivere quale parte del sistema ha creato la voce di log (ad esempio, `ActivityManager`).
+ **Message (Messaggio)** indica il messaggio o i dati per la voce di registro. Ad esempio, `Logger.debug("Hello, World!")` registra il valore **Message (Messaggio)** `"Hello, World!"`.

Per visualizzare solo una parte delle informazioni:
+ Per mostrare tutte le voci di registro che corrispondono a un valore per una colonna specifica, inserisci il valore nella barra di ricerca. Ad esempio, per mostrare tutte le voci di registro con un valore **Source** pari a`Harness`, **Harness** inseriscilo nella barra di ricerca.
+ Per rimuovere tutti i caratteri da un riquadro dell'intestazione di una colonna, seleziona la **X** in quel riquadro in questione. Rimuovere tutti i caratteri da una casella di intestazione di colonna equivale a inserirli **\$1** in quella casella di intestazione di colonna.

Per scaricare tutte le informazioni di registro per il dispositivo, incluse tutte le suite e i test che hai eseguito, scegli **Scarica** registri.

# Stati dei risultati del test Device Farm
<a name="how-to-use-reports-displaying-results"></a>

La console Device Farm mostra icone che consentono di valutare rapidamente lo stato dell'esecuzione del test completata. Per ulteriori informazioni sui test in Device Farm, vedere[Report in AWS Device FarmReport](reports.md).

**Topics**
+ [Stati di un singolo test](#how-to-use-reports-displaying-results-individual)
+ [Stati per test multipli](#how-to-use-reports-displaying-results-summary)

## Stati di un singolo test
<a name="how-to-use-reports-displaying-results-individual"></a>

Per i report che descrivono un singolo test, Device Farm visualizza un'icona che rappresenta lo stato del risultato del test:


| Description | Icon | 
| --- | --- | 
| Il test ha avuto esito positivo. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-success.png) | 
| Il test ha avuto esito negativo. | ![\[The test failed.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-failure.png) | 
| Device Farm ha saltato il test. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-skipped.png) | 
| Il test si è interrotto. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-stopped.png) | 
| Device Farm ha restituito un avviso. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-warning.png) | 
| Device Farm ha restituito un errore. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-run-error.png) | 

## Stati per test multipli
<a name="how-to-use-reports-displaying-results-summary"></a>

Se si sceglie un'esecuzione completata, Device Farm visualizza un grafico riassuntivo che mostra la percentuale di test nei vari stati.

![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/df-summary-results-graph.png)

Ad esempio, questo grafico dei risultati dell'esecuzione del test mostra che nella corsa sono stati interrotti 4 test interrotti, 1 test fallito e 10 test riusciti.

I grafici sono sempre codificati a colori ed etichettati.

# Scaricamento di artefatti in Device Farm
<a name="artifacts"></a>

Device Farm raccoglie artefatti come report, file di registro e immagini per ogni test in esecuzione.

Puoi scaricare artefatti creati durante la sessione di test:

**File**  
File generati durante l'esecuzione del test, inclusi i report di Device Farm. Per ulteriori informazioni, consulta [Visualizzazione dei report dei test in Device Farm](how-to-use-reports.md).

**Log**  
Output da ciascun test nella sessione.

**Screenshot**  
Immagini di schermata registrate per ogni test nella sessione.

![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in Cloud AWS.\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/hierarchy.png)


## Scarica artefatti (console)
<a name="artifacts-console"></a>

1. Nella pagina del report della sessione di test, da **Devices (Dispositivi)**, selezionare un dispositivo mobile.

1. Per scaricare un file, sceglierne uno da **Files (File)**.

1. Per scaricare i log dalla sessione di test, da **Logs (Log)**, selezionare **Download logs (Scarica log)**.

1. Per scaricare uno screenshot, scegliere uno screenshot da **Screenshots (Screenshot)**.

Per ulteriori informazioni su come scaricare gli artefatti in un ambiente di test personalizzato, consulta [Scaricamento di artefatti in un ambiente di test personalizzato](using-artifacts-custom.md).

## Scarica gli artefatti ()AWS CLI
<a name="artifacts-cli"></a>

Puoi usare il AWS CLI per elencare gli artefatti del test eseguito.

**Topics**
+ [Fase 1: Ottieni i tuoi Amazon Resource Names (ARN)](#artifacts-cli-step1)
+ [Fase 2: Elenca i tuoi artefatti](#artifacts-cli-step2)
+ [Passaggio 3: scarica i tuoi artefatti](#artifacts-cli-step3)

### Fase 1: Ottieni i tuoi Amazon Resource Names (ARN)
<a name="artifacts-cli-step1"></a>

Puoi elencare i tuoi artefatti per sessione, lavoro, suite di test o test. Ti occorre l'ARN corrispondente. Questa tabella mostra l'ARN di input per ciascuno dei comandi dell' AWS CLI elenco:


| AWS CLI Comando di elenco | ARN richiesto | 
| --- | --- | 
| list-projects | Questo comando restituisce tutti i progetti e non richiede un ARN. | 
| list-runs | project | 
| list-jobs | run | 
| list-suites | job | 
| list-tests | suite | 

Ad esempio, per trovare l'ARN di un test, esegui **list-tests** utilizzando l'ARN della tua suite di test come parametro di input.

Esempio:

```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```

La risposta include un ARN di test per ogni test nella suite di test.

```
{
    "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
            }
        }
    ]
}
```

### Fase 2: Elenca i tuoi artefatti
<a name="artifacts-cli-step2"></a>

Il comando AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) restituisce un elenco di artefatti, come file, schermate e registri. Ogni artefatto dispone di un URL in modo che tu possa scaricare il file.
+ Chiama **list-artifacts** specificando l'ARN di una sessione, un lavoro, una suite di test o un test. Specifica un tipo di FILE, LOG o SCREENSHOT.

  Questo esempio restituisce un URL di download per ogni artefatto disponibile per un singolo test:

  ```
  aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
  ```

  La risposta contiene un URL di download per ogni artefatto.

  ```
  {
      "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",
          }
      ]
  }
  ```

### Passaggio 3: scarica i tuoi artefatti
<a name="artifacts-cli-step3"></a>
+ Scarica i tuoi artefatti utilizzando l'URL dalla fase precedente. Questo esempio utilizza **curl** per scaricare un file di output Android Appium Java:

  ```
  curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyArtifactName.txt
  ```

## Scarica gli artefatti (API)
<a name="artifacts-api"></a>

Il [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)metodo API Device Farm restituisce un elenco di elementi, come file, schermate e registri. Ogni artefatto dispone di un URL in modo che tu possa scaricare il file.

# Scaricamento di artefatti in un ambiente di test personalizzato
<a name="using-artifacts-custom"></a>

In un ambiente di test personalizzato, Device Farm raccoglie artefatti come report personalizzati, file di registro e immagini. Questi artefatti sono disponibili per ciascun dispositivo nella sessione di test.

Puoi scaricare questi artefatti creati durante la sessione di test:

**Output di specifica di test**  
L'output derivante dall'esecuzione dei comandi nel file YAML di specifica di test.

**Artefatti personalizzati**  
Un file compresso che contiene gli artefatti della sessione di test. È configurato nella sezione **artifact: (artefatti:)** sezione del tuo file YAML di specifica di test.

**Script della shell di specifica di test**  
Un file di script della shell intermedio creato dal tuo file YAML. Dato che è utilizzato nella sessione di test, il file di script della shell può essere utilizzato per il debug del file YAML.

**File di specifica di test**  
Il file YAML utilizzato nella sessione di test.

Per ulteriori informazioni, consulta [Scaricamento di artefatti in Device Farm](artifacts.md).

![\[Gerarchia delle operazioni di Device Farm in un ambiente di test personalizzato\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/hierarchy.png)
