

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.

# WorkSpaces Informes de uso de aplicaciones
<a name="configure-usage-reports"></a>

Puedes suscribirte a los informes de uso de Amazon WorkSpaces Applications para recibir informes detallados sobre el uso que hacen tus usuarios del servicio. Cada día se exportan dos archivos .csv a un bucket de Amazon Simple Storage Service (Amazon S3) de su cuenta. 

**nota**  
Para habilitar los informes de uso de WorkSpaces las aplicaciones, debe usar una imagen que utilice una versión del agente de WorkSpaces aplicaciones publicada el 7 de mayo de 2019 o después.

**Topics**
+ [Habilite los informes WorkSpaces de uso de las aplicaciones](enable-usage-reports.md)
+ [WorkSpaces Campos de informes de uso de aplicaciones](usage-reports-fields.md)
+ [Cree informes personalizados y analice los datos de uso de WorkSpaces las aplicaciones](configure-custom-reports-analyze-usage-data.md)

# Habilite los informes WorkSpaces de uso de las aplicaciones
<a name="enable-usage-reports"></a>

Para recibir informes de uso, suscríbase a ellos mediante la consola de WorkSpaces aplicaciones, la operación AWS Command Line Interface (AWS CLI) o la `CreateUsageReportSubscription` API. Debe habilitar los informes de uso por separado para cada AWS región de la que desee recibir datos de uso.

**nota**  
Puede iniciar o detener la suscripción a los informes de uso en cualquier momento. No se aplica ningún cargo por suscribirse a los informes de uso, pero pueden aplicarse cargos de Amazon S3 estándar por los informes que se almacenan en su bucket de S3. Para obtener más información, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).

Para suscribirse a los informes de uso de WorkSpaces las aplicaciones mediante la consola de WorkSpaces aplicaciones, lleve a cabo los siguientes pasos. 

1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).

1. Elija la AWS región para la que desee habilitar los informes de uso.

1. En el panel de navegación, elija **Usage Reports (Informes de uso)**.

1. Elija **Habilitada** y, a continuación, elija **Aplicar**.

Si habilitó los scripts de sesión en la instancia y el registro de Amazon S3 para la configuración de los scripts de sesión, WorkSpaces Applications creó un bucket de S3 para almacenar el resultado del script. El bucket es único para su cuenta y región. Cuando habilita los informes de uso en este caso, WorkSpaces Applications utiliza el mismo depósito para almacenar sus informes de uso. Si aún no ha activado los scripts de sesión en la instancia, al habilitar los informes de uso, WorkSpaces Applications crea un nuevo depósito de S3 en la siguiente ubicación:

```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```

***region-code***  
El código de AWS región de la región en la que están habilitados los informes de uso.

***account-id-without-hyphens***  
Su identificador de cuenta de Amazon Web Services. El ID aleatorio garantiza que no haya ningún conflicto con otros buckets en la misma región. La primera parte del nombre del bucket, `appstream-logs`, no cambia entre cuentas o regiones.

Por ejemplo, si habilita los informes de uso en la región EE.UU. Oeste (Oregón) (us-west-2) con el número de cuenta 123456789012, WorkSpaces Applications crea un bucket de Amazon S3 en su cuenta de esa región similar al nombre que se muestra en el siguiente ejemplo: 

```
appstream-logs-us-west-2-1234567890123-abcdefg
```

Este bucket solo lo puede eliminar un administrador con permisos suficientes.

**Topics**
+ [WorkSpaces Aplicaciones, sesiones e informes](usage-report-types-sessions-reports.md)
+ [WorkSpaces Aplicaciones: informes de aplicaciones](usage-report-types-applications-reports.md)

# WorkSpaces Aplicaciones, sesiones e informes
<a name="usage-report-types-sessions-reports"></a>

Por cada día que los usuarios inicien al menos una sesión de streaming en su cuenta de Amazon Web Services, WorkSpaces Applications exporta un informe de sesiones a su bucket de Amazon S3. El informe, denominado **daily-session-report- [YYYY] - [MM] - [DD] .csv**, se almacena en una estructura de carpetas anidadas en su cuenta de Amazon S3, utilizando la siguiente ruta de carpetas:

