

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# WorkSpaces Laporan Penggunaan Aplikasi
<a name="configure-usage-reports"></a>

Anda dapat berlangganan laporan penggunaan WorkSpaces Aplikasi Amazon untuk menerima laporan terperinci tentang bagaimana pengguna Anda menggunakan layanan ini. Dua file.csv diekspor ke bucket Amazon Simple Storage Service (Amazon S3) di akun Anda setiap hari. 

**catatan**  
Untuk mengaktifkan laporan penggunaan WorkSpaces Aplikasi, Anda harus menggunakan gambar yang menggunakan versi agen WorkSpaces Aplikasi yang dirilis pada atau setelah 7 Mei 2019.

**Topics**
+ [Aktifkan Laporan Penggunaan WorkSpaces Aplikasi](enable-usage-reports.md)
+ [WorkSpaces Bidang Laporan Penggunaan Aplikasi](usage-reports-fields.md)
+ [Buat Laporan Kustom dan Analisis Data Penggunaan WorkSpaces Aplikasi](configure-custom-reports-analyze-usage-data.md)

# Aktifkan Laporan Penggunaan WorkSpaces Aplikasi
<a name="enable-usage-reports"></a>

Untuk menerima laporan penggunaan, Anda berlangganan laporan tersebut dengan menggunakan WorkSpaces Applications console, AWS Command Line Interface (AWS CLI), atau operasi `CreateUsageReportSubscription` API. Anda harus mengaktifkan laporan penggunaan secara terpisah untuk setiap AWS Wilayah yang ingin Anda terima data penggunaannya.

**catatan**  
Anda dapat memulai atau menghentikan langganan Anda ke laporan penggunaan kapan saja. Tidak ada biaya untuk berlangganan laporan penggunaan, tetapi biaya Amazon S3 standar mungkin berlaku untuk laporan yang disimpan di bucket S3 Anda. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).

Untuk berlangganan laporan penggunaan WorkSpaces Aplikasi dengan menggunakan konsol WorkSpaces Aplikasi, lakukan langkah-langkah berikut. 

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).

1. Pilih AWS Wilayah yang ingin Anda aktifkan laporan penggunaan.

1. Di panel navigasi, pilih **Laporan Penggunaan**.

1. Pilih **Diaktifkan**, lalu pilih **Terapkan**.

Jika Anda mengaktifkan skrip sesi on-instance dan pencatatan Amazon S3 untuk konfigurasi skrip sesi WorkSpaces , Aplikasi membuat bucket S3 untuk menyimpan output skrip. Bucket unik untuk akun dan Wilayah Anda. Jika Anda mengaktifkan pelaporan penggunaan dalam kasus ini, WorkSpaces Aplikasi menggunakan bucket yang sama untuk menyimpan laporan penggunaan Anda. Jika Anda belum mengaktifkan skrip sesi on-instance, saat mengaktifkan laporan penggunaan, WorkSpaces Aplikasi akan membuat bucket S3 baru di lokasi berikut:

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

***region-code***  
Kode AWS Region untuk Wilayah tempat pelaporan penggunaan diaktifkan.

***account-id-without-hyphens***  
Pengenal akun Amazon Web Services Anda. ID acak memastikan bahwa tidak ada konflik dengan bucket lain di Wilayah yang sama. Bagian pertama dari nama bucket,`appstream-logs`, tidak berubah di seluruh akun atau Wilayah.

Misalnya, jika Anda mengaktifkan pelaporan penggunaan di Wilayah AS Barat (Oregon) (us-west-2) pada nomor akun 123456789012 WorkSpaces , Aplikasi akan membuat bucket Amazon S3 dalam akun Anda di Wilayah tersebut mirip dengan nama yang ditunjukkan pada contoh berikut: 

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

Hanya administrator dengan izin yang cukup yang dapat menghapus bucket ini.

