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

# Buat dasbor dengan AWS CLI
<a name="lake-dashboard-cli-create"></a>

Bagian ini menjelaskan cara menggunakan `create-dashboard` perintah untuk membuat dasbor kustom atau dasbor Sorotan.

Saat menggunakan AWS CLI, ingatlah bahwa perintah Anda berjalan di Wilayah AWS konfigurasi untuk profil Anda. Jika Anda ingin menjalankan perintah di Wilayah yang berbeda, ubah Wilayah default untuk profil Anda, atau gunakan parameter `--region` bersama perintah tersebut.

 CloudTrail menjalankan kueri untuk mengisi widget dasbor selama penyegaran manual atau terjadwal. CloudTrail harus diberikan izin untuk menjalankan `StartQuery` operasi pada setiap penyimpanan data peristiwa yang terkait dengan widget dasbor. Untuk memberikan izin, jalankan `put-resource-policy` perintah untuk melampirkan kebijakan berbasis sumber daya ke setiap penyimpanan data peristiwa, atau edit kebijakan penyimpanan data peristiwa di konsol. CloudTrail Untuk contoh kebijakan, lihat [Contoh: CloudTrail Izinkan menjalankan kueri untuk menyegarkan dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard). 

 Untuk mengatur jadwal penyegaran, CloudTrail harus diberikan izin untuk menjalankan `StartDashboardRefresh` operasi untuk menyegarkan dasbor atas nama Anda. Untuk memberikan izin, jalankan `put-resource-policy` operasi untuk melampirkan kebijakan berbasis sumber daya ke dasbor, atau edit kebijakan dasbor di konsol. CloudTrail Untuk contoh kebijakan, lihat [Contoh kebijakan berbasis sumber daya untuk dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards). 

