

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Análisis de los resultados de las pruebas en AWS Device Farm
<a name="analyzing-results"></a>

En el entorno de pruebas estándar, puede utilizar la consola de Device Farm para ver informes de cada prueba de la ejecución de prueba. Ver los informes lo ayuda a entender qué pruebas se han superado o no, y proporciona detalles sobre el rendimiento y el comportamiento de su aplicación en las diferentes configuraciones de dispositivos.

Device Farm también recopila otros artefactos, como archivos, registros e imágenes, que puede descargar cuando la ejecución de prueba se ha completado. Esta información puede ayudarlo a analizar el comportamiento de su aplicación en dispositivos reales, identificar problemas o errores y diagnosticarlos.

**Topics**
+ [Visualización de informes de pruebas en Device Farm](how-to-use-reports.md)
+ [Descarga de artefactos en Device Farm](artifacts.md)

# Visualización de informes de pruebas en Device Farm
<a name="how-to-use-reports"></a>

Puede utilizar la consola de Device Farm para ver los informes de las pruebas. Para obtener más información, consulte [Informes en AWS Device FarmInformes](reports.md).

**Topics**
+ [Requisitos previos](#how-to-use-reports-prerequisites)
+ [Visualización de informes](#how-to-use-reports-viewing-reports)
+ [Estados de los resultados de las pruebas de Device Farm](how-to-use-reports-displaying-results.md)

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

Configure una ejecución de prueba y compruebe que se haya completado.

1.  Para crear una ejecución, consulte [Creación de una ejecución de prueba en Device Farm](how-to-create-test-run.md) y, a continuación, vuelva a esta página.

1. Compruebe que la ejecución se haya completado. Durante la ejecución de prueba, Device Farm muestra un icono de pendiente ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-calendar.png) en la consola para las ejecuciones que están en curso. Cada dispositivo en ejecución también empezará con el icono de pendiente y, después, pasará al icono ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-progress.png) de ejecución cuando comience la prueba. Al finalizar cada prueba, aparece un icono con el resultado de la prueba junto al nombre del dispositivo. Cuando se hayan completado todas las pruebas, el icono de pendiente situado junto a la ejecución pasará a ser el icono del resultado de la prueba. Para obtener más información, consulte [Estados de los resultados de las pruebas de Device Farm](how-to-use-reports-displaying-results.md).

## Visualización de informes
<a name="how-to-use-reports-viewing-reports"></a>

Puede ver los resultados de la prueba en la consola de Device Farm.

