As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# WorkSpaces Relatórios de uso de aplicativos
Você pode assinar os relatórios de uso do Amazon WorkSpaces Applications para receber relatórios detalhados sobre como seus usuários estão usando o serviço. Dois arquivos .csv são exportados diariamente para um bucket do Amazon Simple Storage Service (Amazon S3) em sua conta.
**nota**
Para ativar os relatórios de uso de WorkSpaces aplicativos, você deve usar uma imagem que use uma versão do agente de WorkSpaces aplicativos lançada em ou após 7 de maio de 2019.
**Topics**
+ [Ativar relatórios de uso de WorkSpaces aplicativos](enable-usage-reports.md)
+ [WorkSpaces Campos de relatórios de uso de aplicativos](usage-reports-fields.md)
+ [Crie relatórios personalizados e analise dados de uso de WorkSpaces aplicativos](configure-custom-reports-analyze-usage-data.md)
# Ativar relatórios de uso de WorkSpaces aplicativos
Para receber relatórios de uso, você os assina usando o console de WorkSpaces aplicativos, o AWS Command Line Interface (AWS CLI) ou a operação da `CreateUsageReportSubscription` API. Você deve habilitar os relatórios de uso separadamente para cada AWS região da qual deseja receber dados de uso.
**nota**
É possível iniciar ou interromper sua assinatura dos relatórios de uso a qualquer momento. Não há cobrança pela assinatura dos relatórios de uso, mas cobranças padrão do Amazon S3 podem ser aplicáveis aos relatórios que são armazenados no seu bucket do S3. Para obter mais informações, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/).
Para assinar relatórios de uso de WorkSpaces aplicativos usando o console de WorkSpaces aplicativos, execute as etapas a seguir.
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Escolha a AWS região para a qual você deseja ativar os relatórios de uso.
1. No painel de navegação, escolha **Usage Reports (Relatórios de uso)**.
1. Selecione **Habilitado** e, em seguida, selecione **Aplicar**.
Se você habilitou os scripts de sessão na instância e o registro no Amazon S3 para sua configuração de script de sessão WorkSpaces , os aplicativos criaram um bucket do S3 para armazenar a saída do script. O bucket é exclusivo para sua conta e sua região. Quando você ativa os relatórios de uso nesse caso, os WorkSpaces aplicativos usam o mesmo bucket para armazenar seus relatórios de uso. Se você ainda não habilitou os scripts de sessão na instância, ao habilitar os relatórios de uso, o WorkSpaces Applications cria um novo bucket do S3 no seguinte local:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
***region-code***
O código AWS da região na qual os relatórios de uso estão habilitados.
***account-id-without-hyphens***
O identificador de sua conta da Amazon Web Services. O ID aleatório garante que não haja conflitos com outros buckets na mesma região. A primeira parte do nome do bucket, `appstream-logs`, não é alterada entre contas ou regiões.
Por exemplo, se você habilitar os relatórios de uso na região Oeste dos EUA (Oregon) (us-west-2) na conta número 123456789012 WorkSpaces , os aplicativos criarão um bucket Amazon S3 em sua conta nessa região semelhante ao nome mostrado no exemplo a seguir:
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
Somente um administrador com permissões suficientes pode excluir esse bucket.
**Topics**
+ [WorkSpaces Relatórios de sessões de aplicativos](usage-report-types-sessions-reports.md)
+ [WorkSpaces Aplicativos Relatórios de aplicativos](usage-report-types-applications-reports.md)
# WorkSpaces Relatórios de sessões de aplicativos
Para cada dia em que os usuários iniciam pelo menos uma sessão de streaming em sua conta da Amazon Web Services, o WorkSpaces Applications exporta um relatório de sessões para seu bucket do Amazon S3. O relatório, chamado **daily-session-report- [YYYY] - [MM] - [DD] .csv**, é armazenado em uma estrutura de pastas aninhada na sua conta Amazon S3, usando o seguinte caminho de pasta:
[nome\$1do\$1balde]/sessions/schedule=DAILY/year=[YYYY]/month=[MM]/day= [DD]/
Essa estrutura de agrupamento facilita o particionamento caso você opte por consultar os relatórios usando o Amazon Athena. O Athena é um serviço de consulta interativo com tecnologia sem servidor que você pode usar para analisar dados armazenados em buckets do S3 usando SQL padrão. Para obter mais informações, consulte [Crie relatórios personalizados e analise dados de uso de WorkSpaces aplicativos](configure-custom-reports-analyze-usage-data.md).
Cada sessão de usuário é descrita em um único registro em um relatório de sessões. Os relatórios de sessões são gerados diariamente, de acordo com o horário UTC, dentro de 24 horas após o fechamento do dia que é o assunto do relatório. Se uma sessão abranger mais de um dia, o registro da sessão aparecerá no relatório de sessões correspondente ao dia em que a sessão terminar. Para obter informações sobre os dados incluídos em relatórios de sessões, consulte [Campos do relatório de sessões](usage-reports-fields-sessions-reports.md).
# WorkSpaces Aplicativos Relatórios de aplicativos
Para cada dia em que os usuários iniciam pelo menos um aplicativo durante suas sessões de streaming, o WorkSpaces Applications exporta um relatório de aplicativos para seu bucket do Amazon S3. O relatório, chamado **daily-app-report- [YYYY] - [MM] - [DD] .csv**, é armazenado em uma estrutura de pastas aninhada na sua conta Amazon S3, usando o seguinte caminho de pasta:
[nome\$1do\$1balde]/applications/schedule=DAILY/year=[YYYY]/month=[MM]/day= [DD]/
Essa estrutura de agrupamento facilita o particionamento caso você opte por consultar os relatórios usando o Amazon Athena. O Athena é um serviço de consulta interativo com tecnologia sem servidor que você pode usar para analisar dados armazenados em buckets do S3 usando SQL padrão. Para obter mais informações, consulte [Crie relatórios personalizados e analise dados de uso de WorkSpaces aplicativos](configure-custom-reports-analyze-usage-data.md).
Cada inicialização de aplicativo é descrita em um único registro em um relatório de aplicativos. Por exemplo, se um usuário iniciar cinco aplicativos separados durante uma sessão, cinco registros separados serão exibidos no relatório de aplicativos relevante. Um aplicativo será registrado como iniciado se qualquer um dos seguintes eventos ocorrer:
+ O aplicativo é iniciado diretamente quando a sessão começa, pois o ID do aplicativo é incorporado ao URL de streaming ou ao estado de retransmissão.
+ Um usuário escolhe o aplicativo no catálogo de aplicativos ao iniciar uma nova sessão de streaming.
+ Um usuário escolhe o aplicativo na lista do catálogo de aplicativos durante uma sessão de streaming.
O relatório de aplicativos não inclui aplicativos que sejam iniciados de outras maneiras. Por exemplo, se você fornecer aos usuários acesso ao Windows Explorer ou ao menu **Iniciar** da área de trabalho do Windows e os usuários usarem essas ferramentas para iniciar aplicativos diretamente, ou se outro programa ou script iniciar um aplicativo, essas inicializações de aplicativos não serão incluídas no relatório de aplicativos. PowerShell
Os relatórios de aplicativos são gerados diariamente, de acordo com o horário UTC, dentro de 24 horas após o fechamento do dia que é o assunto do relatório. Se uma sessão abranger mais de um dia, os aplicativos iniciados durante a sessão serão refletidos no relatório de aplicativos correspondente ao dia em que a sessão é encerrada. Para obter informações sobre os dados incluídos em relatórios de aplicativos, consulte [Campos do relatório de aplicativos](usage-reports-fields-applications-reports.md).
# WorkSpaces Campos de relatórios de uso de aplicativos
Este tópico fornece informações sobre os campos incluídos nos relatórios de uso de WorkSpaces aplicativos.
**Topics**
+ [Campos do relatório de sessões](usage-reports-fields-sessions-reports.md)
+ [Campos do relatório de aplicativos](usage-reports-fields-applications-reports.md)
# Campos do relatório de sessões
A tabela a seguir descreve os campos incluídos nos relatórios de sessões de WorkSpaces aplicativos.
| Nome do campo | Description |
| --- | --- |
| user\$1session\$1id | O identificador (ID) exclusivo da sessão. |
| aws\$1account\$1id | O ID da conta da Amazon Web Services. |
| region | A AWS região. |
| session\$1start\$1time | A data e a hora em que a sessão foi iniciada. Deve ser especificada no formato ISO 8601 e como UTC. |
| session\$1end\$1time | A data e a hora em que a sessão foi encerrada. Deve ser especificada no formato ISO 8601 e como UTC. |
| session\$1duration\$1in\$1seconds | A duração da sessão em segundos. |
| user\$1id | O ID exclusivo do usuário no tipo de autenticação. |
| user\$1arn | O nome de recurso da Amazon (ARN) do usuário. |
| authentication\$1type | O método usado para autenticar o usuário. Valores possíveis: `CUSTOM` \$1 `SAML` \$1 `USERPOOL` |
| authentication\$1type\$1user\$1id | A concatenação do ID de usuário e do tipo de autenticação, que identificam o usuário de forma exclusiva para fins de avaliação das taxas de usuário. Para obter mais informações, consulte [Preços de WorkSpaces aplicativos](https://aws.amazon.com/appstream2/pricing/). |
| fleet\$1name | O nome da frota associada à sessão. |
| stack\$1name | O nome da pilha associada à sessão. |
| instance\$1type | O tipo de instância de WorkSpaces aplicativos usado para a sessão. Para ver uma lista de tipos de instância, consulte [Preços de WorkSpaces aplicativos](https://aws.amazon.com/appstream2/pricing/). |
| eni\$1private\$1ip\$1address | O endereço IP da interface de rede elástica usada pela instância de WorkSpaces aplicativos para comunicações de rede. |
| connected\$1at\$1least\$1once | Indica se o usuário se conectou à sessão pelo menos uma vez. Valores possíveis: `true` \$1 `false` |
| client\$1ip\$1addresses | Os endereços IP associados ao dispositivo do usuário ou aos dispositivos usados para conectar-se à sessão. Se o usuário se conectar e se desconectar da sessão mais de uma vez, até os últimos 10 endereços IP distintos serão armazenados, separados por ponto-e-vírgula. |
| google\$1drive\$1enabled | Indica se o Google Drive foi habilitado como uma opção de armazenamento persistente para a sessão. Para obter mais informações, consulte [Ative e administre o Google Drive para os usuários de seus WorkSpaces aplicativos](google-drive.md). Valores possíveis: `true` \$1 `false` |
| one\$1drive\$1enabled | Indica se OneDrive foi habilitado como uma opção de armazenamento persistente para a sessão. Para obter mais informações, consulte [Ative e administre o Google Drive para os usuários de seus WorkSpaces aplicativos](google-drive.md). Valores possíveis: `true` \$1 `false` |
| home\$1folders\$1storage\$1location | O bucket do Amazon S3 usado para arquivos que são armazenados em pastas base. |
| user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device | Indica se o usuário foi capaz de copiar dados do dispositivo local para a sessão de streaming usando a área de transferência durante a sessão. Valores possíveis: `ENABLED` \$1 `DISABLED` |
| user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device | Indica se o usuário foi capaz de copiar dados da sessão de streaming para o dispositivo local usando a área de transferência durante a sessão. Valores possíveis: `ENABLED` \$1 `DISABLED` |
| user\$1settings\$1file\$1upload | Indica se o usuário foi capaz de fazer upload de arquivos do dispositivo local para a sessão de streaming durante a sessão. Valores possíveis: `ENABLED` \$1 `DISABLED` |
| user\$1settings\$1file\$1download | Indica se o usuário foi capaz de fazer download de arquivos da sessão de streaming para o dispositivo local durante a sessão. Valores possíveis: `ENABLED` \$1 `DISABLED` |
| user\$1settings\$1printing\$1to\$1local\$1device | Indica se o usuário foi capaz de imprimir arquivos da sessão de streaming para o dispositivo local durante a sessão. Valores possíveis: `ENABLED` \$1 `DISABLED` |
| application\$1settings\$1enabled | Indica se a persistência das configurações do aplicativo foi habilitada para a sessão. Valores possíveis: `true` \$1 `false` |
| domain\$1joined | Indica se a instância de streaming de WorkSpaces aplicativos foi associada a um domínio do Active Directory na inicialização da sessão. Para obter mais informações, consulte [Usando o Active Directory com WorkSpaces aplicativos](active-directory.md). Valores possíveis: `Y` \$1 `N` |
| max\$1session\$1duration | A duração máxima permitida da sessão em segundos. |
| session\$1type | O tipo de sessão. Valores possíveis: `ALWAYS_ON` \$1 `ON_DEMAND` |
| stream\$1view | A visualização de streaming. Valores possíveis: `APPLICATION` \$1 `DESKTOP` |
| streaming\$1experience\$1settings\$1protocol | O protocolo com o qual a sessão terminou o streaming. Valores possíveis: `UDP` \$1 `TCP` |
| instance\$1id | O ID de instância associado à sessão do usuário. |
| is\$1multisession | Indica se a sessão pertence a uma frota multissessão. Valores possíveis: `true` \$1 `false` |
# Campos do relatório de aplicativos
A tabela a seguir descreve os campos incluídos nos relatórios de WorkSpaces aplicativos.
| Nome do campo | Description |
| --- | --- |
| user\$1session\$1id | O identificador (ID) exclusivo da sessão. |
| application\$1name | O nome do aplicativo, conforme especificado no Image Assistant. Esse valor é fornecido quando um usuário inicia um aplicativo por meio da interface de WorkSpaces aplicativos. |
| agendamento | A frequência com que os relatórios são gerados. Valor possível: DAILY |
| ano | O ano do relatório. |
| mês | O mês do relatório. |
| dia | O dia do relatório. |
# Crie relatórios personalizados e analise dados de uso de WorkSpaces aplicativos
O Amazon Athena é um serviço de consulta interativo com tecnologia sem servidor que você pode usar para analisar dados armazenados em buckets do S3 usando consultas SQL padrão. Você pode usar o Athena para agregar relatórios de uso ou gerar outros tipos de relatórios personalizados.
**Topics**
+ [Crie um AWS Glue rastreador](configure-custom-reports-create-crawler.md)
+ [Crie um catálogo de dados usando o AWS Glue rastreador](configure-custom-reports-create-data-catalog.md)
+ [Criar e executar consultas do Athena](configure-custom-reports-create-run-athena-queries.md)
+ [Trabalhar com consultas do Athena](configure-custom-reports-example-sql-queries.md)
# Crie um AWS Glue rastreador
AWS Glue é um serviço de extração, transformação e carregamento (ETL) totalmente gerenciado que permite criar um banco de dados a partir dos dados do Amazon S3 e consultar esse banco de dados usando o Athena. Esse banco de dados também é conhecido como Catálogo AWS Glue de Dados. Um AWS Glue rastreador pode detectar automaticamente o esquema dos seus dados do Amazon S3 e criar o banco de dados e as tabelas correspondentes. WorkSpaces Os aplicativos fornecem um CloudFormation modelo que você pode usar para criar os AWS Glue recursos necessários.
**Importante**
A conclusão das etapas do procedimento a seguir cria um AWS Glue rastreador. Porém, estas etapas não iniciam o crawler. Para iniciar o crawler, você deve executar as etapas do próximo procedimento. Para obter mais informações sobre AWS Glue rastreadores, consulte [Definindo](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) rastreadores.
**Para criar um AWS Glue rastreador**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2/casa](https://console.aws.amazon.com/appstream2/home).
1. Escolha a AWS região para a qual você se inscreveu para receber relatórios de uso.
1. No painel de navegação, escolha **Usage Reports (Relatórios de uso)** e verifique se o registro em log está habilitado.
1. Na guia **Detalhes do relatório**, no parágrafo ao lado do **Analytics**, escolha o link do **CloudFormationmodelo**.
A escolha do link abre o CloudFormation console, onde você pode revisar os parâmetros da CloudFormation pilha especificada pelo modelo antes de executá-la. O modelo, quando executado, cria um AWS Glue rastreador e vários exemplos de consultas do Athena.
1. Na página **Especificar detalhes**, ao lado de **ScheduleExpression**, mantenha o valor padrão ou especifique um valor de expressão cron diferente para a frequência com que você deseja executar o rastreador. Não altere nenhum outro valor padrão. Quando concluir, selecione **Próximo**.
Por padrão, o crawler está programado para ser executado diariamente, mas você pode configurar o crawler para ser executado semanalmente, mensalmente ou com outra frequência. Para obter informações sobre a sintaxe cron, consulte [Expressões cron](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions).
1. Na página **Options (Opções)**, mantenha os valores padrão e escolha **Next (Próximo)**.
1. Na página de **revisão**, marque a caixa de seleção ao lado de “Eu reconheço que CloudFormation pode criar recursos do IAM com nomes personalizados” e, em seguida, escolha **Criar**.
Você deve ter permissões AWS Glue e AWS Identity and Access Management (IAM) suficientes para criar e executar a CloudFormation pilha. Se você não tiver as permissões necessárias, peça ao administrador da sua conta da Amazon Web Services para executar essas etapas na sua conta ou conceder as permissões a seguir.
------
#### [ 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"
}
]
}
```
------
# Crie um catálogo de dados usando o AWS Glue rastreador
O AWS Glue rastreador, quando executado, cria um catálogo de dados e um esquema que são mapeados para a estrutura de suas sessões e relatórios de aplicativos. Cada vez que um novo relatório é armazenado em seu bucket do Amazon S3, você deve executar o rastreador para atualizar seu catálogo de AWS Glue dados com os dados do novo relatório.
**nota**
Cobranças podem ser aplicadas à operação do seu AWS Glue rastreador. Para obter mais informações, consulte [AWS Glue Preço](https://aws.amazon.com/glue/pricing/).
1. Abra o AWS Glue console em [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/).
1. Escolha a AWS região para a qual você se inscreveu para receber relatórios de uso.
1. Marque a caixa de seleção ao lado do rastreador chamado **appstream-usage-sessions-crawler**e escolha **Executar** rastreador. Repita essa etapa para o rastreador chamado. **appstream-usage-apps-crawler**
A execução dessas etapas executa os rastreadores e os programa para serem executados automaticamente de acordo com a programação especificada na pilha. CloudFormation
1. Quando a execução de ambos os crawlers estiver concluída, no painel de navegação, escolha **Databases (Bancos de dados)**. É exibido um banco de dados chamado **appstream-usage**, que representa seus relatórios de uso. Esse banco de AWS Glue dados é um catálogo de dados que foi criado quando **appstream-usage-sessions-crawler**e **appstream-usage-apps-crawler**foi executado.
1. Para visualizar as tabelas no banco de dados, escolha **appstream-usage**, **Tables (Tabelas)**. Duas tabelas, **applications (aplicativos)** e **sessions (sessões)**, que representam seus relatórios de uso de aplicativos e sessões, respectivamente, são exibidas. Escolha uma tabela para visualizar o respectivo esquema.
Agora você pode consultar essas tabelas no Athena usando SQL.
# Criar e executar consultas do Athena
Para consultar os relatórios de uso usando o Athena, execute as etapas a seguir.
**nota**
Podem ser cobrados encargos pelas consultas do Athena que você executar. Para obter mais informações, consulte [Preços do Amazon Athena](https://aws.amazon.com/athena/pricing/).
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).
1. Em **Database (Banco de dados)**, escolha **appstream-usage**.
1. No painel de consulta, insira uma consulta SQL e escolha **Run query (Executar consulta)**.
# Trabalhar com consultas do Athena
Esta seção fornece consultas SQL que você pode executar no Athena para analisar dados de relatórios de uso no seu bucket do Amazon S3.
Para criar um relatório consolidado de todas as sessões em um determinado mês, execute a seguinte consulta:
```
SELECT *
FROM "appstream-usage"."sessions"
WHERE year='four-digit-year'
AND month='two-digit-month'
```
Você também pode executar operações de junção entre as tabelas **applications **e **sessions** na sua consulta. Por exemplo, para visualizar os diferentes usuários que iniciaram cada aplicativo em um determinado mês, execute a seguinte 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
```
Os resultados de consultas do Athena são armazenados como arquivos .csv em um bucket do Amazon S3 em sua conta chamada `aws-athena-query-results-account-id-without-hyphens-region-code`. Para facilitar a localização dos resultados da consulta, escolha **Save as (Salvar como)** e forneça um nome para sua consulta antes de executá-la. Você também pode escolher o ícone de download no painel **Resultados do Athena** para fazer download dos resultados da consulta como um arquivo .csv.
Para melhorar a performance e reduzir os custos, o Athena usa o particionamento para reduzir a quantidade de dados verificados em consultas. Para obter mais informações, consulte [Particionar dados](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). Os relatórios de uso são particionados em seus buckets do Amazon S3 por ano, mês e dia. Você pode restringir suas consultas a determinadas partições de intervalos de datas usando os campos **year (ano)**,**month (mês)** e **day (dia)** como condições em suas consultas. Por exemplo, a consulta a seguir consome apenas os relatórios de sessões da semana de 19 de maio 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
```
Por outro lado, a consulta a seguir produz resultados idênticos, mas, como não se restringe a nenhuma partição, ela consome todos os relatórios de sessões armazenados no seu bucket do 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 uma sessão abranger mais de um dia, os registros de sessão e aplicativo serão exibidos em relatórios de sessões e aplicativos, respectivamente, de acordo com o dia em que a sessão terminou. Por esse motivo, se você precisar encontrar registros relacionados a todas as sessões que estiveram ativas durante um determinado intervalo de datas, considere expandir o conjunto de partições da sua consulta pela duração máxima de sessão que você tiver configurado para suas frotas.
Por exemplo, para visualizar todas as sessões que estavam ativas para uma determinada frota durante um mês, em que a frota tinha uma duração máxima de sessão de 100 horas, execute a consulta a seguir para expandir seu conjunto de partições em cinco dias.
```
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
```
O CloudFormation modelo que criou os AWS Glue rastreadores também criou e salvou vários exemplos de consultas em sua conta do Athena que você pode usar para analisar seus dados de uso. Essas consultas de exemplo incluem o seguinte:
+ Relatório mensal de sessões agregadas
+ Duração média de sessão por pilha
+ Número de sessões por dia
+ Total de horas de streaming por usuário
**nota**
As cobranças de uso sob demanda são arredondadas para a próxima hora em cada sessão.
+ Usuários distintos por aplicativo
Para usar qualquer uma dessas consultas, execute as etapas a seguir.
1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/).
1. Escolha **Saved Queries (Consultas salvas)**. As cinco consultas apontadas antes deste procedimento devem ser exibidas. O nome de cada consulta começa com "”AS2. Por exemplo, "AS2\$1users\$1per\$1app\$1curr\$1mo”.
1. Para executar uma consulta, escolha o nome da consulta, em vez de a opção ao lado do nome.
1. O texto da consulta é exibido no painel de consulta. Selecione **Executar consulta**.
*Para ver essas consultas em um CloudFormation modelo separado, consulte [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) no Catálogo de amostras de código.AWS *