[bucket\$1name]/= [DD]/sessions/schedule=DAILY/year=[YYYY]/month=[MM]/day

Esta estructura de anidación facilita la partición si elige consultar sus informes mediante Amazon Athena. Athena s un servicio de consultas interactivas sin servidor que puede utilizar para analizar los datos almacenados en sus buckets de S3 con SQL estándar. Para obtener más información, consulte [Cree informes personalizados y analice los datos de uso de WorkSpaces las aplicaciones](configure-custom-reports-analyze-usage-data.md).

Cada sesión de usuario se describe en un único registro en el informe de sesiones. Los informes de sesiones se generan diariamente de acuerdo con la hora UTC dentro de las 24 horas siguientes al final del día que es objeto del informe. Si una sesión abarca más de un día, el registro de sesión aparece en el informe de sesiones correspondiente al día en el que finaliza la sesión. Para obtener más información acerca de los datos incluidos en los informes de sesiones, consulte [Campos de los informes de sesiones](usage-reports-fields-sessions-reports.md). 

# WorkSpaces Aplicaciones: informes de aplicaciones
<a name="usage-report-types-applications-reports"></a>

Por cada día que los usuarios lancen al menos una aplicación durante sus sesiones de streaming, WorkSpaces Applications exporta un informe de aplicaciones a su bucket de Amazon S3. El informe, denominado **daily-app-report- [YYYY] - [MM] - [DD] .csv**, se almacena en una estructura de carpetas anidadas en su cuenta de Amazon S3, utilizando la siguiente ruta de carpetas:

[bucket\$1name]/= [DD]/applications/schedule=DAILY/year=[YYYY]/month=[MM]/day

Esta estructura de anidación facilita la partición si elige consultar sus informes mediante Amazon Athena. Athena s un servicio de consultas interactivas sin servidor que puede utilizar para analizar los datos almacenados en sus buckets de S3 con SQL estándar. Para obtener más información, consulte [Cree informes personalizados y analice los datos de uso de WorkSpaces las aplicaciones](configure-custom-reports-analyze-usage-data.md).

Cada lanzamiento de aplicación se describe en un único registro en un informe de aplicaciones. Por ejemplo, si un usuario lanza cinco aplicaciones distintas durante una sesión, aparecen cinco registros distintos en el informe de aplicaciones correspondiente. Una aplicación se registra como lanzada si se produce alguno de los siguientes eventos:
+ La aplicación se lanza directamente cuando se inicia la sesión, porque el ID de la aplicación está incluido en la URL de streaming o el estado de retransmisión.
+ Un usuario elige la aplicación del catálogo de aplicaciones al lanzar una nueva sesión de streaming.
+ Un usuario elige la aplicación del catálogo de aplicaciones durante una sesión de streaming.

El informe de aplicaciones no incluye las aplicaciones que se lanzan de otras formas. Por ejemplo, si proporciona a los usuarios acceso al Explorador de Windows o al menú **Inicio** del escritorio de Windows y los usuarios utilizan esas herramientas para iniciar aplicaciones directamente, o si otro programa o script inicia una aplicación, los inicios de esas aplicaciones no se incluyen en el informe de aplicaciones. PowerShell

Los informes de aplicaciones se generan diariamente de acuerdo con la hora UTC dentro de las 24 horas siguientes al final del día que es objeto del informe. Si una sesión abarca más de un día, las aplicaciones lanzadas durante la sesión se reflejan en el informe de aplicaciones correspondiente al día en que finaliza la sesión. Para obtener información acerca de los datos incluidos en los informes de aplicaciones, consulte [Campos de los informes de aplicaciones](usage-reports-fields-applications-reports.md). 

# WorkSpaces Campos de informes de uso de aplicaciones
<a name="usage-reports-fields"></a>

En este tema se proporciona información sobre los campos incluidos en los informes de uso de WorkSpaces las aplicaciones.

**Topics**
+ [Campos de los informes de sesiones](usage-reports-fields-sessions-reports.md)
+ [Campos de los informes de aplicaciones](usage-reports-fields-applications-reports.md)

# Campos de los informes de sesiones
<a name="usage-reports-fields-sessions-reports"></a>

