Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # WorkSpaces Rapports d'utilisation des applications Vous pouvez vous abonner aux rapports d'utilisation d'Amazon WorkSpaces Applications pour recevoir des rapports détaillés sur la façon dont vos utilisateurs utilisent le service. Chaque jour, deux fichiers .csv sont exportés vers un compartiment Amazon Simple Storage Service (Amazon S3) de votre compte. **Note** Pour activer WorkSpaces les rapports d'utilisation des applications, vous devez utiliser une image qui utilise une version de l'agent d' WorkSpaces applications publiée le 7 mai 2019 ou après cette date. **Topics** + [Activer WorkSpaces les rapports d'utilisation des applications](enable-usage-reports.md) + [WorkSpaces Champs des rapports d'utilisation des applications](usage-reports-fields.md) + [Créez des rapports personnalisés et analysez les données d'utilisation des WorkSpaces applications](configure-custom-reports-analyze-usage-data.md) # Activer WorkSpaces les rapports d'utilisation des applications Pour recevoir des rapports d'utilisation, vous devez vous y abonner à l'aide de la console WorkSpaces Applications, de l'opération AWS Command Line Interface (AWS CLI) ou de l'`CreateUsageReportSubscription`API. Vous devez activer les rapports d'utilisation séparément pour chaque AWS région pour laquelle vous souhaitez recevoir des données d'utilisation. **Note** Vous pouvez démarrer ou arrêter votre abonnement aux rapports d'utilisation à tout moment. L’abonnement à des rapports d’utilisation n’entraîne aucun frais, mais les frais Amazon S3 standard peuvent s’appliquer aux rapports qui sont stockés dans votre compartiment S3. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/). Pour vous abonner aux rapports d'utilisation WorkSpaces des applications à l'aide de la console WorkSpaces Applications, effectuez les opérations suivantes. 1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home). 1. Choisissez la AWS région pour laquelle vous souhaitez activer les rapports d'utilisation. 1. Dans le volet de navigation, choisissez **Rapports d’utilisation**. 1. Choisissez **Activé**, puis **Appliquer**. Si vous avez activé les scripts de session sur instance et la journalisation Amazon S3 pour la configuration de vos scripts de session, WorkSpaces Applications a créé un compartiment S3 pour stocker le résultat du script. Ce compartiment est unique dans votre compte et votre région. Lorsque vous activez les rapports d'utilisation dans ce cas, WorkSpaces Applications utilise le même compartiment pour stocker vos rapports d'utilisation. Si vous n'avez pas encore activé les scripts de session sur instance, lorsque vous activez les rapports d'utilisation, WorkSpaces Applications crée un nouveau compartiment S3 à l'emplacement suivant : ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` ***region-code*** Code de AWS région pour la région dans laquelle les rapports d'utilisation sont activés. ***account-id-without-hyphens*** Identifiant de votre compte Amazon Web Services. L'identifiant aléatoire permet de garantir qu'aucun conflit ne sera déclenché avec les autres compartiments de la même région. La première partie du nom du compartiment, `appstream-logs`, ne change pas quel que soit le compte ou la région. Par exemple, si vous activez les rapports d'utilisation dans la région de l'ouest des États-Unis (Oregon) (us-west-2) sous le numéro de compte 123456789012 WorkSpaces , Applications crée un compartiment Amazon S3 au sein de votre compte dans cette région, similaire au nom indiqué dans l'exemple suivant : ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` Seul un administrateur disposant d’autorisations suffisantes peut supprimer ce compartiment. **Topics** + [WorkSpaces Rapports des sessions d'applications](usage-report-types-sessions-reports.md) + [WorkSpaces Applications Rapports sur les applications](usage-report-types-applications-reports.md) # WorkSpaces Rapports des sessions d'applications Pour chaque jour où les utilisateurs lancent au moins une session de streaming sur votre compte Amazon Web Services, WorkSpaces Applications exporte un rapport de sessions vers votre compartiment Amazon S3. Le rapport, nommé **daily-session-report- [YYYY] - [MM] - [DD] .csv**, est stocké dans une structure de dossiers imbriquée de votre compte Amazon S3, en utilisant le chemin de dossier suivant : [nom\$1de\$1compartiment]/sessions/schedule=DAILY/year=[YYYY]/month=[MM]/day= [DD]/ Cette structure d’imbrication facilite le partitionnement si vous choisissez d’interroger vos rapports à l’aide d’Amazon Athena. Athena est un service de requête interactif, sans serveur, que vous pouvez utiliser pour analyser les données stockées dans vos compartiments S3 à l’aide de requêtes SQL standard. Pour plus d’informations, consultez [Créez des rapports personnalisés et analysez les données d'utilisation des WorkSpaces applications](configure-custom-reports-analyze-usage-data.md). Chaque session utilisateur est décrite dans un seul enregistrement dans un rapport de session. Les rapports de sessions sont générés quotidiennement selon l'heure UTC dans les 24 heures suivant la fin de la journée qui fait l'objet du rapport. Si une session s'étend sur plus d'une journée, l'enregistrement de session apparaît dans le rapport de session correspondant au jour où la session se termine. Pour plus d'informations sur les données incluses dans les rapports de sessions, consultez [Champs des rapports de sessions](usage-reports-fields-sessions-reports.md). # WorkSpaces Applications Rapports sur les applications Pour chaque jour où les utilisateurs lancent au moins une application pendant leurs sessions de streaming, WorkSpaces Applications exporte un rapport sur les applications vers votre compartiment Amazon S3. Le rapport, nommé **daily-app-report- [YYYY] - [MM] - [DD] .csv**, est stocké dans une structure de dossiers imbriquée de votre compte Amazon S3, en utilisant le chemin de dossier suivant : [nom\$1de\$1compartiment]/applications/schedule=DAILY/year=[YYYY]/month=[MM]/day= [DD]/ Cette structure d’imbrication facilite le partitionnement si vous choisissez d’interroger vos rapports à l’aide d’Amazon Athena. Athena est un service de requête interactif, sans serveur, que vous pouvez utiliser pour analyser les données stockées dans vos compartiments S3 à l’aide de requêtes SQL standard. Pour plus d’informations, consultez [Créez des rapports personnalisés et analysez les données d'utilisation des WorkSpaces applications](configure-custom-reports-analyze-usage-data.md). Chaque lancement d’application est décrit dans un seul enregistrement dans un rapport d’applications. Par exemple, si un utilisateur lance cinq applications distinctes au cours d'une session, cinq enregistrements différents apparaissent dans le rapport d’applications concerné. Une application est enregistrée comme lancée si l'un des événements suivants se produit : + L’application est lancée directement lors du démarrage de la session, car l’ID de l’application est intégrée dans l’URL de streaming ou l’état du relais. + Un utilisateur choisit l'application dans le catalogue d'applications lors du lancement d'une nouvelle session de streaming. + Un utilisateur choisit l'application dans la liste du catalogue d'applications lors d'une session de streaming. Le rapport d’applications n’inclut pas les applications qui sont lancées d’autres façons. Par exemple, si vous permettez aux utilisateurs d'accéder à l'Explorateur Windows ou au menu **Démarrer** du bureau Windows et que les utilisateurs utilisent ces outils pour lancer directement des applications, ou si un autre programme ou script lance une application, ces lancements d'applications ne sont pas inclus dans le rapport sur les applications. PowerShell Les rapports d’applications sont générés quotidiennement selon l’heure UTC dans les 24 heures suivant la fin de la journée qui fait l’objet du rapport. Si une session s’étend sur plus d’une journée, les applications lancées au cours de la session sont prises en compte dans le rapport d’applications correspondant à la journée où la session s’est terminée. Pour plus d’informations sur les données incluses dans les rapports d’applications, consultez [Champs du rapport d’applications](usage-reports-fields-applications-reports.md). # WorkSpaces Champs des rapports d'utilisation des applications Cette rubrique fournit des informations sur les champs inclus dans les rapports d'utilisation des WorkSpaces applications. **Topics** + [Champs des rapports de sessions](usage-reports-fields-sessions-reports.md) + [Champs du rapport d’applications](usage-reports-fields-applications-reports.md) # Champs des rapports de sessions Le tableau suivant décrit les champs inclus dans les rapports WorkSpaces des sessions d'applications. | Nom de champ | Description | | --- | --- | | user\$1session\$1id | L’identifiant unique (ID) pour la session. | | aws\$1account\$1id | ID du compte Amazon Web Services. | | region | La AWS région. | | session\$1start\$1time | La date et l’heure de début de la session. Doivent être spécifiées au format standard ISO 8601, en heure UTC. | | session\$1end\$1time | La date et l’heure de fin de la session. Doivent être spécifiées au format standard ISO 8601, en heure UTC. | | session\$1duration\$1in\$1seconds | La durée de la session en secondes. | | user\$1id | L'ID unique de l'utilisateur dans le type d'authentification. | | user\$1arn | L’Amazon Resource Name (ARN) pour l’utilisateur. | | authentication\$1type | La méthode utilisée pour authentifier l'utilisateur. Valeurs possibles : `CUSTOM` \$1 `SAML` \$1 `USERPOOL` | | authentication\$1type\$1user\$1id | La concaténation de l’ID utilisateur et du type d’authentification, qui identifie de façon unique l’utilisateur aux fins d’évaluation des frais d’utilisation. Pour plus d'informations, consultez la section [Tarification des WorkSpaces applications](https://aws.amazon.com/appstream2/pricing/). | | fleet\$1name | Le nom de la flotte associée à la session. | | stack\$1name | Le nom de la pile associée à la session. | | instance\$1type | Type WorkSpaces d'instance d'applications utilisé pour la session. Pour obtenir la liste des types d'instances, consultez la section [Tarification des WorkSpaces applications](https://aws.amazon.com/appstream2/pricing/). | | eni\$1private\$1ip\$1address | Adresse IP de l'interface Elastic network utilisée par l'instance WorkSpaces Applications pour les communications réseau. | | connected\$1at\$1least\$1once | Indique si l'utilisateur s’est connecté au moins une fois à la session. Valeurs possibles : `true` \$1 `false` | | client\$1ip\$1addresses | Les adresses IP associées aux appareils utilisateur utilisés pour se connecter à la session. Si l’utilisateur s’est connecté, puis déconnecté de la session plus d’une fois, jusqu’aux 10 dernières adresses IP distinctes sont stockées, séparées par des points-virgules. | | google\$1drive\$1enabled | Indique si Google Drive a été activé en tant qu’option de stockage permanent pour la session. Pour plus d’informations, consultez [Activez et administrez Google Drive pour les utilisateurs de vos WorkSpaces applications](google-drive.md). Valeurs possibles : `true` \$1 `false` | | one\$1drive\$1enabled | Indique si l'option de stockage permanent OneDrive a été activée pour la session. Pour de plus amples informations, veuillez consulter [Activez et administrez Google Drive pour les utilisateurs de vos WorkSpaces applications](google-drive.md). Valeurs possibles : `true` \$1 `false` | | home\$1folders\$1storage\$1location | Le compartiment Amazon S3 utilisé pour les fichiers qui sont stockés dans des dossiers de base. | | user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device | Indique si l’utilisateur a été en mesure de copier les données de l’appareil local vers la session de streaming à l’aide du presse-papiers pendant la session. Valeurs possibles : `ENABLED` \$1 `DISABLED` | | user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device | Indique si l’utilisateur a été en mesure de copier les données de la session de streaming vers l’appareil local à l’aide du presse-papiers pendant la session. Valeurs possibles : `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1upload | Indique si l’utilisateur a été en mesure de charger des fichiers de l’appareil local vers la session de streaming pendant la session. Valeurs possibles : `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1download | Indique si l’utilisateur a été en mesure de télécharger des fichiers de la session de streaming vers l’appareil local pendant la session. Valeurs possibles : `ENABLED` \$1 `DISABLED` | | user\$1settings\$1printing\$1to\$1local\$1device | Indique si l’utilisateur a été en mesure d’imprimer des fichiers de la session de streaming vers l’appareil local pendant la session. Valeurs possibles : `ENABLED` \$1 `DISABLED` | | application\$1settings\$1enabled | Indique si la persistance des paramètres de l'application a été activée pour la session. Valeurs possibles : `true` \$1 `false` | | domain\$1joined | Indique si l'instance de streaming d' WorkSpaces applications a été jointe à un domaine Active Directory lors du lancement de la session. Pour de plus amples informations, veuillez consulter [Utilisation d'Active Directory avec des WorkSpaces applications](active-directory.md). Valeurs possibles : `Y` \$1 `N` | | max\$1session\$1duration | La durée maximale autorisée de la session, en secondes. | | session\$1type | Le type de session. Valeurs possibles : `ALWAYS_ON` \$1 `ON_DEMAND` | | stream\$1view | L’affichage de flux. Valeurs possibles : `APPLICATION` \$1 `DESKTOP` | | streaming\$1experience\$1settings\$1protocol | Le protocole de fin de streaming utilisé par la session. Valeurs possibles : `UDP` \$1 `TCP` | | instance\$1id | ID d’instance associé à la session utilisateur. | | is\$1multisession | Indique si la session appartient à une flotte multi-sessions. Valeurs possibles : `true` \$1 `false` | # Champs du rapport d’applications Le tableau suivant décrit les champs inclus dans les rapports sur les WorkSpaces applications. | Nom de champ | Description | | --- | --- | | user\$1session\$1id | L’identifiant unique (ID) pour la session. | | application\$1name | Nom de l'application, tel qu’il est spécifié dans Image Assistant. Cette valeur est fournie lorsqu'un utilisateur lance une application via l'interface WorkSpaces Applications. | | schedule | La fréquence à laquelle les rapports sont générés. Valeur possibles : DAILY | | year | L'année du rapport. | | month | Le mois du rapport. | | day | Le jour du rapport. | # Créez des rapports personnalisés et analysez les données d'utilisation des WorkSpaces applications Amazon Athena est un service de requête interactif, sans serveur, que vous pouvez utiliser pour analyser les données stockées dans vos compartiments S3 à l’aide de requêtes SQL standard. Vous pouvez utiliser Athena pour regrouper vos rapports d’utilisation ou générer d’autres types de rapports personnalisés. **Topics** + [Création d'un AWS Glue Crawler](configure-custom-reports-create-crawler.md) + [Création d'un catalogue de données à l'aide du AWS Glue Crawler](configure-custom-reports-create-data-catalog.md) + [Création et exécution de requêtes Athena](configure-custom-reports-create-run-athena-queries.md) + [Utilisation des requêtes Athena](configure-custom-reports-example-sql-queries.md) # Création d'un AWS Glue Crawler AWS Glue est un service d'extraction, de transformation et de chargement (ETL) entièrement géré qui vous permet de créer une base de données à partir de vos données Amazon S3 et d'interroger cette base de données à l'aide d'Athena. Cette base de données est également appelée catalogue AWS Glue de données. Un AWS Glue robot d'exploration peut détecter automatiquement le schéma de vos données Amazon S3 et créer la base de données et les tables correspondantes. WorkSpaces Applications fournit un CloudFormation modèle que vous pouvez utiliser pour créer les AWS Glue ressources nécessaires. **Important** L'exécution des étapes de la procédure suivante crée un AWS Glue robot d'exploration. Toutefois, ces étapes ne démarrent pas le crawler. Pour démarrer le crawler, vous devez exécuter les étapes de la procédure suivante. Pour plus d'informations sur les AWS Glue robots d'exploration, consultez la section [Définition des robots d'exploration](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html). **Pour créer un AWS Glue crawler** 1. Ouvrez la console WorkSpaces Applications à la [https://console.aws.amazon.com/appstream2/maison](https://console.aws.amazon.com/appstream2/home). 1. Choisissez la AWS région pour laquelle vous êtes abonné aux rapports d'utilisation. 1. Dans le volet de navigation, choisissez **Usage Reports (Rapports d’utilisation)** et vérifiez que la journalisation des rapports d’utilisation est activée. 1. Dans l'onglet **Détails du rapport**, dans le paragraphe à côté de **Analytics**, choisissez le lien du **CloudFormationmodèle**. Lorsque vous cliquez sur le lien, la CloudFormation console s'ouvre, dans laquelle vous pouvez consulter les paramètres de la CloudFormation pile spécifiée par le modèle avant de l'exécuter. Le modèle, lorsqu'il est exécuté, crée un AWS Glue robot d'exploration et plusieurs exemples de requêtes Athena. 1. Sur la page **Spécifier les détails**, à côté **ScheduleExpression**, conservez la valeur par défaut ou spécifiez une valeur d'expression cron différente pour la fréquence à laquelle vous souhaitez exécuter le robot d'exploration. Ne modifiez pas les autres valeurs par défaut. Lorsque vous avez terminé, sélectionnez **Next**. Par défaut, le crawler est programmé pour s’exécuter chaque jour, mais vous pouvez le configurer pour une exécution hebdomadaire, mensuelle ou toute autre fréquence. Pour plus d’informations sur la syntaxe cron, consultez [Expressions Cron](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions). 1. Dans la page **Options**, conservez les valeurs par défaut, puis choisissez **Next (Suivant)**. 1. Sur la page de **révision**, cochez la case à côté de « Je reconnais que cela CloudFormation pourrait créer des ressources IAM avec des noms personnalisés », puis choisissez **Créer**. Vous devez disposer des autorisations AWS Glue et Gestion des identités et des accès AWS (IAM) suffisantes pour créer et exécuter la CloudFormation pile. Si vous n’avez pas les autorisations requises, demandez à votre administrateur de compte Amazon Web Services d’effectuer ces étapes dans votre compte ou de vous accorder les autorisations suivantes. ------ #### [ 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" } ] } ``` ------ # Création d'un catalogue de données à l'aide du AWS Glue Crawler Le AWS Glue robot d'exploration, lorsqu'il est exécuté, crée un catalogue de données et un schéma qui sont mappés à la structure de vos sessions et de vos rapports d'applications. Chaque fois qu'un nouveau rapport est stocké dans votre compartiment Amazon S3, vous devez exécuter le robot d'exploration pour mettre à jour votre catalogue de AWS Glue données avec les données du nouveau rapport. **Note** Des frais peuvent s'appliquer au fonctionnement de votre AWS Glue robot d'exploration. Pour plus d’informations, consultez [Tarification d’AWS Glue](https://aws.amazon.com/glue/pricing/). 1. Ouvrez la AWS Glue console à l'adresse [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/). 1. Choisissez la AWS région pour laquelle vous êtes abonné aux rapports d'utilisation. 1. Cochez la case à côté du robot d'exploration nommé **appstream-usage-sessions-crawler**, puis choisissez **Run crawler**. Répétez cette étape pour le robot d'exploration nommé **appstream-usage-apps-crawler**. L'exécution de ces étapes exécute les robots d'exploration et les planifie pour qu'ils s'exécutent automatiquement conformément au calendrier spécifié dans la CloudFormation pile. 1. Lorsque les deux crawlers ont fini de s’exécuter, dans le volet de navigation, choisissez **Bases de données**. Une base de données appelée **appstream-usage**, qui affiche vos rapports d'utilisation, apparaît. Cette base de données est un catalogue de AWS Glue données qui a été créé lors de son exécution **appstream-usage-sessions-crawler**et qui a **appstream-usage-apps-crawler**été exécuté. 1. Pour afficher les tables de la base de données, choisissez **appstream-usage**, **Tables**. Deux tables s’affichent : **applications** et **sessions**, qui représentent respectivement vos rapports d’utilisation d’applications et de sessions. Sélectionnez l'une ou l'autre table pour afficher son schéma. Vous pouvez maintenant interroger ces tables dans Athena à l’aide de SQL. # Création et exécution de requêtes Athena Pour interroger vos rapports d’utilisation à l’aide d’Athena, suivez les étapes ci-dessous. **Note** Des frais peuvent s’appliquer pour les requêtes Athena que vous exécutez. Pour plus d'informations, consultez [Tarification Amazon Athena](https://aws.amazon.com/athena/pricing/). 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Sous **Database (Base de données)**, choisissez **appstream-usage**. 1. Dans le volet de requête, saisissez une requête SQL, puis choisissez **Run query (Exécuter la requête)**. # Utilisation des requêtes Athena Cette section fournit les requêtes SQL que vous pouvez exécuter dans Athena pour analyser les données des rapports d’utilisation de votre compartiment Amazon S3. Pour créer un rapport de synthèse de toutes les sessions au cours d'un mois donné, exécutez la requête suivante : ``` SELECT * FROM "appstream-usage"."sessions" WHERE year='four-digit-year' AND month='two-digit-month' ``` Vous pouvez également effectuer des opérations conjointes entre les tables **applications **et **sessions** dans votre requête. Par exemple, pour afficher les différents utilisateurs qui ont lancé chaque application au cours d'un mois donné, exécutez la requête suivante : ``` 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 ``` Les résultats des requêtes Athena sont stockés sous forme de fichiers .csv dans un compartiment Amazon S3 de votre compte qui est nommé `aws-athena-query-results-account-id-without-hyphens-region-code`. Pour faciliter la localisation des résultats de la requête, choisissez **Save as (Enregistrer sous)** et donnez un nom à votre requête avant de l'exécuter. Vous pouvez également choisir l’icône de téléchargement dans le volet **Résultats Athena** pour télécharger les résultats de la requête sous la forme d’un fichier .csv. Pour améliorer les performances et réduire les coûts, Athena utilise le partitionnement afin de réduire la quantité de données analysées dans les requêtes. Pour en savoir plus, consultez [Partitionnement de données](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). Les rapports d’utilisation sont partitionnées dans vos compartiments Amazon S3 par année, par mois et par jour. Vous pouvez limiter vos requêtes à certaines partitions de plage de dates en utilisant les champs **year (année)**, **month (mois)** et **day (jour)** comme conditions dans vos requêtes. Par exemple, la requête suivante intègre uniquement les rapports de sessions pour la semaine du 19 mai 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 ``` En revanche, la requête suivante produit des résultats identiques, mais n’étant pas limitée à une partition, elle intègre tous les rapports de sessions stockés dans votre compartiment 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 une session s’étend sur plus d’une journée, les enregistrements de session et d’application apparaissent respectivement dans les rapports de sessions et d’applications correspondant à la journée où la session s’est terminée. Pour cette raison, si vous avez besoin de trouver des enregistrements qui se rapportent à toutes les sessions qui étaient actives au cours d'une période donnée, pensez à étendre l'ensemble des partitions de votre requête par la durée maximale de session que vous avez configurée pour vos flottes. Par exemple, pour afficher toutes les sessions actives pour une flotte donnée au cours d’un mois civil, où la durée maximale d’une session était de 100 heures, exécutez la requête suivante pour étendre de cinq jours l’ensemble de partitions défini. ``` 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 ``` Le CloudFormation modèle qui a créé les AWS Glue robots d'exploration a également créé et enregistré plusieurs exemples de requêtes dans votre compte Athena que vous pouvez utiliser pour analyser vos données d'utilisation. Ces exemples de requêtes incluent les suivantes : + Rapport de session mensuel regroupé + Durée moyenne de la session par pile + Nombre de sessions par jour + Total des heures de streaming par utilisateur **Note** Les frais d’utilisation à la demande sont arrondies à l’heure supérieure pour chaque session. + Différents utilisateurs par application Pour utiliser l'une de ces requêtes, suivez les étapes ci-dessous. 1. Ouvrez la console à l'adresse [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/). 1. Choisissez **Saved Queries (Requêtes enregistrées)**. Les cinq requêtes notées avant cette procédure doivent s'afficher. Le nom de chaque requête commence par « »AS2. Par exemple, « AS2 \$1users\$1per\$1app\$1curr\$1mo ». 1. Pour exécuter une requête, choisissez le nom de la requête plutôt que l'option située en regard du nom. 1. Le texte de la requête s'affiche dans le volet de requête. Choisissez **Exécuter la requête**. *Pour afficher ces requêtes dans un CloudFormation modèle distinct, consultez [athena-sample-queries-appstream-usage-data\$1template.yml](https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html) dans le catalogue d'exemples de code.AWS *