**Topics**
+ [Buat dasbor khusus dengan AWS CLI](#lake-dashboard-cli-create-custom)
+ [Aktifkan dasbor Sorotan dengan AWS CLI](#lake-dashboard-cli-create-highlights)
+ [Lihat properti untuk widget](lake-widget-properties.md)

## Buat dasbor khusus dengan AWS CLI
<a name="lake-dashboard-cli-create-custom"></a>

Prosedur berikut menunjukkan cara membuat dasbor khusus, melampirkan kebijakan berbasis sumber daya yang diperlukan ke penyimpanan data peristiwa dan dasbor, dan memperbarui dasbor untuk mengatur dan mengaktifkan jadwal penyegaran.

1. Jalankan `create-dashboard` untuk membuat dasbor.

   Saat Anda membuat dasbor khusus, Anda dapat meneruskan array dengan hingga 10 widget. Widget menyediakan representasi grafis dari hasil untuk kueri. Setiap widget terdiri dari`ViewProperties`,`QueryStatement`, dan`QueryParameters`.
   + `ViewProperties`- Menentukan properti untuk jenis tampilan. Untuk informasi selengkapnya, lihat [Lihat properti untuk widget](lake-widget-properties.md).
   + `QueryStatement`— Kueri CloudTrail berjalan saat dasbor di-refresh. Anda dapat melakukan kueri di beberapa penyimpanan data peristiwa selama penyimpanan data acara ada di akun Anda.
   + `QueryParameters`— `QueryParameters` Nilai-nilai berikut didukung untuk dasbor kustom:`$Period$`,`$StartTime$`, dan`$EndTime$`. Untuk menggunakan `QueryParameters` place a `?` di `QueryStatement` mana Anda ingin mengganti parameter. CloudTrail akan mengisi parameter saat kueri dijalankan.

   Contoh berikut membuat dashboard dengan empat widget, salah satu dari setiap jenis tampilan.
**catatan**  
Dalam contoh ini, `?` dikelilingi dengan tanda kutip tunggal karena digunakan dengan`eventTime`. Bergantung pada sistem operasi yang Anda jalankan, Anda mungkin perlu mengelilingi tanda kutip tunggal dengan tanda kutip melarikan diri. Untuk informasi selengkapnya, lihat [Menggunakan tanda kutip dan literal dengan string di. AWS CLI](https://docs.aws.amazon.com/cli/v1/userguide/cli-usage-parameters-quoting-strings.html)

   ```
   aws cloudtrail create-dashboard --name AccountActivityDashboard \
   --widgets '[
       {
         "ViewProperties": {
           "Height": "2",
           "Width": "4",
           "Title": "TopErrors",
           "View": "Table"
         },
         "QueryStatement": "SELECT errorCode, COUNT(*) AS eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' AND (errorCode is not null) GROUP BY errorCode ORDER BY eventCount DESC LIMIT 100",
         "QueryParameters": ["$StartTime$", "$EndTime$"]
       },
       {
         "ViewProperties": {
           "Height": "2",
           "Width": "4",
           "Title": "MostActiveRegions",
           "View": "PieChart",
           "LabelColumn": "awsRegion",
           "ValueColumn": "eventCount",
           "FilterColumn": "awsRegion"
         },
         "QueryStatement": "SELECT awsRegion, COUNT(*) AS eventCount FROM eds where eventTime > '?' and eventTime < '?' GROUP BY awsRegion ORDER BY eventCount LIMIT 100",
         "QueryParameters": ["$StartTime$", "$EndTime$"]
       },
       {
         "ViewProperties": {
           "Height": "2",
           "Width": "4",
           "Title": "AccountActivity",
           "View": "LineChart",
           "YAxisColumn": "eventCount",
           "XAxisColumn": "eventDate",
           "FilterColumn": "readOnly"
         },
         "QueryStatement": "SELECT DATE_TRUNC('?', eventTime) AS eventDate, IF(readOnly, 'read', 'write') AS readOnly, COUNT(*) as eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY DATE_TRUNC('?', eventTime), readOnly ORDER BY DATE_TRUNC('?', eventTime), readOnly",
         "QueryParameters": ["$Period$", "$StartTime$", "$EndTime$", "$Period$", "$Period$"]
       },
       {
         "ViewProperties": {
           "Height": "2",
           "Width": "4",
           "Title": "TopServices",
           "View": "BarChart",
           "LabelColumn": "service",
           "ValueColumn": "eventCount",
           "FilterColumn": "service",
           "Orientation": "Horizontal"
         },
         "QueryStatement": "SELECT REPLACE(eventSource, '.amazonaws.com') AS service, COUNT(*) AS eventCount FROM eds WHERE eventTime > '?' AND eventTime < '?' GROUP BY eventSource ORDER BY eventCount DESC LIMIT 100",
         "QueryParameters": ["$StartTime$", "$EndTime$"]
       }
     ]'
   ```

1. Buat file terpisah dengan kebijakan sumber daya yang diperlukan untuk setiap penyimpanan data peristiwa yang disertakan dalam widget`QueryStatement`. Beri nama file*policy.json*, dengan contoh pernyataan kebijakan berikut:

    Ganti *123456789012* dengan ID akun Anda, *arn:aws:cloudtrail:us-east-1:123456789012:dashboard/exampleDashboard* dengan ARN dasbor.

   Untuk informasi selengkapnya tentang kebijakan berbasis sumber daya untuk dasbor, lihat. [Contoh: CloudTrail Izinkan menjalankan kueri untuk menyegarkan dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard)

1. Jalankan `put-resource-policy` perintah untuk melampirkan kebijakan. Anda juga dapat memperbarui kebijakan berbasis sumber daya penyimpanan data peristiwa di konsol. CloudTrail 

   Contoh berikut melampirkan kebijakan berbasis sumber daya ke penyimpanan data peristiwa. 

   ```
   aws cloudtrail put-resource-policy \
   --resource-arn eds-arn \
   --resource-policy file://policy.json
   ```

1. Jalankan `put-resource-policy` perintah untuk melampirkan kebijakan berbasis sumber daya ke dasbor. Untuk contoh kebijakan, lihat [Contoh kebijakan berbasis sumber daya untuk dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   Contoh berikut melampirkan kebijakan berbasis sumber daya ke dasbor. Ganti *account-id* dengan ID akun Anda dan *dashboard-arn* dengan ARN dasbor.

   ```
   aws cloudtrail put-resource-policy \
   --resource-arn dashboard-arn \
   --resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "DashboardPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartDashboardRefresh", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}}]}'
   ```

1. Jalankan `update-dashboard` perintah untuk mengatur dan mengaktifkan jadwal penyegaran dengan mengonfigurasi `--refresh-schedule` parameter.

   `--refresh-schedule`Terdiri dari parameter opsional berikut:
   + `Frequency`— `Value` Untuk `Unit` dan untuk jadwal.

     Untuk dasbor khusus, unit dapat berupa `HOURS` atau`DAYS`.

      Untuk dasbor kustom, nilai berikut valid ketika unit adalah`HOURS`:`1`,,`6`, `12` `24` 

     Untuk dasbor khusus, satu-satunya nilai yang valid saat unit `DAYS` adalah`1`.
   + `Status`- Menentukan apakah jadwal refresh diaktifkan. Tetapkan nilainya `ENABLED` untuk mengaktifkan jadwal penyegaran, atau `DISABLED` untuk mematikan jadwal penyegaran. 
   + `TimeOfDay `— Waktu hari di UTC untuk menjalankan jadwal; untuk per jam hanya mengacu pada menit; default adalah 00:00.

   Contoh berikut menetapkan jadwal refresh untuk setiap enam jam dan memungkinkan jadwal.

   ```
   aws cloudtrail update-dashboard --dashboard-id AccountActivityDashboard \
   --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'
   ```

## Aktifkan dasbor Sorotan dengan AWS CLI
<a name="lake-dashboard-cli-create-highlights"></a>

Prosedur berikut menunjukkan cara membuat dasbor Sorotan, melampirkan kebijakan berbasis sumber daya yang diperlukan ke penyimpanan data acara dan dasbor, dan memperbarui dasbor untuk mengatur dan mengaktifkan jadwal penyegaran.

1. Jalankan `create-dashboard` perintah untuk membuat dasbor Sorotan. Untuk membuat dasbor ini, `--name` harus`AWSCloudTrail-Highlights`.

   ```
   aws cloudtrail create-dashboard --name AWSCloudTrail-Highlights
   ```

1. Untuk setiap penyimpanan data peristiwa di akun Anda, jalankan `put-resource-policy` perintah untuk melampirkan kebijakan berbasis sumber daya ke penyimpanan data peristiwa. Anda juga dapat memperbarui kebijakan berbasis sumber daya penyimpanan data peristiwa di konsol. CloudTrail Untuk contoh kebijakan, lihat [Contoh: CloudTrail Izinkan menjalankan kueri untuk menyegarkan dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-eds-dashboard).

   Contoh berikut melampirkan kebijakan berbasis sumber daya ke penyimpanan data peristiwa. Ganti *account-id* dengan ID akun Anda, *eds-arn* dengan ARN penyimpanan data acara, dan *dashboard-arn* dengan ARN dasbor.

   ```
   aws cloudtrail put-resource-policy \
   --resource-arn eds-arn \
   --resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "EDSPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartQuery", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}} ]}'
   ```

1. Jalankan `put-resource-policy` perintah untuk melampirkan kebijakan berbasis sumber daya ke dasbor. Untuk contoh kebijakan, lihat [Contoh kebijakan berbasis sumber daya untuk dasbor](security_iam_resource-based-policy-examples.md#security_iam_resource-based-policy-examples-dashboards).

   Contoh berikut melampirkan kebijakan berbasis sumber daya ke dasbor. Ganti *account-id* dengan ID akun Anda dan *dashboard-arn* dengan ARN dasbor.

   ```
   aws cloudtrail put-resource-policy \
   --resource-arn dashboard-arn \
   --resource-policy '{"Version": "2012-10-17",		 	 	  "Statement": [{"Sid": "DashboardPolicy", "Effect": "Allow", "Principal": { "Service": "cloudtrail.amazonaws.com" }, "Action": "cloudtrail:StartDashboardRefresh", "Condition": { "StringEquals": { "AWS:SourceArn": "dashboard-arn", "AWS:SourceAccount": "account-id"}}}]}'
   ```

1. Jalankan `update-dashboard` perintah untuk mengatur dan mengaktifkan jadwal penyegaran dengan mengonfigurasi `--refresh-schedule` parameter. Untuk dasbor Sorotan, satu-satunya yang valid `UNIT` adalah `HOURS` dan satu-satunya yang valid `Value` adalah`6`.

   ```
   aws cloudtrail update-dashboard --dashboard-id AWSCloudTrail-Highlights \
   --refresh-schedule '{"Frequency": {"Unit": "HOURS", "Value": 6}, "Status": "ENABLED"}'
   ```