En la siguiente tabla se describen los campos incluidos en los informes de WorkSpaces las sesiones de Aplicaciones.


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
| user\$1session\$1id | El identificador único (ID) de la sesión. | 
| aws\$1account\$1id | El ID de la cuenta de Amazon Web Services. | 
| region | La AWS región. | 
| session\$1start\$1time |  La fecha y la hora de inicio de la sesión. Debe especificarse en el formato ISO 8601, como UTC.  | 
| session\$1end\$1time |  La fecha y hora en que finalizó la sesión. Debe especificarse en el formato ISO 8601, como UTC.  | 
| session\$1duration\$1in\$1seconds | La duración de la sesión en segundos. | 
| user\$1id | El ID único del usuario dentro del tipo de autenticación. | 
| user\$1arn | El nombre de recurso de Amazon (ARN) del usuario. | 
| authentication\$1type |  El método utilizado para autenticar al usuario. Los valores posibles son: `CUSTOM` \$1 `SAML` \$1 `USERPOOL`  | 
| authentication\$1type\$1user\$1id | La concatenación del ID de usuario y el tipo de autenticación, que identifica de forma inequívoca al usuario con el fin de evaluar las tarifas del usuario. Para obtener más información, consulte los [precios de WorkSpaces las aplicaciones](https://aws.amazon.com/appstream2/pricing/). | 
| fleet\$1name | El nombre de la flota asociada a la sesión. | 
| stack\$1name | El nombre de la pila asociada a la sesión. | 
| instance\$1type | El tipo de instancia de WorkSpaces Applications utilizado para la sesión. Para ver una lista de los tipos de instancias, consulta los [precios de WorkSpaces las aplicaciones](https://aws.amazon.com/appstream2/pricing/). | 
| eni\$1private\$1ip\$1address | La dirección IP de la interface de red elástica utilizada por la instancia de WorkSpaces Applications para las comunicaciones de red. | 
| connected\$1at\$1least\$1once |  Indica si el usuario se ha conectado a la sesión al menos una vez. Los valores posibles son: `true` \$1 `false`  | 
| client\$1ip\$1addresses | Las direcciones IP asociadas con el dispositivo o dispositivos del usuario utilizados para conectarse a la sesión. Si el usuario se ha conectado y, a continuación, se ha desconectado de la sesión más de una vez, se almacenan las 10 últimas direcciones IP distintas, separadas por el carácter de punto y coma. | 
| google\$1drive\$1enabled |  Indica si se ha habilitado Google Drive como una opción de almacenamiento persistente para la sesión. Para obtener más información, consulte [Habilite y administre Google Drive para los usuarios de sus aplicaciones WorkSpaces](google-drive.md).  Los valores posibles son: `true` \$1 `false`  | 
| one\$1drive\$1enabled |  Indica si OneDrive se habilitó como opción de almacenamiento persistente para la sesión. Para obtener más información, consulte [Habilite y administre Google Drive para los usuarios de sus aplicaciones WorkSpaces](google-drive.md).  Los valores posibles son: `true` \$1 `false`  | 
| home\$1folders\$1storage\$1location | El bucket de Amazon S3 utilizado para los archivos que se almacenan en las carpetas de inicio. | 
| user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device |  Indica si el usuario pudo copiar datos del dispositivo local en la sesión de streaming mediante el portapapeles durante la sesión. Los valores posibles son: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device |  Indica si el usuario pudo copiar datos de la sesión de streaming en el dispositivo local mediante el portapapeles durante la sesión. Los valores posibles son: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1file\$1upload |  Indica si el usuario pudo cargar archivos desde el dispositivo local a la sesión de streaming durante la sesión. Los valores posibles son: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1file\$1download |  Indica si el usuario pudo descargar archivos desde la sesión de streaming al dispositivo local durante la sesión. Los valores posibles son: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1printing\$1to\$1local\$1device |  Indica si el usuario pudo imprimir archivos desde la sesión de streaming en el dispositivo local durante la sesión. Los valores posibles son: `ENABLED` \$1 `DISABLED`  | 
| application\$1settings\$1enabled |  Indica si se ha habilitado la persistencia de la configuración de la aplicación para la sesión. Los valores posibles son: `true` \$1 `false`  | 
| domain\$1joined |  Indica si la instancia de streaming de WorkSpaces Applications se unió a un dominio de Active Directory al iniciar la sesión. Para obtener más información, consulte [Uso de Active Directory con WorkSpaces aplicaciones](active-directory.md).  Los valores posibles son: `Y` \$1 `N`  | 
| max\$1session\$1duration | La duración máxima permitida de la sesión, en segundos. | 
| session\$1type |  El tipo de sesión. Los valores posibles son: `ALWAYS_ON` \$1 `ON_DEMAND`  | 
| stream\$1view |  La vista de transmisión. Los valores posibles son: `APPLICATION` \$1 `DESKTOP`  | 
| streaming\$1experience\$1settings\$1protocol |  El protocolo con el que la sesión realizó el streaming. Los valores posibles son: `UDP` \$1 `TCP`  | 
| instance\$1id | El ID de instancia asociado a la sesión del usuario. | 
| is\$1multisession |  Indica si la sesión pertenece a una flota multisesión. Los valores posibles son: `true` \$1 `false`  | 

# Campos de los informes de aplicaciones
<a name="usage-reports-fields-applications-reports"></a>

En la siguiente tabla se describen los campos incluidos en los informes de WorkSpaces aplicaciones y aplicaciones.


| Nombre del campo | Description (Descripción) | 
| --- | --- | 
| user\$1session\$1id | El identificador único (ID) de la sesión. | 
| application\$1name | El nombre de la aplicación, tal y como se especifica en Image Assistant. Este valor se proporciona cuando un usuario inicia una aplicación a través de la interfaz de WorkSpaces aplicaciones.  | 
| horario | La frecuencia con la que se generan los informes. Valor posible: DAILY | 
| year | El año del informe.  | 
| month | El mes del informe.  | 
| day | El día del informe.  | 

# Cree informes personalizados y analice los datos de uso de WorkSpaces las aplicaciones
<a name="configure-custom-reports-analyze-usage-data"></a>

Amazon Athena es un servicio de consultas interactivas sin servidor que puede utilizar para analizar los datos almacenados en sus buckets de S3 con consultas SQL estándar. Puede utilizar Athena para agregar sus informes de uso o generar otros tipos de informes personalizados. 

**Topics**
+ [Crea un AWS Glue rastreador](configure-custom-reports-create-crawler.md)
+ [Cree un catálogo de datos mediante el rastreador AWS Glue](configure-custom-reports-create-data-catalog.md)
+ [Creación y ejecución de consultas de Athena](configure-custom-reports-create-run-athena-queries.md)
+ [Uso de las consultas de Athena](configure-custom-reports-example-sql-queries.md)

# Crea un AWS Glue rastreador
<a name="configure-custom-reports-create-crawler"></a>

AWS Glue es un servicio de extracción, transformación y carga (ETL) totalmente gestionado que le permite crear una base de datos a partir de sus datos de Amazon S3 y consultarla mediante Athena. Esta base de datos también se denomina catálogo de AWS Glue datos. Un AWS Glue rastreador puede detectar automáticamente el esquema de sus datos de Amazon S3 y crear la base de datos y las tablas correspondientes. WorkSpaces Applications proporciona una CloudFormation plantilla que puede utilizar para crear los AWS Glue recursos necesarios. 

**importante**  
Al completar los pasos del siguiente procedimiento, se crea un AWS Glue rastreador. Sin embargo, estos pasos no inician el rastreador. Para iniciar el rastreador, debe realizar los pasos que se indican en el siguiente procedimiento. Para obtener más información sobre AWS Glue los rastreadores, consulte [Definición](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) de rastreadores.

**Para crear un rastreador AWS Glue**

1. Abre la consola WorkSpaces de aplicaciones en [https://console.aws.amazon.com/appstream2/casa.](https://console.aws.amazon.com/appstream2/home)

1. Elija la AWS región para la que se ha suscrito a los informes de uso.

1. En el panel de navegación, seleccione **Usage Reports (Informes de uso)** y compruebe que el registro de informes de uso está habilitado.

1. En la pestaña **Detalles del informe**, en el párrafo situado junto a **Analytics**, selecciona el enlace de la **CloudFormationplantilla**.

   Al seleccionar el enlace, se abre la CloudFormation consola, donde puede revisar los parámetros de la CloudFormation pila especificada por la plantilla antes de ejecutarla. La plantilla, cuando se ejecuta, crea un AWS Glue rastreador y varios ejemplos de consultas de Athena.

1. En la página **Especificar detalles**, junto a **ScheduleExpression**, mantenga el valor predeterminado o especifique un valor de expresión cron diferente para la frecuencia con la que desee ejecutar el rastreador. No cambie ningún otro valor predeterminado. Cuando haya terminado, elija **Siguiente**.

   De forma predeterminada, el rastreador está programado para ejecutarse una vez al día, pero puede configurarlo para que se ejecute cada semana, cada mes o con otra frecuencia. Para obtener información acerca de la sintaxis cron, consulte [Expresiones Cron](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions).

1. En la página **Options (Opciones)**, mantenga todos los valores predeterminados y seleccione **Next(Siguiente)**.

1. **En la página de **revisión**, seleccione la casilla de verificación situada junto a «Reconozco que CloudFormation podría crear recursos de IAM con nombres personalizados» y, a continuación, seleccione Crear.**

   Debe tener suficientes AWS Glue permisos AWS Identity and Access Management (de IAM) para crear y ejecutar la CloudFormation pila. Si no tiene los permisos necesarios, pida al administrador de su cuenta de Amazon Web Services que realice estos pasos en su cuenta o que le conceda los siguientes permisos.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "athena:CreateNamedQuery",
                   "athena:BatchGetNamedQuery",
                   "athena:GetNamedQuery",
                   "athena:StartQueryExecution",
                   "athena:GetQueryResults",
                   "athena:GetQueryExecution",
                   "athena:ListNamedQueries",
                   "cloudformation:DescribeStacks",
                   "cloudformation:GetStackPolicy",
                   "cloudformation:DescribeStackEvents",
                   "cloudformation:CreateStack",
                   "cloudformation:GetTemplate",
                   "cloudformation:ListChangeSets",
                   "cloudformation:ListStackResources",
                   "iam:GetRole",
                   "iam:CreateRole",
                   "iam:GetRolePolicy",
                   "s3:GetBucketLocation",
                   "s3:ListBucketMultipartUploads",
                   "s3:ListBucket",
                   "s3:ListMultipartUploadParts",
                   "s3:PutObject",
                   "s3:GetObject",
                   "s3:AbortMultipartUpload"
               ],
               "Resource": [
                   "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*",
                   "arn:aws:cloudformation:*:*:stack/AppStreamUsageReports/*",
                   "arn:aws:athena:*:*:workgroup/primary",
                   "arn:aws:s3:::aws-athena-query-results-*"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "iam:AttachRolePolicy",
                   "iam:PutRolePolicy",
                   "s3:GetObject",
                   "s3:ListBucket"
               ],
               "Resource": [
                   "arn:aws:s3:::appstream-logs-*",
                   "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "iam:PassRole"
               ],
               "Resource": [
                   "arn:aws:iam::*:role/AppStreamUsageReports-AppStreamUsageReportGlueRole*"
               ],
               "Condition": {
                   "StringEquals": {
                       "iam:PassedToService": "glue.amazonaws.com"
                   }
               }
           },
           {
               "Effect": "Allow",
               "Action": [
                   "cloudformation:GetTemplateSummary",
                   "glue:GetResourcePolicy",
                   "glue:GetCrawlers",
                   "glue:BatchGetCrawlers",
                   "glue:GetClassifiers",
                   "glue:CreateClassifier",
                   "glue:ListCrawlers",
                   "glue:GetTags",
                   "glue:GetCrawlerMetrics",
                   "glue:GetClassifier",
                   "tag:GetResources"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": "athena:RunQuery",
               "Resource": "arn:aws:athena:*:*:workgroup/primary"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "glue:GetTables",
                   "glue:GetPartitions",
                   "glue:GetTable"
               ],
               "Resource": [
                   "arn:aws:glue:*:*:table/appstream-usage/*",
                   "arn:aws:glue:*:*:database/appstream-usage",
                   "arn:aws:glue:*:*:catalog"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "glue:GetDatabase",
                   "glue:CreateDatabase",
                   "glue:GetDatabases"
               ],
               "Resource": [
                   "arn:aws:glue:*:*:database/appstream-usage",
                   "arn:aws:glue:*:*:catalog"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "glue:GetCrawler",
                   "glue:StartCrawler",
                   "glue:CreateCrawler"
               ],
               "Resource": "arn:aws:glue:*:*:crawler/appstream-usage*"
           },
           {
               "Effect": "Allow",
               "Action": "glue:GetCatalogImportStatus",
               "Resource": "arn:aws:glue:*:*:catalog"
           }
       ]
   }
   ```

------

# Cree un catálogo de datos mediante el rastreador AWS Glue
<a name="configure-custom-reports-create-data-catalog"></a>

Cuando se ejecuta, el AWS Glue rastreador crea un catálogo de datos y un esquema que se asignan a la estructura de los informes de las sesiones y las aplicaciones. Cada vez que se almacene un informe nuevo en su bucket de Amazon S3, debe ejecutar el rastreador para actualizar su catálogo de AWS Glue datos con los datos del nuevo informe. 

**nota**  
Es posible que se apliquen cargos por el funcionamiento de su AWS Glue rastreador. Para obtener más información, consulte [AWS Glue Precios](https://aws.amazon.com/glue/pricing/).

1. Abre la AWS Glue consola en. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/)

1. Elija la AWS región para la que se ha suscrito a los informes de uso.

1. Seleccione la casilla de verificación situada junto al rastreador denominado y **appstream-usage-sessions-crawler**, a continuación, elija **Ejecutar** rastreador. Repita este paso para el rastreador denominado. **appstream-usage-apps-crawler** 

   Al realizar estos pasos, se ejecutan los rastreadores y se programa para que se ejecuten automáticamente de acuerdo con la programación especificada en la CloudFormation pila. 

1. Cuando ambos rastreadores terminen de ejecutarse, en el panel de navegación, elija **Databases (Bases de datos)**. Se muestra una base de datos denominada **appstream-usage**, que representa sus informes de uso. Esta base de datos es un catálogo AWS Glue de datos que se creó cuando se ejecutó **appstream-usage-sessions-crawler**y **appstream-usage-apps-crawler**se ejecutó.

1. Para ver las tablas de la base de datos, elija **appstream-usage**, **Tables (Tablas)**. Se muestran dos tablas, **applications (aplicaciones)** y **sessions (sesiones)**, que representan los informes de uso de aplicaciones y sesiones, respectivamente. Elija una de estas tablas para ver su esquema.

   Ahora puede consultar estas tablas en Athena con SQL.

# Creación y ejecución de consultas de Athena
<a name="configure-custom-reports-create-run-athena-queries"></a>

Para consultar sus informes de uso mediante Athena, siga los pasos que se describen a continuación.
**nota**  
Pueden aplicarse cargos por las consultas de Athena que ejecute. Para obtener más información, consulte [Precios de Amazon Athena](https://aws.amazon.com/athena/pricing/).

1. Abra la consola Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. En **Database (Base de datos)**, elija **appstream-usage**.

1. En el panel de consultas, escriba una consulta SQL y, a continuación, elija **Run query (Ejecutar consulta)**.

# Uso de las consultas de Athena
<a name="configure-custom-reports-example-sql-queries"></a>

En esta sección se indican las consultas SQL que puede ejecutar en Athena para analizar los datos de los informes de uso en su bucket de Amazon S3.

Para crear un informe consolidado de todas las sesiones en un mes determinado, ejecute la siguiente consulta:

```
SELECT *
FROM "appstream-usage"."sessions"
WHERE year='four-digit-year'
AND month='two-digit-month'
```

También puede realizar operaciones de combinación entre las tablas **applications**y **sessions** en su consulta. Por ejemplo, para ver los usuarios distintos que lanzaron cada aplicación en un mes determinado, ejecute la siguiente consulta:

```
SELECT DISTINCT apps.application_name, sessions.user_id
FROM "appstream-usage"."applications" apps
   INNER JOIN "appstream-usage"."sessions" sessions ON (apps.user_session_id = sessions.user_session_id AND sessions.year='four-digit-year' AND sessions.month='two-digit-month')