**Topics**
+ [WorkSpaces Laporan Sesi Aplikasi](usage-report-types-sessions-reports.md)
+ [WorkSpaces Laporan Aplikasi Aplikasi](usage-report-types-applications-reports.md)

# WorkSpaces Laporan Sesi Aplikasi
<a name="usage-report-types-sessions-reports"></a>

Untuk setiap hari pengguna meluncurkan setidaknya satu sesi streaming di akun Amazon Web Services Anda, WorkSpaces Aplikasi mengekspor laporan sesi ke bucket Amazon S3 Anda. Laporan, bernama **daily-session-report- [YYYY] - [MM] - [DD] .csv**, disimpan dalam struktur folder bersarang di akun Amazon S3 Anda, menggunakan jalur folder berikut:

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

Struktur bersarang ini memfasilitasi partisi jika Anda memilih untuk menanyakan laporan Anda dengan menggunakan Amazon Athena. Athena adalah layanan kueri interaktif tanpa server yang dapat Anda gunakan untuk menganalisis data yang disimpan dalam bucket S3 Anda menggunakan SQL standar. Untuk informasi selengkapnya, lihat [Buat Laporan Kustom dan Analisis Data Penggunaan WorkSpaces Aplikasi](configure-custom-reports-analyze-usage-data.md).

Setiap sesi pengguna dijelaskan dalam satu catatan dalam laporan sesi. Laporan sesi dibuat setiap hari sesuai dengan waktu UTC dalam waktu 24 jam setelah penutupan hari yang menjadi subjek laporan. Jika sesi berlangsung lebih dari satu hari, catatan sesi muncul dalam laporan sesi yang sesuai dengan hari di mana sesi berakhir. Untuk informasi tentang data yang disertakan dalam laporan sesi, lihat[Bidang Laporan Sesi](usage-reports-fields-sessions-reports.md). 

# WorkSpaces Laporan Aplikasi Aplikasi
<a name="usage-report-types-applications-reports"></a>

Untuk setiap hari pengguna meluncurkan setidaknya satu aplikasi selama sesi streaming mereka, WorkSpaces Aplikasi mengekspor laporan aplikasi ke bucket Amazon S3 Anda. Laporan, bernama **daily-app-report- [YYYY] - [MM] - [DD] .csv**, disimpan dalam struktur folder bersarang di akun Amazon S3 Anda, menggunakan jalur folder berikut:

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

Struktur bersarang ini memfasilitasi partisi jika Anda memilih untuk menanyakan laporan Anda dengan menggunakan Amazon Athena. Athena adalah layanan kueri interaktif tanpa server yang dapat Anda gunakan untuk menganalisis data yang disimpan dalam bucket S3 Anda menggunakan SQL standar. Untuk informasi selengkapnya, lihat [Buat Laporan Kustom dan Analisis Data Penggunaan WorkSpaces Aplikasi](configure-custom-reports-analyze-usage-data.md).

Setiap peluncuran aplikasi dijelaskan dalam satu catatan dalam laporan aplikasi. Misalnya, jika pengguna meluncurkan lima aplikasi terpisah selama sesi, lima catatan terpisah muncul dalam laporan aplikasi yang relevan. Aplikasi dicatat sebagai diluncurkan jika salah satu dari peristiwa berikut terjadi:
+ Aplikasi diluncurkan langsung ketika sesi dimulai, karena ID aplikasi disematkan di URL streaming atau status relai.
+ Seorang pengguna memilih aplikasi dari katalog aplikasi saat meluncurkan sesi streaming baru.
+ Seorang pengguna memilih aplikasi dari daftar katalog aplikasi selama sesi streaming.

Laporan aplikasi tidak menyertakan aplikasi yang diluncurkan dengan cara lain. Misalnya, jika Anda memberi pengguna akses ke Windows Explorer, PowerShell, atau menu **Start** desktop Windows, dan pengguna menggunakan alat tersebut untuk meluncurkan aplikasi secara langsung, atau jika program atau skrip lain meluncurkan aplikasi, peluncuran aplikasi tersebut tidak termasuk dalam laporan aplikasi.