**Topics**
+ [Visualización de la página de resumen de la ejecución de prueba](#how-to-use-reports-console-summary)
+ [Visualización de informes de problemas únicos](#how-to-use-reports-console-unique-problems)
+ [Visualización de informes de dispositivo](#how-to-use-reports-console-by-device)
+ [Visualización de informes de conjuntos de pruebas](#how-to-use-reports-console-by-suite)
+ [Consultar los informes de pruebas](#how-to-use-reports-console-by-test)
+ [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log)

### Visualización de la página de resumen de la ejecución de prueba
<a name="how-to-use-reports-console-summary"></a>

1. Inicie sesión en la consola de Device Farm en [https://console.aws.amazon.com/devicefarm.](https://console.aws.amazon.com/devicefarm)

1. En el panel de navegación, seleccione **Pruebas de dispositivos móviles** y, a continuación, seleccione **Proyectos**.

1. En la lista de proyectos, elija el que desee incluir en la ejecución.
**sugerencia**  
Utilice la barra de búsqueda para filtrar la lista de proyectos por nombre.

1. Elija una ejecución completada para ver su página de resumen de informe.

1. La página de resumen de la ejecución de prueba muestra información general de los resultados de las pruebas.
   + La sección **Problemas únicos** muestra una lista con las advertencias y errores únicos. Para ver los problemas únicos, siga las instrucciones de [Visualización de informes de problemas únicos](#how-to-use-reports-console-unique-problems).
   + La sección **Dispositivos** muestra el número total de pruebas, según su resultado, para cada dispositivo.

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

     En este ejemplo, hay varios dispositivos. En la primera entrada de la tabla, el dispositivo Google Pixel 4 XL que ejecuta la versión 10 de Android informa de tres pruebas satisfactorias que tardaron 02:36 minutos en ejecutarse.

     Para ver los resultados por dispositivo, siga las instrucciones de [Visualización de informes de dispositivo](#how-to-use-reports-console-by-device).
   + La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución, agrupadas por dispositivo.
   + En la sección **Resultado del análisis**, puede descargar el resultado del análisis.

### Visualización de informes de problemas únicos
<a name="how-to-use-reports-console-unique-problems"></a>

1. En **Problemas únicos**, seleccione el problema que desee ver. 

1. Elija el dispositivo. El informe muestra información sobre el problema.

   La sección **Video** muestra una grabación en video descargable de la prueba.

   La sección **Resultado** muestra el resultado de la prueba. El estado se representa como un icono de resultado. Para obtener más información, consulte [Estados de una prueba individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).

   La sección **Registros** muestra toda la información que Device Farm ha registrado durante la prueba. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).

   La pestaña **Archivos** muestra una lista de todos los archivos asociados de la prueba (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.

   La pestaña **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la prueba.

### Visualización de informes de dispositivo
<a name="how-to-use-reports-console-by-device"></a>
+ En la sección **Dispositivos**, seleccione el dispositivo.

  La sección **Video** muestra una grabación en video descargable de la prueba.

  La sección **Conjuntos** muestra una tabla que contiene información sobre los conjuntos para el dispositivo. 

  En esta tabla, la columna **Resultados de las pruebas** resume el número de pruebas según su resultado para cada uno de los conjuntos de pruebas que se ejecutan en el dispositivo. Estos datos también tienen un componente gráfico. Para obtener más información, consulte [Estados de varias pruebas](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).

  Para ver los resultados por conjunto, siga las instrucciones de [Visualización de informes de conjuntos de pruebas](#how-to-use-reports-console-by-suite).

  La sección **Registros** muestra toda la información que Device Farm ha registrado para el dispositivo durante la ejecución. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).

  La sección **Archivos** muestra una lista de conjuntos para el dispositivo y todos los archivos asociados (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.

  La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución para el dispositivo, agrupadas por conjunto.

### Visualización de informes de conjuntos de pruebas
<a name="how-to-use-reports-console-by-suite"></a>

1. En la sección **Dispositivos**, seleccione el dispositivo.

1. En la sección **Conjuntos**, seleccione el conjunto de la tabla.

   La sección **Video** muestra una grabación en video descargable de la prueba.

   La sección **Pruebas** muestra una tabla que contiene información sobre las pruebas del conjunto.

   En la tabla, la columna **Resultados de las pruebas** muestra el resultado. Estos datos también tienen un componente gráfico. Para obtener más información, consulte [Estados de varias pruebas](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).

   Para ver los resultados por prueba, siga las instrucciones de [Consultar los informes de pruebas](#how-to-use-reports-console-by-test).

   La sección **Registros** muestra toda la información que Device Farm ha registrado durante la ejecución para el conjunto. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).

   La sección **Archivos** muestra una lista de pruebas para el conjunto y todos los archivos asociados (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.

   La sección **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la ejecución para el conjunto, agrupadas por prueba.

### Consultar los informes de pruebas
<a name="how-to-use-reports-console-by-test"></a>

1. En la sección **Dispositivos**, seleccione el dispositivo.

1. En la sección **Conjuntos**, seleccione el conjunto.

1. En la sección **Pruebas**, seleccione la prueba.

1. La sección **Video** muestra una grabación en video descargable de la prueba.

   La sección **Resultado** muestra el resultado de la prueba. El estado se representa como un icono de resultado. Para obtener más información, consulte [Estados de una prueba individual](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).

   La sección **Registros** muestra toda la información que Device Farm ha registrado durante la prueba. Para ver esta información, siga las instrucciones de [Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe](#how-to-use-reports-console-log).

   La pestaña **Archivos** muestra una lista de todos los archivos asociados de la prueba (como archivos de registro) que puede descargar. Para descargar un archivo, elija el enlace del archivo en la lista.

   La pestaña **Capturas de pantalla** muestra una lista de todas las capturas de pantalla que Device Farm ha capturado durante la prueba.

### Visualización de la información de registro para un problema, dispositivo, conjunto o prueba en un informe
<a name="how-to-use-reports-console-log"></a>

En la sección de **Registros**, se muestra lo siguiente:
+ **Fuente** representa la fuente de una entrada de registro. Los valores posibles son:
  + **Herramienta** representa una entrada de registro creada por Device Farm. Estas entradas de log suelen crearse durante los eventos de comienzo y parada.
  + **Dispositivo** representa una entrada de registro creada por el dispositivo. Para Android, estas entradas de log son compatibles con logcat. Para iOS, estas entradas de registro son compatibles con syslog.
  + **Prueba** representa una entrada de registro creada por una prueba o su marco de pruebas.
+ **Tiempo** representa el tiempo transcurrido entre la primera entrada de registro y esta entrada de registro. La hora se expresa en *MM:SS.SSS* formato, donde *M* representa los minutos y *S* los segundos.
+ **PID** representa el identificador de proceso (PID) que creó la entrada de registro. Todas las entradas de registro creadas por una aplicación en un dispositivo tienen el mismo PID.
+ **Nivel** representa el nivel de registro para la entrada de registro. Por ejemplo, para `Logger.debug("This is a message!")`, el valor de **Nivel** que se registra es `Debug`. Estos son los valores posibles:
  + **Alerta**
  + **Critical**
  + **Debug**
  + **Emergencia**
  + **Error**
  + **Con errores**
  + **Con error**
  + **Información**
  + **Interno**
  + **Aviso**
  + **Passed**
  + **Skipped**
  + **Detenida**
  + **Detallado**
  + **Con advertencia**
  + **Advertencia**
+ **Etiqueta** representa los metadatos arbitrarios para la entrada de registro. Por ejemplo, logcat de Android puede usar esto para describir qué parte del sistema creó la entrada de log (por ejemplo, `ActivityManager`).
+ **Mensaje** representa el mensaje o los datos para la entrada de registro. Por ejemplo, para `Logger.debug("Hello, World!")`, el valor de **Mensaje** que se registra es `"Hello, World!"`.

Para mostrar solo una parte de la información:
+ Para mostrar todas las entradas de registro que coinciden con un valor para una columna específica, escriba el valor en la barra de búsqueda. Por ejemplo, para mostrar todas las entradas de registro cuyo valor de **Fuente** es `Harness`, escriba **Harness** en la barra de búsqueda.
+ Para quitar todos los caracteres de un cuadro de encabezado de columna, elija la **X** en ese cuadro de encabezado de la columna. Eliminar todos los caracteres de un cuadro de encabezado de columna es lo mismo que escribir **\$1** en ese cuadro de encabezado de columna.

Para descargar toda la información de registro del dispositivo, incluyendo todos los conjuntos y las pruebas que se han ejecutado, seleccione **Descargar registros**.

# Estados de los resultados de las pruebas de Device Farm
<a name="how-to-use-reports-displaying-results"></a>

La consola de Device Farm muestra iconos que le ayudan a evaluar rápidamente el estado de la ejecución de prueba completada. Para obtener más información sobre las pruebas en Device Farm, consulte [Informes en AWS Device FarmInformes](reports.md).

**Topics**
+ [Estados de una prueba individual](#how-to-use-reports-displaying-results-individual)
+ [Estados de varias pruebas](#how-to-use-reports-displaying-results-summary)

## Estados de una prueba individual
<a name="how-to-use-reports-displaying-results-individual"></a>

Para los informes que describen una prueba individual, Device Farm muestra un icono que representa el estado del resultado de la prueba:


| Description (Descripción) | Icono | 
| --- | --- | 
| La prueba se ha completado correctamente. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-success.png) | 
| La prueba no se ha completado correctamente. | ![\[The test failed.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-failure.png) | 
| Device Farm se saltó la prueba. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-skipped.png) | 
| La prueba se ha parado. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-stopped.png) | 
| Device Farm ha devuelto una advertencia. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-warning.png) | 
| Device Farm ha devuelto un error. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/df-run-error.png) | 

## Estados de varias pruebas
<a name="how-to-use-reports-displaying-results-summary"></a>

Si selecciona una ejecución finalizada, Device Farm mostrará un gráfico resumido que muestra el porcentaje de pruebas en varios estados.

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

Por ejemplo, este gráfico de resultados de ejecución de prueba muestra 4 pruebas paradas, 1 prueba fallida y 10 pruebas completadas correctamente.

Los gráficos siempre están etiquetados y codificados por colores.

# Descarga de artefactos en Device Farm
<a name="artifacts"></a>

Device Farm recopila artefactos como informes, archivos de registro e imágenes, de cada prueba de la ejecución.

Puede descargar los artefactos creados durante la ejecución de prueba:

**Archivos**  
Archivos generados durante la ejecución de prueba, como los informes de Device Farm. Para obtener más información, consulte [Visualización de informes de pruebas en Device Farm](how-to-use-reports.md).

**Registros**  
Salida de cada prueba de la ejecución de prueba.

**Capturas de pantalla**  
Imágenes de las pantallas registradas para cada prueba de la ejecución de prueba.

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


## Descarga de artefactos (consola)
<a name="artifacts-console"></a>

1. En la página de la ejecución de prueba, seleccione un dispositivo móvil en **Dispositivos**.

1. Para descargar un archivo, selecciónelo en **Archivos**.

1. Para descargar los registros de la ejecución de prueba, en **Registros**, seleccione **Descargar registros**.

1. Para descargar una captura de pantalla, seleccione una captura de pantalla de **Capturas de pantalla**.

Para obtener más información acerca de cómo descargar artefactos en un entorno de pruebas personalizado, consulte [Descarga de artefactos en un entorno de prueba personalizado](using-artifacts-custom.md).

## Descarga de artefactos (AWS CLI)
<a name="artifacts-cli"></a>

Puede utilizarla AWS CLI para enumerar los artefactos de las pruebas realizadas.

**Topics**
+ [Paso 1: Obtener los nombres de recurso de Amazon (ARN)](#artifacts-cli-step1)
+ [Paso 2: Crear una lista con los artefactos](#artifacts-cli-step2)
+ [Paso 3: Descargar los artefactos](#artifacts-cli-step3)

### Paso 1: Obtener los nombres de recurso de Amazon (ARN)
<a name="artifacts-cli-step1"></a>

Los artefactos se pueden enumerar por ejecución, trabajo, conjunto de pruebas o prueba. Necesita el ARN correspondiente. Esta tabla muestra el ARN de entrada para cada uno de los comandos de la AWS CLI lista:


| AWS CLI Comando List | ARN requerido | 
| --- | --- | 
| list-projects | Este comando devuelve todos los proyectos y no requiere un ARN. | 
| list-runs | project | 
| list-jobs | run | 
| list-suites | job | 
| list-tests | suite | 

Por ejemplo, para encontrar un ARN de prueba, ejecute **list-tests** con el ARN del conjunto de pruebas como parámetro de entrada.

Ejemplo:

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

La respuesta incluye un ARN de prueba para cada prueba del conjunto de pruebas.

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

### Paso 2: Crear una lista con los artefactos
<a name="artifacts-cli-step2"></a>

El comando AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) devuelve una lista de artefactos, como archivos, capturas de pantalla y registros. Cada artefacto tiene una URL que le permite descargar el archivo.
+ Llame a **list-artifacts** especificando el ARN de una ejecución, un trabajo, un conjunto de pruebas o una prueba. Especifique un tipo de archivo, registro o captura de pantalla.

  En este ejemplo, se devuelve una URL de descarga para cada artefacto disponible de una prueba individual:

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

  La respuesta contiene una URL de descarga para cada artefacto.

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

### Paso 3: Descargar los artefactos
<a name="artifacts-cli-step3"></a>
+ Descargue el artefacto mediante la dirección URL del paso anterior. En este ejemplo se utiliza **curl** para descargar un archivo de salida de Android Appium Java:

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

## Descarga de artefactos (API)
<a name="artifacts-api"></a>

El [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)método de la API Device Farm devuelve una lista de artefactos, como archivos, capturas de pantalla y registros. Cada artefacto tiene una URL que le permite descargar el archivo.

# Descarga de artefactos en un entorno de prueba personalizado
<a name="using-artifacts-custom"></a>

En un entorno de pruebas personalizado, Device Farm recopila artefactos como informes personalizados, archivos de registro e imágenes. Estos artefactos de prueba están disponibles para cada dispositivo de la ejecución de prueba.

Puede descargar estos artefactos creados durante la ejecución de prueba:

**Salida de la especificación de prueba**  
La salida de la ejecución de los comandos en el archivo YAML de la especificación de prueba.

**Artefactos de clientes**  
Archivo comprimido que contiene los artefactos de la ejecución de prueba. Se configura en la sección **artifacts (artefactos)** del archivo YAML de la especificación de prueba.

**Script del shell de la especificación de prueba**  
Archivo de script del shell intermedio creado a partir del archivo YAML. Dado que se utiliza en la ejecución de prueba, el script del shell se puede usar para depurar el archivo YAML.

**Archivo de la especificación de prueba**  
Archivo YAML utilizado en la ejecución de prueba.

Para obtener más información, consulte [Descarga de artefactos en Device Farm](artifacts.md).

![\[Jerarquía de operaciones de Device Farm en un entorno de pruebas personalizado\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/hierarchy.png)