WHERE apps.year='four-digit-year'
  AND apps.month='two-digit-month'
ORDER BY 1, 2
```

Los resultados de las consultas de Athena se almacenan como archivos .csv en un bucket de Amazon S3 de su cuenta que se denomina `aws-athena-query-results-account-id-without-hyphens-region-code`. Para facilitar la localización de los resultados de las consultas, elija **Save as (Guardar como)** y proporcione un nombre para su consulta antes de ejecutarla. También puede elegir el icono de descarga en el panel **Resultados de Athena** para descargar los resultados de la consulta como un archivo.csv.

Para mejorar el rendimiento y reducir los costos, Athena utiliza particiones para reducir la cantidad de datos analizados en las consultas. Para obtener más información, consulte la sección sobre [partición de datos](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). Los informes de uso se particionan en sus buckets de Amazon S3 por año, mes y día. Puede restringir sus consultas a determinadas particiones de intervalo de fechas mediante los campos **year (año)**,**month( mes)** y **day (día)** como condiciones en sus consultas. Por ejemplo, la siguiente consulta solo utiliza los informes de sesiones de la semana del 19 de mayo de 2019.

```
SELECT SUBSTRING(session_start_time, 1, 10) AS report_date, 
    COUNT(DISTINCT user_session_id) AS num_sessions
