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à. # WorkSpaces Rapporti sull'utilizzo delle applicazioni Puoi iscriverti ai report sull'utilizzo di Amazon WorkSpaces Applications per ricevere report dettagliati su come i tuoi utenti utilizzano il servizio. Ogni giorno vengono esportati due file.csv in un bucket Amazon Simple Storage Service (Amazon S3) nel tuo account. **Nota** Per abilitare i report sull'utilizzo WorkSpaces delle applicazioni, devi utilizzare un'immagine che utilizzi una versione dell'agente WorkSpaces Applications rilasciata a partire dal 7 maggio 2019. **Topics** + [Abilita i report sull'utilizzo WorkSpaces delle applicazioni](enable-usage-reports.md) + [WorkSpaces Campi dei report sull'utilizzo delle applicazioni](usage-reports-fields.md) + [Crea report personalizzati e analizza i dati di utilizzo WorkSpaces delle applicazioni](configure-custom-reports-analyze-usage-data.md) # Abilita i report sull'utilizzo WorkSpaces delle applicazioni Per ricevere i report sull'utilizzo, vi abbonate utilizzando la console WorkSpaces Applicazioni, il AWS Command Line Interface (AWS CLI) o il funzionamento dell'`CreateUsageReportSubscription`API. È necessario abilitare i report sull'utilizzo separatamente per ogni AWS regione per la quale si desidera ricevere i dati di utilizzo. **Nota** È possibile avviare o interrompere la tua iscrizione ai report di utilizzo in qualsiasi momento. Non vi è alcun costo per l'abbonamento ai report sull'utilizzo, ma ai report archiviati nel bucket S3 possono essere applicati i costi standard di Amazon S3. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://aws.amazon.com/s3/pricing/). Per sottoscrivere i report di utilizzo per WorkSpaces le WorkSpaces applicazioni utilizzando la console Applicazioni, effettuate le seguenti operazioni. 1. Apri la console WorkSpaces Applicazioni a [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home). 1. Scegli la AWS regione per la quale desideri abilitare i report sull'utilizzo. 1. Nel riquadro di navigazione scegliere **Reports (Report)**. 1. Seleziona **Enabled (Abilitato)**, quindi **Apply (Applica)**. Se hai abilitato gli script di sessione su istanza e la registrazione di Amazon S3 per la configurazione degli script di sessione WorkSpaces , Applications ha creato un bucket S3 per archiviare l'output dello script. Questo bucket è univoco per il tuo account e la tua regione. Quando abiliti i report sull'utilizzo in questo caso, WorkSpaces Applications utilizza lo stesso bucket per archiviare i report di utilizzo. Se non hai già abilitato gli script di sessione sull'istanza, quando abiliti i report di utilizzo, WorkSpaces Applications crea un nuovo bucket S3 nella seguente posizione: ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` ***region-code*** Il codice AWS regionale per la regione in cui è abilitata la reportistica sull'utilizzo. ***account-id-without-hyphens*** L'identificatore dell'account Amazon Web Services. L'ID casuale garantisce che non vi sia alcun conflitto con altri bucket in quella stessa regione. La prima parte del nome del bucket, `appstream-logs`, resta uguale in tutti gli account o le regioni. Ad esempio, se abiliti il reporting sull'utilizzo nella regione Stati Uniti occidentali (Oregon) (us-west-2) con il numero di account 123456789012 WorkSpaces , Applications crea un bucket Amazon S3 all'interno del tuo account in quella regione simile al nome mostrato nell'esempio seguente: ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` Solo un amministratore con autorizzazioni sufficienti può eliminare il bucket. **Topics** + [WorkSpaces Rapporti sulle sessioni delle applicazioni](usage-report-types-sessions-reports.md) + [WorkSpaces Applicazioni, applicazioni, rapporti](usage-report-types-applications-reports.md) # WorkSpaces Rapporti sulle sessioni delle applicazioni Per ogni giorno in cui gli utenti avviano almeno una sessione di streaming nel tuo account Amazon Web Services, WorkSpaces Applications esporta un report sulle sessioni nel tuo bucket Amazon S3. Il report, denominato **daily-session-report- [YYYY] - [MM] - [DD] .csv**, è archiviato in una struttura di cartelle annidate nel tuo account Amazon S3, utilizzando il seguente percorso di cartella: [nome\$1bucket]/= [DD]/sessions/schedule=DAILY/year=[YYYY]/month=[MM]/day Questa struttura di nidificazione facilita il partizionamento se scegli di eseguire query sui report utilizzando Amazon Athena. Athena è un servizio serverless di query interattive, che è possibile utilizzare per analizzare i dati archiviati nel bucket S3 utilizzando SQL standard. Per ulteriori informazioni, consulta [Crea report personalizzati e analizza i dati di utilizzo WorkSpaces delle applicazioni](configure-custom-reports-analyze-usage-data.md). Ogni sessione utente viene descritta in un singolo record in un report di sessioni. I report di sessioni vengono generati ogni giorno in base all'ora UTC entro 24 ore dalla chiusura del giorno oggetto del report. Se una sessione copre più di un giorno, il record di sessione verrà visualizzato nel report di sessioni corrispondente al giorno in cui la sessione termina. Per ulteriori informazioni sui dati inclusi nei report di sessioni, consulta [Campi sessioni report](usage-reports-fields-sessions-reports.md). # WorkSpaces Applicazioni, applicazioni, rapporti Per ogni giorno in cui gli utenti lanciano almeno un'applicazione durante le sessioni di streaming, WorkSpaces Applications esporta un report sulle applicazioni nel bucket Amazon S3. Il report, denominato **daily-app-report- [YYYY] - [MM] - [DD] .csv**, è archiviato in una struttura di cartelle annidate nel tuo account Amazon S3, utilizzando il seguente percorso di cartella: [nome\$1bucket]/= [DD]/applications/schedule=DAILY/year=[YYYY]/month=[MM]/day Questa struttura di nidificazione facilita il partizionamento se scegli di eseguire query sui report utilizzando Amazon Athena. Athena è un servizio serverless di query interattive, che è possibile utilizzare per analizzare i dati archiviati nel bucket S3 utilizzando SQL standard. Per ulteriori informazioni, consulta [Crea report personalizzati e analizza i dati di utilizzo WorkSpaces delle applicazioni](configure-custom-reports-analyze-usage-data.md). Ogni avvio di applicazione viene descritto in un singolo record in un report di applicazioni. Ad esempio, se un utente avvia cinque applicazioni separate durante una sessione, cinque record separati appaiono nel relativo report delle applicazioni corrispondenti. Un'applicazione viene registrata come avviata se si verifica uno qualsiasi dei seguenti eventi: + L'applicazione viene avviata direttamente quando la sessione viene avviata, poiché l'ID dell'applicazione è incorporato nell'URL di streaming o nello stato del relay. + Un utente sceglie l'applicazione dal catalogo dell'applicazione all'avvio una nuova sessione di streaming. + Un utente sceglie l'applicazione dall'elenco dei cataloghi delle applicazioni durante una sessione di streaming. Il report delle applicazioni non include le applicazioni avviate in altri modi. Ad esempio, se si fornisce agli utenti l'accesso a Windows Explorer o al menu **Start** del desktop di Windows e gli utenti utilizzano tali strumenti per avviare direttamente le applicazioni o se un altro programma o script avvia un'applicazione, tali avvii di applicazioni non sono inclusi nel rapporto sulle applicazioni. PowerShell I report delle applicazioni vengono generati in base all'ora UTC entro 24 ore dalla chiusura giornaliera, che è l'oggetto del report. Se una sessione copre più di un giorno, le applicazioni avviate durante la sessione vengono riflesse nel report delle applicazioni corrispondente al giorno in cui la sessione termina. Per ulteriori informazioni sui dati inclusi nei report delle applicazioni, consulta [Campi report applicazioni](usage-reports-fields-applications-reports.md). # WorkSpaces Campi dei report sull'utilizzo delle applicazioni Questo argomento fornisce informazioni sui campi inclusi nei report sull'utilizzo WorkSpaces delle applicazioni. **Topics** + [Campi sessioni report](usage-reports-fields-sessions-reports.md) + [Campi report applicazioni](usage-reports-fields-applications-reports.md) # Campi sessioni report La tabella seguente descrive i campi inclusi nei report sulle sessioni di WorkSpaces Applicazioni. | Nome campo | Description | | --- | --- | | user\$1session\$1id | L'identificativo (ID) univoco per la sessione. | | aws\$1account\$1id | L'ID dell'account Amazon Web Services. | | region | La AWS regione. | | session\$1start\$1time | La data e l'ora in cui la sessione è stata avviata. Deve essere specificata nel formato ISO 8601 e come UTC. | | session\$1end\$1time | La data e l'ora in cui la sessione è terminata. Deve essere specificata nel formato ISO 8601 e come UTC. | | session\$1duration\$1in\$1seconds | La durata della sessione in secondi. | | user\$1id | L'ID univoco per l'utente all'interno del tipo di autenticazione. | | user\$1arn | Un Amazon Resource Name (ARN) per l'utente. | | authentication\$1type | Il metodo utilizzato per autenticare l'utente. Valori possibili: `CUSTOM` \$1 `SAML` \$1 `USERPOOL` | | authentication\$1type\$1user\$1id | La sequenza di ID utente e tipo di autenticazione che identifica in modo univoco l'utente per valutare le tariffe degli utenti. Per ulteriori informazioni, consulta la sezione [Prezzi WorkSpaces delle applicazioni](https://aws.amazon.com/appstream2/pricing/). | | fleet\$1name | Nome del parco associato alla sessione. | | stack\$1name | Il nome dello stack associato alla sessione. | | instance\$1type | Il tipo di istanza WorkSpaces Applications utilizzato per la sessione. Per un elenco dei tipi di istanze, consulta la sezione [Prezzi WorkSpaces delle applicazioni](https://aws.amazon.com/appstream2/pricing/). | | eni\$1private\$1ip\$1address | L'indirizzo IP dell'interfaccia elastica di rete utilizzata dall'istanza WorkSpaces Applications per le comunicazioni di rete. | | connected\$1at\$1least\$1once | Indica se l'utente si è connesso alla sessione almeno una volta. Valori possibili: `true` \$1 `false` | | client\$1ip\$1addresses | Gli indirizzi IP associati con il dispositivo utente o i dispositivi utilizzati per connettersi alla sessione. Se l'utente si è connesso ,e quindi disconnesso dalla sessione, più di una volta, fino agli ultimi 10 indirizzi IP distinti archiviati, separati da un punto e virgola. | | google\$1drive\$1enabled | Indica se Google Drive è stata abilitata come un'opzione di storage persistente per la sessione. Per ulteriori informazioni, consulta [Abilita e amministra Google Drive per gli utenti delle tue applicazioni WorkSpaces](google-drive.md). Valori possibili: `true` \$1 `false` | | one\$1drive\$1enabled | Indica se OneDrive è stata abilitata come opzione di archiviazione persistente per la sessione. Per ulteriori informazioni, consulta [Abilita e amministra Google Drive per gli utenti delle tue applicazioni WorkSpaces](google-drive.md). Valori possibili: `true` \$1 `false` | | home\$1folders\$1storage\$1location | Il bucket Amazon S3 utilizzato per i file archiviati tramite le home directory. | | user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device | Indica se l'utente è stato in grado di copiare i dati dal dispositivo locale alla sessione di streaming utilizzando gli appunti durante la sessione. Valori possibili: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device | Indica se l'utente è stato in grado di copiare i dati dalla sessione di streaming al dispositivo locale utilizzando gli appunti durante la sessione. Valori possibili: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1upload | Indica se l'utente è stato in grado di caricare file dal dispositivo locale alla sessione di streaming durante la sessione. Valori possibili: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1file\$1download | Indica se l'utente è stato in grado di scaricare file dalla sessione di streaming al dispositivo locale durante la sessione. Valori possibili: `ENABLED` \$1 `DISABLED` | | user\$1settings\$1printing\$1to\$1local\$1device | Indica se l'utente è stato in grado di stampare file dalla sessione di streaming al dispositivo locale durante la sessione. Valori possibili: `ENABLED` \$1 `DISABLED` | | application\$1settings\$1enabled | Indica se la persistenza delle impostazioni delle applicazioni è stata abilitata per la sessione. Valori possibili: `true` \$1 `false` | | domain\$1joined | Indica se l'istanza di streaming WorkSpaces Applications è stata aggiunta a un dominio Active Directory all'avvio della sessione. Per ulteriori informazioni, consulta [Utilizzo di Active Directory con WorkSpaces applicazioni](active-directory.md). Valori possibili: `Y` \$1 `N` | | max\$1session\$1duration | Il numero massimo consentito di durata della sessione in secondi. | | session\$1type | Il tipo di sessione. Valori possibili: `ALWAYS_ON` \$1 `ON_DEMAND` | | stream\$1view | La vista del flusso. Valori possibili: `APPLICATION` \$1 `DESKTOP` | | streaming\$1experience\$1settings\$1protocol | Il protocollo con cui la sessione ha terminato lo streaming. Valori possibili: `UDP` \$1 `TCP` | | instance\$1id | L'ID istanza associato alla sessione dell'utente. | | is\$1multisession | Indica se la sessione appartiene a un parco istanze multi-sessione. Valori possibili: `true` \$1 `false` | # Campi report applicazioni La tabella seguente descrive i campi inclusi nei report WorkSpaces Applicazioni e applicazioni. | Nome campo | Description | | --- | --- | | user\$1session\$1id | L'identificativo (ID) univoco per la sessione. | | application\$1name | Nome dell'applicazione, come specificato in Image Assistant. Questo valore viene fornito quando un utente avvia un'applicazione tramite l'interfaccia WorkSpaces Applicazioni. | | schedule | La frequenza con cui vengono generati i report. Valore possibile: QUOTIDIANO | | anno | L'anno del report. | | mese | Il mese del report. | | giorno | Il giorno del report. | # Crea report personalizzati e analizza i dati di utilizzo WorkSpaces delle applicazioni Amazon Athena è un servizio serverless di query interattive, che puoi utilizzare per analizzare i dati archiviati nel bucket S3 utilizzando le query SQL standard. Puoi utilizzare Athena per aggregare i report sull'utilizzo o generare altri tipi di report personalizzati. **Topics** + [Crea un AWS Glue crawler](configure-custom-reports-create-crawler.md) + [Crea un catalogo di dati utilizzando il crawler AWS Glue](configure-custom-reports-create-data-catalog.md) + [Creazione ed esecuzione di query di Athena](configure-custom-reports-create-run-athena-queries.md) + [Utilizzo delle query di Athena](configure-custom-reports-example-sql-queries.md) # Crea un AWS Glue crawler AWS Glue è un servizio di estrazione, trasformazione e caricamento (ETL) completamente gestito che consente di creare un database dai dati di Amazon S3 e interrogare tale database utilizzando Athena. Questo database viene anche chiamato catalogo dati. AWS Glue Un AWS Glue crawler può rilevare automaticamente lo schema dei dati di Amazon S3 e creare il database e le tabelle corrispondenti. WorkSpaces Applications fornisce un CloudFormation modello che puoi utilizzare per creare le risorse necessarie. AWS Glue **Importante** Il completamento dei passaggi descritti nella procedura seguente crea un AWS Glue crawler. Questi passaggi, però, non avviano il crawler. Per avviare il crawler, è necessario seguire la procedura successiva. [Per ulteriori informazioni sui AWS Glue crawler, consulta Definizione dei crawler.](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) **Per creare un crawler AWS Glue** 1. [Apri la console WorkSpaces Applicazioni a casahttps://console.aws.amazon.com/appstream2/.](https://console.aws.amazon.com/appstream2/home) 1. Scegli la AWS regione per la quale hai sottoscritto i report sull'utilizzo. 1. Nel riquadro di navigazione, scegliere **Usage Reports (Report di utilizzo)** e verificare che la registrazione dei report di utilizzo sia abilitata. 1. Nella scheda **Dettagli del rapporto**, nel paragrafo accanto a **Analytics**, scegli il link del **CloudFormationmodello**. Scegliendo il link si apre la CloudFormation console, dove puoi esaminare i parametri dello CloudFormation stack specificato dal modello prima di eseguirlo. Il modello, una volta eseguito, crea un AWS Glue crawler e diverse query Athena di esempio. 1. Nella pagina **Specificare i dettagli**, accanto a **ScheduleExpression**, mantieni il valore predefinito o specifica un valore di espressione cron diverso per la frequenza con cui desideri eseguire il crawler. Non modificare nessun altro valore predefinito. Al termine, selezionare **Next (Successivo)**. Per impostazione predefinita, il crawler è programmato per l'esecuzione su base giornaliera, ma è possibile configurare il crawler per l'esecuzione settimanale, mensile o su un'altra frequenza. Per ulteriori informazioni sulla sintassi cron, consulta [Cron Expressions (Espressioni cron)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions). 1. Nella pagina **Options (Opzioni)**, lascia i valori predefiniti e scegli **Next (Avanti)**. 1. **Nella pagina di **revisione**, seleziona la casella di controllo accanto a «Riconosco che CloudFormation potrebbe creare risorse IAM con nomi personalizzati», quindi scegli Crea.** È necessario disporre di autorizzazioni AWS Glue e AWS Identity and Access Management (IAM) sufficienti per creare ed eseguire lo CloudFormation stack. Se non disponi delle autorizzazioni necessarie, contatta l'amministratore dell'account Amazon Web Services per eseguire queste fasi nel tuo account o per ottenere le autorizzazioni seguenti. ------ #### [ 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" } ] } ``` ------ # Crea un catalogo di dati utilizzando il crawler AWS Glue Il AWS Glue crawler, una volta eseguito, crea un catalogo di dati e uno schema mappati alla struttura delle sessioni e dei report delle applicazioni. Ogni volta che un nuovo report viene archiviato nel tuo bucket Amazon S3, devi eseguire il crawler per aggiornare il tuo AWS Glue Data Catalog con i dati del nuovo report. **Nota** Potrebbero essere applicati costi all'esecuzione del crawler. AWS Glue Per ulteriori informazioni, consultare [AWS Glue Prezzi](https://aws.amazon.com/glue/pricing/). 1. Apri la AWS Glue console all'indirizzo. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) 1. Scegli la AWS regione per la quale hai sottoscritto i report sull'utilizzo. 1. **Seleziona la casella di controllo accanto al crawler denominato **appstream-usage-sessions-crawler**, quindi scegli Esegui crawler.** Ripeti questo passaggio per il crawler denominato. **appstream-usage-apps-crawler** L'esecuzione di questi passaggi esegue i crawler e ne pianifica l'esecuzione automatica in base alla pianificazione specificata nello stack. CloudFormation 1. Al termine dell'esecuzione di entrambi i crawler, nel riquadro di navigazione, scegliere **Database**. Viene visualizzato un database denominato **appstream-usage**, che rappresenta il report di utilizzo. Questo database è un catalogo di AWS Glue dati che è stato creato quando **appstream-usage-sessions-crawler**ed **appstream-usage-apps-crawler**è stato eseguito. 1. Per visualizzare le tabelle nel database, scegliere **appstream-usage**, **Tables (Tabelle)**. Vengono visualizzate due tabelle, **applicazioni** e **sessioni** che rappresentano rispettivamente i report di utilizzo delle applicazioni e delle sessioni. Selezionare una tabella per visualizzarne lo schema. Ora puoi eseguire query su queste tabelle in Athena utilizzando SQL. # Creazione ed esecuzione di query di Athena Per eseguire query sui report sull'utilizzo con Athena, esegui la procedura riportata di seguito. **Nota** Le query eseguite con Athena potrebbero essere soggette a costi aggiuntivi. Per ulteriori informazioni, consulta [Prezzi di Amazon Athena](https://aws.amazon.com/athena/pricing/). 1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. In **Database**, scegliere **appstream-usage**. 1. Nel riquadro delle query, immettere una query SQL e scegliere **Run query (Esegui query)**. # Utilizzo delle query di Athena Questa sezione fornisce le query SQL che puoi eseguire in Athena per analizzare i dati dei report sull'utilizzo nel bucket Amazon S3. Per creare un report consolidato di tutte le sessioni in un determinato mese, eseguire la seguente query: ``` SELECT * FROM "appstream-usage"."sessions" WHERE year='four-digit-year' AND month='two-digit-month' ``` È inoltre possibile eseguire operazioni di unione tra le tabelle di **applicazioni **e di **sessioni** nella query. Ad esempio, per visualizzare i diversi utenti che hanno lanciato le singole applicazioni in un determinato mese, eseguire la seguente query: ``` 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 ``` I risultati delle query di Athena vengono archiviati come file.csv in un bucket Amazon S3 nell'account denominato `aws-athena-query-results-account-id-without-hyphens-region-code`. Per semplificare l'individuazione dei risultati delle query, selezionare **Save as (Salva come)** e fornire un nome per la query prima di eseguirla. Puoi anche scegliere l'icona di download nel riquadro **Risultati di Athena** per scaricare i risultati della query come file .csv. Per migliorare le prestazioni e ridurre i costi, Athena usa il partizionamento per ridurre la quantità di dati scansionati nelle query. Per ulteriori informazioni, consulta la pagina relativa al [partizionamento di dati](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). I report sull'utilizzo sono partizionati nel bucket Amazon S3 per anno, mese e giorno. È possibile limitare le query a determinate partizioni di intervalli di date utilizzando i campi **year**, **month** e **day** come condizioni nella query. Ad esempio, la seguente query è in grado di acquisire solo i report delle sessioni per la settimana del 19 maggio 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 ``` Al contrario, la query seguente produce risultati identici ma, poiché non è limitata a nessuna partizione, è in grado di acquisire tutti i report sulle sessioni archiviati nel bucket 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 ``` Se una sessione copre più di un giorno, i record di sessione e delle applicazioni appaiono rispettivamente, nei report delle sessioni e delle applicazioni corrispondenti al giorno in cui termina la sessione. Per questo motivo, se è necessario trovare record che riguardano tutte le sessioni attive durante un determinato intervallo di date, considerare di espandere il set della partizione in base alla durata massima della sessione che è stata configurata per i parchi istanza. Ad esempio, per visualizzare tutte le sessioni attive per un determinato parco istanze durante un mese di calendario, dove il parco istanze aveva una durata massima di sessione pari a 100 ore, eseguire la seguente query per espandere di cinque giorni la propria partizione. ``` 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 ``` Il CloudFormation modello che ha creato AWS Glue i crawler ha inoltre creato e salvato diverse query di esempio nel tuo account Athena che puoi utilizzare per analizzare i tuoi dati di utilizzo. Queste query di esempio includono: + Report di sessione mensili aggregati + Lunghezza di sessione media per stack + Numero di sessioni al giorno + Ore totali di streaming per utente **Nota** I costi di utilizzo on demand vengono arrotondati per eccesso all'ora successiva per ogni sessione. + Utenti distinti per app Per utilizzare una di queste query, eseguire la procedura seguente. 1. Apri la console Athena all'indirizzo [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/). 1. Scegliere **Saved Queries (Query salvate)**. Dovrebbero essere visualizzate le cinque query sopra citate. Il nome di ogni query inizia con ".» AS2 Ad esempio, "AS2\$1users\$1per\$1app\$1curr\$1mo». 1. Per eseguire una query, scegliere il nome della query anziché l'opzione accanto al nome. 1. Il testo della query viene visualizzato nell'apposito riquadro. Scegli **Esegui query**. [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)