Laporan aplikasi dibuat setiap hari sesuai dengan waktu UTC dalam waktu 24 jam setelah penutupan hari yang menjadi subjek laporan. Jika sesi berlangsung lebih dari satu hari, aplikasi yang diluncurkan selama sesi tercermin dalam laporan aplikasi yang sesuai dengan hari di mana sesi berakhir. Untuk informasi tentang data yang disertakan dalam laporan aplikasi, lihat[Bidang Laporan Aplikasi](usage-reports-fields-applications-reports.md). 

# WorkSpaces Bidang Laporan Penggunaan Aplikasi
<a name="usage-reports-fields"></a>

Topik ini memberikan informasi tentang bidang yang disertakan dalam laporan penggunaan WorkSpaces Aplikasi.

**Topics**
+ [Bidang Laporan Sesi](usage-reports-fields-sessions-reports.md)
+ [Bidang Laporan Aplikasi](usage-reports-fields-applications-reports.md)

# Bidang Laporan Sesi
<a name="usage-reports-fields-sessions-reports"></a>

Tabel berikut menjelaskan bidang yang disertakan dalam laporan sesi WorkSpaces Aplikasi.


| Nama bidang | Deskripsi | 
| --- | --- | 
| user\$1session\$1id | Pengenal unik (ID) untuk sesi tersebut. | 
| aws\$1account\$1id | ID akun Amazon Web Services. | 
| region |  AWS Wilayah. | 
| session\$1start\$1time |  Tanggal dan waktu sesi dimulai. Harus ditentukan dalam format ISO 8601 dan sebagai UTC.  | 
| session\$1end\$1time |  Tanggal dan waktu sesi berakhir. Harus ditentukan dalam format ISO 8601 dan sebagai UTC.  | 
| session\$1duration\$1in\$1seconds | Durasi sesi dalam hitungan detik. | 
| user\$1id | ID unik untuk pengguna dalam jenis otentikasi. | 
| user\$1arn | Nama Sumber Daya Amazon (ARN) untuk pengguna. | 
| authentication\$1type |  Metode yang digunakan untuk mengautentikasi pengguna. Nilai yang mungkin: `CUSTOM` \$1 `SAML` \$1 `USERPOOL`  | 
| authentication\$1type\$1user\$1id | Penggabungan ID pengguna dan jenis otentikasi, yang secara unik mengidentifikasi pengguna untuk tujuan menilai biaya pengguna. Untuk informasi selengkapnya, lihat [Harga WorkSpaces Aplikasi](https://aws.amazon.com/appstream2/pricing/). | 
| fleet\$1name | Nama armada yang terkait dengan sesi. | 
| stack\$1name | Nama tumpukan yang terkait dengan sesi. | 
| instance\$1type | Jenis instance WorkSpaces Applications yang digunakan untuk sesi. Untuk daftar jenis instans, lihat [Harga WorkSpaces Aplikasi](https://aws.amazon.com/appstream2/pricing/). | 
| eni\$1private\$1ip\$1address | Alamat IP dari elastic network interface yang digunakan oleh instance WorkSpaces Applications untuk komunikasi jaringan. | 
| connected\$1at\$1least\$1once |  Menunjukkan apakah pengguna terhubung ke sesi setidaknya sekali. Nilai yang mungkin: `true` \$1 `false`  | 
| client\$1ip\$1addresses | Alamat IP yang terkait dengan perangkat pengguna atau perangkat yang digunakan untuk terhubung ke sesi. Jika pengguna terhubung dan kemudian terputus dari sesi lebih dari sekali, hingga 10 alamat IP berbeda terakhir disimpan, dipisahkan oleh titik koma. | 
| google\$1drive\$1enabled |  Menunjukkan apakah Google Drive diaktifkan sebagai opsi penyimpanan persisten untuk sesi tersebut. Untuk informasi selengkapnya, lihat [Aktifkan dan Kelola Google Drive untuk Pengguna WorkSpaces Aplikasi Anda](google-drive.md).  Nilai yang mungkin: `true` \$1 `false`  | 
| one\$1drive\$1enabled |  Menunjukkan OneDrive apakah diaktifkan sebagai opsi penyimpanan persisten untuk sesi. Untuk informasi selengkapnya, lihat [Aktifkan dan Kelola Google Drive untuk Pengguna WorkSpaces Aplikasi Anda](google-drive.md).  Nilai yang mungkin: `true` \$1 `false`  | 
| home\$1folders\$1storage\$1location | Bucket Amazon S3 digunakan untuk file yang disimpan menggunakan folder rumah. | 
| user\$1settings\$1clipboard\$1copy\$1from\$1local\$1device |  Menunjukkan apakah pengguna dapat menyalin data dari perangkat lokal ke sesi streaming menggunakan clipboard selama sesi. Nilai yang mungkin: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1clipboard\$1copy\$1to\$1local\$1device |  Menunjukkan apakah pengguna dapat menyalin data dari sesi streaming ke perangkat lokal menggunakan clipboard selama sesi. Nilai yang mungkin: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1file\$1upload |  Menunjukkan apakah pengguna dapat mengunggah file dari perangkat lokal ke sesi streaming selama sesi berlangsung. Nilai yang mungkin: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1file\$1download |  Menunjukkan apakah pengguna dapat mengunduh file dari sesi streaming ke perangkat lokal selama sesi berlangsung. Nilai yang mungkin: `ENABLED` \$1 `DISABLED`  | 
| user\$1settings\$1printing\$1to\$1local\$1device |  Menunjukkan apakah pengguna dapat mencetak file dari sesi streaming ke perangkat lokal selama sesi berlangsung. Nilai yang mungkin: `ENABLED` \$1 `DISABLED`  | 
| application\$1settings\$1enabled |  Menunjukkan apakah persistensi pengaturan aplikasi diaktifkan untuk sesi. Nilai yang mungkin: `true` \$1 `false`  | 
| domain\$1joined |  Menunjukkan apakah instance streaming WorkSpaces Aplikasi digabungkan ke domain Active Directory saat peluncuran sesi. Untuk informasi selengkapnya, lihat [Menggunakan Active Directory dengan WorkSpaces Aplikasi](active-directory.md).  Nilai yang mungkin: `Y` \$1 `N`  | 
| max\$1session\$1duration | Durasi maksimum sesi yang diizinkan, dalam hitungan detik. | 
| session\$1type |  Jenis sesi. Nilai yang mungkin: `ALWAYS_ON` \$1 `ON_DEMAND`  | 
| stream\$1view |  Tampilan aliran. Nilai yang mungkin: `APPLICATION` \$1 `DESKTOP`  | 
| streaming\$1experience\$1settings\$1protocol |  Protokol tempat sesi berakhir streaming. Nilai yang mungkin: `UDP` \$1 `TCP`  | 
| instance\$1id | ID instance yang terkait dengan sesi pengguna. | 
| is\$1multisession |  Menunjukkan apakah sesi tersebut milik armada multi-sesi. Nilai yang mungkin: `true` \$1 `false`  | 

# Bidang Laporan Aplikasi
<a name="usage-reports-fields-applications-reports"></a>

Tabel berikut menjelaskan bidang yang disertakan dalam laporan WorkSpaces aplikasi Aplikasi.


| Nama bidang | Deskripsi | 
| --- | --- | 
| user\$1session\$1id | Pengenal unik (ID) untuk sesi tersebut. | 
| application\$1name | Nama aplikasi, sebagaimana ditentukan dalam Asisten Gambar. Nilai ini diberikan saat pengguna meluncurkan aplikasi melalui antarmuka WorkSpaces Aplikasi.  | 
| jadwal | Frekuensi laporan dihasilkan. Nilai yang mungkin: HARIAN | 
| tahun | Tahun laporan.  | 
| bulan | Bulan laporan.  | 
| hari | Hari laporan.  | 

# Buat Laporan Kustom dan Analisis Data Penggunaan WorkSpaces Aplikasi
<a name="configure-custom-reports-analyze-usage-data"></a>

Amazon Athena adalah layanan kueri interaktif tanpa server yang dapat Anda gunakan untuk menganalisis data yang disimpan di bucket S3 menggunakan kueri SQL standar. Anda dapat menggunakan Athena untuk menggabungkan laporan penggunaan Anda atau membuat jenis laporan kustom lainnya. 

**Topics**
+ [Buat AWS Glue Crawler](configure-custom-reports-create-crawler.md)
+ [Membuat Katalog Data dengan Menggunakan AWS Glue Crawler](configure-custom-reports-create-data-catalog.md)
+ [Buat dan Jalankan Kueri Athena](configure-custom-reports-create-run-athena-queries.md)
+ [Bekerja dengan Athena Queries](configure-custom-reports-example-sql-queries.md)

# Buat AWS Glue Crawler
<a name="configure-custom-reports-create-crawler"></a>

AWS Glue adalah layanan ekstrak, transformasi, dan muat (ETL) yang dikelola sepenuhnya yang memungkinkan Anda membuat database dari data Amazon S3 dan kueri database tersebut dengan menggunakan Athena. Database ini juga disebut sebagai Katalog AWS Glue Data. AWS Glue Crawler dapat secara otomatis mendeteksi skema data Amazon S3 Anda dan membuat database dan tabel yang sesuai. WorkSpaces Aplikasi menyediakan CloudFormation template yang dapat Anda gunakan untuk membuat AWS Glue sumber daya yang diperlukan. 

**penting**  
Menyelesaikan langkah-langkah dalam prosedur berikut akan membuat AWS Glue crawler. Namun, langkah-langkah ini tidak memulai crawler. Untuk memulai crawler, Anda harus melakukan langkah-langkah dalam prosedur selanjutnya. Untuk informasi selengkapnya tentang AWS Glue crawler, lihat [Mendefinisikan](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html) Crawler.

**Untuk membuat AWS Glue crawler**

1. Buka konsol WorkSpaces Aplikasi di [https://console.aws.amazon.com/appstream2/rumah](https://console.aws.amazon.com/appstream2/home).

1. Pilih AWS Wilayah tempat Anda berlangganan laporan penggunaan.

1. Di panel navigasi, pilih **Laporan Penggunaan**, dan verifikasi bahwa pencatatan laporan penggunaan diaktifkan.

1. Pada tab **Laporan Detail**, di paragraf di sebelah **Analytics**, pilih tautan **CloudFormationtemplat**.

   Memilih tautan membuka CloudFormation konsol, tempat Anda dapat meninjau parameter CloudFormation tumpukan yang ditentukan oleh templat sebelum menjalankannya. Template, saat dijalankan, membuat AWS Glue crawler dan beberapa contoh kueri Athena.

1. Pada halaman **Tentukan Detail**, di samping **ScheduleExpression**, simpan nilai default atau tentukan nilai ekspresi cron yang berbeda untuk frekuensi yang Anda inginkan untuk menjalankan crawler. Jangan mengubah nilai default lainnya. Setelah selesai, pilih **Berikutnya**.

   Secara default, crawler dijadwalkan untuk berjalan setiap hari, tetapi Anda dapat mengonfigurasi crawler untuk menjalankan mingguan, bulanan, atau pada frekuensi lain. Untuk informasi tentang sintaks cron, lihat Ekspresi [Cron](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html#CronExpressions).

1. Pada halaman **Opsi**, pertahankan nilai default, dan pilih **Berikutnya**.

1. **Pada halaman **Tinjauan**, pilih kotak centang di samping “Saya mengakui bahwa CloudFormation mungkin membuat sumber daya IAM dengan nama khusus,” lalu pilih Buat.**

   Anda harus memiliki izin AWS Glue dan AWS Identity and Access Management (IAM) yang cukup untuk membuat dan menjalankan tumpukan. CloudFormation Jika Anda tidak memiliki izin yang diperlukan, minta administrator akun Amazon Web Services Anda untuk melakukan langkah-langkah ini di akun Anda atau memberi Anda izin berikut.

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

------

# Membuat Katalog Data dengan Menggunakan AWS Glue Crawler
<a name="configure-custom-reports-create-data-catalog"></a>

 AWS Glue Crawler, saat dijalankan, membuat Katalog Data dan skema yang dipetakan ke struktur sesi dan laporan aplikasi Anda. Setiap kali laporan baru disimpan di bucket Amazon S3, Anda harus menjalankan crawler untuk memperbarui Katalog AWS Glue Data dengan data dari laporan baru. 

**catatan**  
Biaya mungkin berlaku untuk menjalankan AWS Glue crawler Anda. Untuk informasi selengkapnya, silakan lihat [Harga AWS Glue](https://aws.amazon.com/glue/pricing/).

1. Buka AWS Glue konsol di [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/).

1. Pilih AWS Wilayah tempat Anda berlangganan laporan penggunaan.

1. Pilih kotak centang di samping crawler bernama **appstream-usage-sessions-crawler**, lalu pilih **Run crawler**. Ulangi langkah ini untuk crawler bernama **appstream-usage-apps-crawler**. 

   Melakukan langkah-langkah ini menjalankan crawler dan menjadwalkannya untuk berjalan secara otomatis sesuai dengan jadwal yang ditentukan dalam tumpukan. CloudFormation 

1. **Setelah kedua crawler selesai berjalan, di panel navigasi, pilih Databases.** Database bernama **appstream-usage**, yang mewakili laporan penggunaan Anda, ditampilkan. Database ini adalah Katalog AWS Glue Data yang dibuat saat **appstream-usage-sessions-crawler**dan **appstream-usage-apps-crawler**dijalankan.

1. **Untuk melihat tabel dalam database, pilih **appstream-usage**, Tables.** Dua tabel, **aplikasi**, dan **sesi**, yang masing-masing mewakili laporan penggunaan aplikasi dan sesi Anda, ditampilkan. Pilih salah satu tabel untuk melihat skema.

   Anda sekarang dapat query tabel ini di Athena dengan menggunakan SQL.

# Buat dan Jalankan Kueri Athena
<a name="configure-custom-reports-create-run-athena-queries"></a>

Untuk menanyakan laporan penggunaan Anda menggunakan Athena, lakukan langkah-langkah berikut.
**catatan**  
Biaya mungkin berlaku untuk pertanyaan Athena yang Anda jalankan. Untuk informasi selengkapnya, lihat [Harga Amazon Athena](https://aws.amazon.com/athena/pricing/).

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Di bawah **Database**, pilih **appstream-usage**.

1. Di panel kueri, masukkan kueri SQL, dan pilih **Jalankan** kueri.

# Bekerja dengan Athena Queries
<a name="configure-custom-reports-example-sql-queries"></a>

Bagian ini menyediakan kueri SQL yang dapat Anda jalankan di Athena untuk menganalisis data laporan penggunaan di bucket Amazon S3 Anda.

Untuk membuat laporan konsolidasi dari semua sesi di bulan tertentu, jalankan kueri berikut:

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

Anda juga dapat melakukan operasi gabungan antara **aplikasi** dan tabel **sesi** dalam kueri Anda. Misalnya, untuk melihat pengguna berbeda yang meluncurkan setiap aplikasi pada bulan tertentu, jalankan kueri berikut:

```
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
```

Hasil kueri Athena disimpan sebagai file.csv di bucket Amazon S3 di akun Anda yang diberi nama. `aws-athena-query-results-account-id-without-hyphens-region-code` Untuk memudahkan dalam menemukan hasil kueri, pilih **Simpan sebagai** dan berikan nama untuk kueri Anda sebelum menjalankannya. Anda juga dapat memilih ikon unduhan di panel **Hasil Athena untuk mengunduh hasil** kueri sebagai file.csv.

Untuk meningkatkan kinerja dan mengurangi biaya, Athena menggunakan partisi untuk mengurangi jumlah data yang dipindai dalam kueri. Untuk informasi selengkapnya, lihat,[Data partisi](https://docs.aws.amazon.com/athena/latest/ug/partitions.html). Laporan penggunaan dipartisi di bucket Amazon S3 Anda berdasarkan tahun, bulan, dan hari. Anda dapat membatasi kueri Anda ke partisi rentang tanggal tertentu menggunakan bidang **tahun**, **bulan**, dan **hari** sebagai kondisi dalam kueri Anda. Misalnya, kueri berikut hanya menyerap laporan sesi untuk minggu 19 Mei 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
```

Sebaliknya, kueri berikut menghasilkan hasil yang identik, tetapi karena tidak terbatas pada partisi apa pun, kueri ini menyerap semua laporan sesi yang disimpan di bucket Amazon S3 Anda.

```
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
```

Jika sesi berlangsung lebih dari satu hari, sesi dan catatan aplikasi muncul di sesi dan laporan aplikasi, masing-masing, sesuai dengan hari di mana sesi berakhir. Untuk alasan ini, jika Anda perlu menemukan catatan yang berhubungan dengan semua sesi yang aktif selama rentang tanggal tertentu, pertimbangkan untuk memperluas kumpulan partisi kueri Anda dengan panjang sesi maksimum yang telah Anda konfigurasikan untuk armada Anda.

Misalnya, untuk melihat semua sesi yang aktif untuk armada tertentu selama bulan kalender, di mana armada memiliki durasi sesi maksimum 100 jam, jalankan kueri berikut untuk memperluas set partisi Anda selama lima hari.

```
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
```

 CloudFormation Template yang membuat AWS Glue crawler juga membuat dan menyimpan beberapa contoh kueri di akun Athena yang dapat Anda gunakan untuk menganalisis data penggunaan Anda. Contoh kueri ini meliputi yang berikut:
+ Laporan sesi bulanan agregat
+ Panjang sesi rata-rata per tumpukan
+ Jumlah sesi per hari
+ Total jam streaming per pengguna
**catatan**  
Biaya penggunaan sesuai permintaan dibulatkan ke jam berikutnya untuk setiap sesi.
+ Pengguna berbeda per aplikasi

Untuk menggunakan salah satu kueri ini, lakukan langkah-langkah berikut.

1. Buka konsol Athena di [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/).

1. Pilih **Kueri Tersimpan**. Lima pertanyaan yang dicatat sebelum prosedur ini harus ditampilkan. Nama setiap kueri dimulai dengan "AS2.” Misalnya, "AS2\$1users\$1per\$1app\$1curr\$1mo.”

1. Untuk menjalankan kueri, pilih nama kueri daripada opsi di sebelah nama.

1. Teks kueri muncul di panel kueri. Pilih **Run query** (Jalankan kueri).

*Untuk melihat kueri ini dalam CloudFormation templat terpisah, lihat [athena-sample-queries-appstream-usage-data\$1template.yl](https://docs.aws.amazon.com/code-samples/latest/catalog/cloudformation-appstream2-athena-sample-queries-appstream-usage-data_template.yml.html) di Katalog Contoh Kode.AWS *