FROM "appstream-usage"."sessions"
WHERE year='2019'
   AND month='05'
   AND day BETWEEN '19' and '25'
GROUP BY 1
ORDER BY 1
```

Sin embargo, la siguiente consulta produce resultados idénticos, pero como no está restringida a ninguna partición, utiliza todos los informes de sesiones almacenados en su bucket de Amazon S3.

```
SELECT SUBSTRING(session_start_time, 1, 10) AS report_date, 
    COUNT(DISTINCT user_session_id) AS num_sessions
FROM "appstream-usage"."sessions"
WHERE session_end_time BETWEEN '2019-05-19' AND '2019-05-26'
GROUP BY 1
ORDER BY 1
```

Si una sesión abarca más de un día, los registros de sesión y aplicación aparecen en los informes de sesiones y aplicaciones, respectivamente, correspondientes al día en que finalizó la sesión. Por este motivo, si necesita encontrar registros relacionados con todas las sesiones que han estado activas durante un determinado intervalo de fechas, considere la posibilidad de ampliar el conjunto de particiones de su consulta hasta la duración de sesión máxima que haya configurado para las flotas.

Por ejemplo, para ver todas las sesiones que han estado activas para una determinada flota durante un mes natural, donde la flota tenía una duración de sesión máxima de 100 horas, ejecute la siguiente consulta para ampliar el conjunto de particiones a cinco días.

```
SELECT *
FROM "appstream-usage"."sessions"
WHERE fleet_name = 'fleet_name'
   AND session_start_time BETWEEN '2019-05-01' AND '2019-06-01'
   AND year='2019'
   AND (month='05' OR (month='06' AND day<='05'))
ORDER BY session_start_time
```

La CloudFormation plantilla que creó los AWS Glue rastreadores también creó y guardó varios ejemplos de consultas en tu cuenta de Athena que puedes usar para analizar tus datos de uso. Estas consultas de ejemplo son las siguientes:
+ Informe de sesiones mensuales acumuladas
+ Duración media de la sesión por pila
+ Número de sesiones al día
+ Horas de streaming totales por usuario
**nota**  
Las cargos por uso bajo demanda se redondean a la siguiente hora para cada sesión.
+ Usuarios distintos por aplicación

Para utilizar cualquiera de estas consultas, siga los pasos que se describen a continuación.

1. Abra la consola Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/).

1. Elija **Saved Queries (Consultas guardadas)**. Se deben mostrar las cinco consultas indicadas anteriormente en este procedimiento. El nombre de cada consulta comienza por "»AS2. Por ejemplo, "AS2\$1users\$1per\$1app\$1curr\$1mo».

1. Para ejecutar una consulta, seleccione el nombre de la consulta en lugar de la opción situada junto a su nombre.

1. El texto de la consulta aparece en el panel de consultas. Elija **Ejecutar consulta**.

[https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html](https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html)