

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

# Mengambil metrik dengan API Wawasan Performa
<a name="performance-insights-metrics"></a>

Saat Wawasan Kinerja diaktifkan, API menyediakan visibilitas ke dalam kinerja instans. Amazon CloudWatch Logs menyediakan sumber otoritatif untuk metrik pemantauan yang dijual untuk AWS layanan.

Wawasan Performa menawarkan tampilan spesifik domain dari muatan basis data yang diukur sebagai sesi aktif rata-rata (AAS). Metrik ini muncul sebagai set data deret waktu dua dimensi bagi konsumen API. Dimensi waktu data menyediakan data muatan DB untuk setiap titik waktu dalam rentang waktu yang dikueri. Setiap titik waktu menguraikan keseluruhan muatan dalam hubungannya dengan dimensi yang diminta, seperti `Query`, `Wait-state`, `Application`, atau `Host`, yang diukur pada titik waktu tersebut.

Amazon DocumentDB Performance Insights memantau instans DB Amazon DocumentDB Anda sehingga Anda dapat menganalisis dan memecahkan masalah kinerja database. Salah satu cara untuk menampilkan data Wawasan Performa dapat ditemukan di Konsol Manajemen AWS. Wawasan Performa juga menyediakan API publik sehingga Anda dapat mengueri data Anda sendiri. Anda dapat menggunakan API untuk melakukan tindakan berikut:
+ Membongkar data ke dalam basis data
+ Menambahkan data Wawasan Performa ke dasbor pemantauan yang ada
+ Merancang alat pemantauan

Untuk menggunakan Performance Insights API, aktifkan Performance Insights di salah satu instans Amazon DocumentDB Anda. Untuk informasi tentang cara mengaktifkan Wawasan Performa, lihat [Mengaktifkan dan menonaktifkan Wawasan Kinerja](performance-insights-enabling.md). Untuk informasi selengkapnya tentang Performance Insights API, lihat Referensi API [ Performance Insights](https://docs.aws.amazon.com/performance-insights/latest/APIReference/Welcome.html).

API Wawasan Performa menyediakan operasi berikut.



|  Tindakan Wawasan Performa  |  AWS CLI perintah  |  Deskripsi  | 
| --- | --- | --- | 
| [`DescribeDimensionKeys`](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html) | [`aws pi describe-dimension-keys`](https://docs.aws.amazon.com/cli/latest/reference/pi/describe-dimension-keys.html) | Mengambil kunci dimensi N teratas untuk metrik dalam jangka waktu tertentu. | 
| [`GetDimensionKeyDetails`](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html) | [`aws pi get-dimension-key-details`](https://docs.aws.amazon.com/cli/latest/reference/pi/get-dimension-key-details.html) | Mengambil atribut dari grup dimensi tertentu untuk instans DB atau sumber data. Misalnya, jika Anda menentukan ID kueri, dan jika detail dimensi tersedia, `GetDimensionKeyDetails` mengambil teks lengkap dimensi yang `db.query.statement` terkait dengan ID ini. Operasi ini berguna karena `GetResourceMetrics` dan `DescribeDimensionKeys` tidak mendukung pengambilan teks pernyataan kueri besar.  | 
| [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html) | [`aws pi get-resource-metadata`](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metadata.html) | Mengambil metadata untuk fitur yang berbeda. Misalnya, metadata mungkin menunjukkan bahwa fitur diaktifkan atau dinonaktifkan pada instans DB tertentu.  | 
| [`GetResourceMetrics`](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html) | [`aws pi get-resource-metrics`](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html) | Mengambil metrik Wawasan Performa untuk sekumpulan sumber data, selama periode waktu tertentu. Anda dapat menyediakan grup dimensi dan dimensi tertentu, serta memberikan kriteria penggabungan dan pemfilteran untuk setiap grup. | 
| [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html) | [`aws pi list-available-resource-dimensions`](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-dimensions.html) | Mengambil dimensi yang dapat dikueri untuk setiap jenis metrik yang ditentukan pada instans tertentu.  | 
| [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html) | [`aws pi list-available-resource-metrics`](https://docs.aws.amazon.com/cli/latest/reference/pi/list-available-resource-metrics.html) | Mengambil semua metrik jenis metrik tertentu yang tersedia yang dapat dikueri untuk instans DB tertentu. | 

**Topics**
+ [AWS CLI untuk Wawasan Kinerja](#performance-insights-metrics-CLI)
+ [Mengambil metrik deret waktu](#performance-insights-metrics-time-series)
+ [AWS CLI contoh untuk Performance Insights](#performance-insights-metrics-api-examples)

## AWS CLI untuk Wawasan Kinerja
<a name="performance-insights-metrics-CLI"></a>

Anda dapat melihat data Wawasan Performa menggunakan AWS CLI. Anda dapat menampilkan bantuan untuk perintah AWS CLI untuk Wawasan Performa dengan memasukkan berikut ini di baris perintah.

```
aws pi help
```

Jika Anda belum menginstal, lihat AWS CLI Meng [ instal Antarmuka Bar AWS is Perintah ](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) di Panduan *AWS CLI Pengguna * untuk informasi tentang menginstalnya.

## Mengambil metrik deret waktu
<a name="performance-insights-metrics-time-series"></a>

Operasi `GetResourceMetrics` mengambil satu atau beberapa metrik deret waktu dari data Wawasan Performa. `GetResourceMetrics` memerlukan metrik dan periode waktu, dan menampilkan respons dengan daftar poin data. 

Misalnya, penggunaan untuk Konsol Manajemen AWS mengisi `GetResourceMetrics` bagan ** Counter Metrics dan ** bagan ** Database Lo ** ad, seperti yang terlihat pada gambar berikut.

![Bagan Metrik Penghitung dan Muatan Basis Data](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/performance-insights/perf-insights-api-charts.png)


Semua metrik yang ditampilkan oleh `GetResourceMetrics` adalah metrik deret waktu standar, dengan pengecualian `db.load`. Metrik ini ditampilkan dalam bagan **Muatan Basis Data**. Metrik `db.load` berbeda dengan metrik deret waktu lainnya karena Anda dapat membaginya menjadi beberapa sub-komponen yang disebut *dimensi*. Di gambar sebelumnya, `db.load` dibagi dan dikelompokkan berdasarkan status tunggu yang membentuk `db.load`.

**catatan**  
`GetResourceMetrics` juga dapat menampilkan metrik `db.sampleload`, tetapi metrik `db.load` sesuai di sebagian besar kasus.

Untuk informasi tentang metrik penghitung yang ditampilkan oleh `GetResourceMetrics`, lihat [Wawasan Kinerja untuk metrik penghitung](performance-insights-counter-metrics.md).

Penghitungan berikut didukung untuk metrik:
+ Rata-rata – Nilai rata-rata untuk metrik selama periode waktu tertentu. Tambahkan `.avg` ke nama metrik.
+ Minimum – Nilai minimum metrik selama periode waktu tertentu. Tambahkan `.min` ke nama metrik.
+ Maksimum – Nilai maksimum metrik selama periode waktu tertentu. Tambahkan `.max` ke nama metrik.
+ Jumlah – Jumlah nilai metrik selama periode waktu tertentu. Tambahkan `.sum` ke nama metrik.
+ Jumlah sampel – Frekuensi pengumpulan metrik selama periode waktu tertentu. Tambahkan `.sample_count` ke nama metrik.

Sebagai contoh, misalkan sebuah metrik dikumpulkan selama 300 detik (5 menit), dan metrik tersebut dikumpulkan satu kali setiap menit. Nilai untuk setiap menit adalah 1, 2, 3, 4, dan 5. Dalam kasus ini, penghitungan berikut ditampilkan:
+ Rata-rata – 3
+ Minimum – 1
+ Maksimum – 5
+ Jumlah – 15
+ Jumlah sampel – 5

Untuk informasi tentang menggunakan `get-resource-metrics` AWS CLI perintah, lihat [`get-resource-metrics`](https://docs.aws.amazon.com/cli/latest/reference/pi/get-resource-metrics.html).

Untuk opsi `--metric-queries`, tentukan satu atau beberapa kueri yang diinginkan untuk mendapatkan hasil. Setiap kueri terdiri dari `Metric` wajib dan `GroupBy` opsional serta parameter `Filter`. Berikut ini adalah contoh spesifikasi opsi `--metric-queries`.

```
{
   "Metric": "string",
   "GroupBy": {
     "Group": "string",
     "Dimensions": ["string", ...],
     "Limit": integer
   },
   "Filter": {"string": "string"
     ...}
```

## AWS CLI contoh untuk Performance Insights
<a name="performance-insights-metrics-api-examples"></a>

Contoh berikut menunjukkan cara menggunakan untuk W AWS CLI awasan Kinerja.

**Topics**
+ [Mengambil metrik penghitung](#performance-insights-metrics-api-examples.CounterMetrics)
+ [Mengambil rata-rata beban DB untuk status tunggu teratas](#performance-insights-metrics-api-examples.DBLoadAverage)
+ [Mengambil rata-rata beban DB untuk Kueri teratas](#performance-insights-metrics-api-examples.topquery)
+ [Mengambil rata-rata beban DB yang difilter oleh Query](#performance-insights-metrics-api-examples.DBLoadAverageByQuery)

### Mengambil metrik penghitung
<a name="performance-insights-metrics-api-examples.CounterMetrics"></a>

Tangkapan layar berikut menunjukkan dua bagan metrik penghitung dalam Konsol Manajemen AWS.

![Bagan Metrik Penghitung.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/performance-insights/perf-insights-api-counters-charts.png)


Contoh berikut menunjukkan cara mengumpulkan data yang sama yang digunakan oleh Konsol Manajemen AWS untuk menghasilkan dua bagan metrik penghitung.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type DOCDB \
   --identifier db-{{ID}} \
   --start-time {{2022-03-13T8:00:00Z}} \
   --end-time   {{2022-03-13T9:00:00Z}} \
   --period-in-seconds {{60}} \
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type DOCDB ^
   --identifier db-{{ID}} ^
   --start-time {{2022-03-13T8:00:00Z}} ^
   --end-time   {{2022-03-13T9:00:00Z}} ^
   --period-in-seconds {{60}} ^
   --metric-queries '[{"Metric": "os.cpuUtilization.user.avg"  },
                      {"Metric": "os.cpuUtilization.idle.avg"}]'
```

Anda juga dapat membuat perintah menjadi lebih mudah dibaca dengan menentukan file untuk opsi `--metrics-query`. Contoh berikut menggunakan file yang disebut query.json untuk opsi tersebut. File memiliki konten berikut.

```
[
    {
        "Metric": "os.cpuUtilization.user.avg"
    },
    {
        "Metric": "os.cpuUtilization.idle.avg"
    }
]
```

Jalankan perintah berikut untuk menggunakan file.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type DOCDB \
   --identifier db-{{ID}} \
   --start-time {{2022-03-13T8:00:00Z}} \
   --end-time   {{2022-03-13T9:00:00Z}} \
   --period-in-seconds {{60}} \
   --metric-queries file://{{query.json}}
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type DOCDB ^
   --identifier db-{{ID}} ^
   --start-time {{2022-03-13T8:00:00Z}} ^
   --end-time   {{2022-03-13T9:00:00Z}} ^
   --period-in-seconds {{60}} ^
   --metric-queries file://{{query.json}}
```

Contoh sebelumnya menentukan nilai-nilai berikut untuk opsi:
+ `--service-type`— `DOCDB` untuk Amazon DocumentDB
+ `--identifier` – ID sumber daya untuk instans DB
+ `--start-time` dan `--end-time` – Nilai `DateTime` ISO 8601 untuk periode kueri, dengan berbagai format yang didukung

Ini akan dikueri selama rentang waktu satu jam:
+ `--period-in-seconds` – `60` untuk kueri per menit
+ `--metric-queries` – Rangkaian dua kueri, masing-masing hanya untuk satu metrik.

  Nama metrik menggunakan titik untuk mengklasifikasikan metrik dalam kategori yang berguna, dengan elemen terakhir sebagai fungsi. Dalam contoh, fungsinya adalah `avg` untuk setiap kueri. Seperti Amazon CloudWatch, fungsi yang didukung adalah`min`,`max`,`total`, dan`avg`.

Responsnya terlihat seperti berikut.

```
{
    "AlignedStartTime": "2022-03-13T08:00:00+00:00",
    "AlignedEndTime": "2022-03-13T09:00:00+00:00",
    "Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
    "MetricList": [
        {
            "Key": {
                "Metric": "os.cpuUtilization.user.avg"
            },
            "DataPoints": [
                {
                    "Timestamp": "2022-03-13T08:01:00+00:00", //Minute1
                    "Value": 3.6
                },
                {
                    "Timestamp": "2022-03-13T08:02:00+00:00", //Minute2
                    "Value": 2.6
                },
                //.... 60 datapoints for the os.cpuUtilization.user.avg metric
        {
            "Key": {
                "Metric": "os.cpuUtilization.idle.avg"
            },
            "DataPoints": [
                {
                    "Timestamp": "2022-03-13T08:01:00+00:00",
                    "Value": 92.7
                },
                {
                    "Timestamp": "2022-03-13T08:02:00+00:00",
                    "Value": 93.7
                },
                //.... 60 datapoints for the os.cpuUtilization.user.avg metric 
            ]
        }
    ] //end of MetricList
} //end of response
```

Respons ini memiliki `Identifier`, `AlignedStartTime`, dan `AlignedEndTime`. B nilai `--period-in-seconds` adalah `60`, waktu mulai dan akhir telah disesuaikan dengan menit. Jika `--period-in-seconds` adalah `3600`, waktu mulai dan akhir akan disesuaikan dengan jam.

`MetricList` dalam respons memiliki sejumlah entri, masing-masing dengan entri `Key` dan `DataPoints`. Masing-masing `DataPoint` memiliki `Timestamp` dan `Value`. Masing-masing daftar `Datapoints` memiliki 60 poin data karena kueri tersebut adalah untuk data per menit selama satu jam, dengan `Timestamp1/Minute1`, `Timestamp2/Minute2`, dan seterusnya, hingga `Timestamp60/Minute60`. 

Karena kueri tersebut adalah untuk dua metrik penghitung yang berbeda, ada dua elemen dalam respons `MetricList`.

### Mengambil rata-rata beban DB untuk status tunggu teratas
<a name="performance-insights-metrics-api-examples.DBLoadAverage"></a>

Contoh berikut adalah kueri yang sama yang digunakan Konsol Manajemen AWS untuk menghasilkan grafik garis area bertumpuk. Contoh ini mengambil `db.load.avg` untuk jam terakhir dengan beban dibagi menurut tujuh status tunggu teratas. Perintah ini sama dengan perintah dalam [Mengambil metrik penghitung](#performance-insights-metrics-api-examples.CounterMetrics). Namun, file query.json berisi konten berikut.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_state", "Limit": 7 }
    }
]
```

Jalankan perintah berikut.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type DOCDB \
   --identifier db-{{ID}} \
   --start-time {{2022-03-13T8:00:00Z}} \
   --end-time   {{2022-03-13T9:00:00Z}} \
   --period-in-seconds {{60}} \
   --metric-queries file://{{query.json}}
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type DOCDB ^
   --identifier db-{{ID}} ^
   --start-time {{2022-03-13T8:00:00Z}} ^
   --end-time   {{2022-03-13T9:00:00Z}} ^
   --period-in-seconds {{60}} ^
   --metric-queries file://{{query.json}}
```

Contoh menentukan metrik `db.load.avg` dan a `GroupBy` dari tujuh status tunggu teratas. Untuk detail tentang nilai yang valid untuk contoh ini, lihat [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) dalam *Referensi API Wawasan Kinerja.*

Responsnya terlihat seperti berikut.

```
{
    "AlignedStartTime": "2022-04-04T06:00:00+00:00",
    "AlignedEndTime": "2022-04-04T06:15:00+00:00",
    "Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
    "MetricList": [
        {//A list of key/datapoints
            "Key": {
                //A Metric with no dimensions. This is the total db.load.avg
                "Metric": "db.load.avg"
            },
            "DataPoints": [
                //Each list of datapoints has the same timestamps and same number of items
                {
                    "Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
                    "Value": 0.0
                },
                {
                    "Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
                    "Value": 0.0
                },
                //... 60 datapoints for the total db.load.avg key
                ]
        },
        {
            "Key": {
                //Another key. This is db.load.avg broken down by CPU
                "Metric": "db.load.avg",
                "Dimensions": {
                    "db.wait_state.name": "CPU"
                }
            },
            "DataPoints": [
                {
                    "Timestamp": "2022-04-04T06:01:00+00:00",//Minute1
                    "Value": 0.0
                },
                {
                    "Timestamp": "2022-04-04T06:02:00+00:00",//Minute2
                    "Value": 0.0
                },
                //... 60 datapoints for the CPU key
            ]
        },//... In total we have 3 key/datapoints entries, 1) total, 2-3) Top Wait States
    ] //end of MetricList
} //end of response
```

Dalam tanggapan ini, ada tiga entri di`MetricList`. Ada satu entri untuk total`db.load.avg`, dan tiga entri masing-masing untuk `db.load.avg` dibagi menurut salah satu dari tiga status tunggu teratas. Karena ada dimensi pengelompokan (tidak seperti contoh pertama), harus ada satu kunci untuk setiap pengelompokan metrik. Tidak boleh hanya ada satu kunci untuk setiap metrik, seperti dalam kasus penggunaan metrik penghitung dasar.

### Mengambil rata-rata beban DB untuk Kueri teratas
<a name="performance-insights-metrics-api-examples.topquery"></a>

Contoh berikut mengelompok `db.wait_state` kan berdasarkan 10 pernyataan kueri teratas. Ada dua kelompok berbeda untuk pernyataan kueri:
+ `db.query`— Pernyataan kueri lengkap, seperti `{"find":"customers","filter":{"FirstName":"Jesse"},"sort":{"key":{"$numberInt":"1"}}}`
+ `db.query_tokenized`— Pernyataan kueri yang diberi token, seperti `{"find":"customers","filter":{"FirstName":"?"},"sort":{"key":{"$numberInt":"?"}},"limit":{"$numberInt":"?"}}`

Saat menganalisis kinerja database, akan berguna untuk mempertimbangkan pernyataan kueri yang hanya berbeda dengan parameternya sebagai satu item logika. Jadi, Anda dapat menggunakan `db.query_tokenized` saat melakukan kueri. Namun, terutama ketika Anda tertarik`explain()`, terkadang lebih berguna untuk memeriksa pernyataan kueri lengkap dengan parameter. Ada hubungan orangtua-anak antara kueri token dan kueri penuh, dengan beberapa kueri penuh (anak) dikelompokkan di bawah kueri token yang sama (induk).

Perintah dalam contoh ini terlihat seperti perintah dalam [Mengambil rata-rata beban DB untuk status tunggu teratas](#performance-insights-metrics-api-examples.DBLoadAverage). Namun, file query.json berisi konten berikut.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.query_tokenized", "Limit": 10 }
    }
]
```

Contoh berikut menggunakan `db.query_tokenized`.

Untuk Linux, macOS, atau Unix:

```
aws pi get-resource-metrics \
   --service-type DOCDB \
   --identifier db-{{ID}} \
   --start-time {{2022-03-13T8:00:00Z}} \
   --end-time   {{2022-03-13T9:00:00Z}} \
   --period-in-seconds {{3600}} \
   --metric-queries file://{{query.json}}
```

Untuk Windows:

```
aws pi get-resource-metrics ^
   --service-type DOCDB ^
   --identifier db-{{ID}} ^
   --start-time {{2022-03-13T8:00:00Z}} ^
   --end-time   {{2022-03-13T9:00:00Z }} ^
   --period-in-seconds {{3600}} ^
   --metric-queries file://{{query.json}}
```

Contoh ini meminta lebih dari 1 jam, dengan periode satu menit dalam detik.

Contoh menentukan metrik `db.load.avg` dan a `GroupBy` dari tujuh status tunggu teratas. Untuk detail tentang nilai yang valid untuk contoh ini, lihat [DimensionGroup](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DimensionGroup.html) dalam *Referensi API Wawasan Kinerja.*

Responsnya terlihat seperti berikut.

```
{
    "AlignedStartTime": "2022-04-04T06:00:00+00:00",
    "AlignedEndTime": "2022-04-04T06:15:00+00:00",
    "Identifier": "db-NQF3TTMFQ3GTOKIMJODMC3KQQ4",
    "MetricList": [
        {//A list of key/datapoints
            "Key": {
                "Metric": "db.load.avg"
            },
            "DataPoints": [
                //... 60 datapoints for the total db.load.avg key
                ]
        },
               {
            "Key": {//Next key are the top tokenized queries
                "Metric": "db.load.avg",
                "Dimensions": {
                    "db.query_tokenized.db_id": "pi-1064184600",
                    "db.query_tokenized.id": "77DE8364594EXAMPLE",
                    "db.query_tokenized.statement": "{\"find\":\"customers\",\"filter\":{\"FirstName\":\"?\"},\"sort\":{\"key\":{\"$numberInt\":\"?\"}},\"limit\"
:{\"$numberInt\":\"?\"},\"$db\":\"myDB\",\"$readPreference\":{\"mode\":\"primary\"}}"
                }
            },
            "DataPoints": [
            //... 60 datapoints 
            ]
        },
        // In total 11 entries, 10 Keys of top tokenized queries, 1 total key 
    ] //End of MetricList
} //End of response
```

Respons ini memiliki 11 entri dalam `MetricList` (total 1, 10 kueri token teratas), dengan setiap entri memiliki 24 per jam. `DataPoints`

Untuk kueri token, ada tiga entri di setiap daftar dimensi:
+ `db.query_tokenized.statement`— Pernyataan kueri yang ditokenisasi.
+ `db.query_tokenized.db_id `— ID sintetis yang dihasilkan oleh Performance Insights untuk Anda. Contoh ini menampilkan ID sintetis `pi-1064184600`.
+ `db.query_tokenized.id` – ID kueri di dalam Wawasan Performa.

  Di dalamnya Konsol Manajemen AWS, ID ini disebut ID Dukungan. Ini dinamai ini karena ID adalah data yang dapat AWS diperiksa Dukungan untuk membantu Anda memecahkan masalah dengan database Anda. AWS mengambil keamanan dan privasi data Anda dengan sangat serius, dan hampir semua data disimpan terenkripsi dengan data Anda AWS KMS key. Oleh karena itu, tidak ada AWS orang di dalam yang dapat melihat data ini. Di contoh sebelumnya, baik `tokenized.statement` maupun `tokenized.db_id` disimpan dengan enkripsi. Jika Anda memiliki masalah dengan database Anda, AWS Dukungan dapat membantu Anda dengan merujuk ID Dukungan.

Ketika melakukan kueri, mungkin lebih mudah untuk menentukan `Group` dalam `GroupBy`. Namun, untuk kontrol lebih mendetail atas data yang ditampilkan, tentukan daftar dimensi. Misalnya, jika yang dibutuhkan hanya `db.query_tokenized.statement`, atribut `Dimensions` dapat ditambahkan ke file query.json.

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group": "db.query_tokenized",
            "Dimensions":["db.query_tokenized.statement"],
            "Limit": 10
        }
    }
]
```

### Mengambil rata-rata beban DB yang difilter oleh Query
<a name="performance-insights-metrics-api-examples.DBLoadAverageByQuery"></a>

Kueri API terkait dalam contoh ini sama seperti perintah di [Mengambil rata-rata beban DB untuk Kueri teratas](#performance-insights-metrics-api-examples.topquery). Namun, file query.json berisi konten berikut.

```
[
 {
        "Metric": "db.load.avg",
        "GroupBy": { "Group": "db.wait_state", "Limit": 5  }, 
        "Filter": { "db.query_tokenized.id": "AKIAIOSFODNN7EXAMPLE" }
    }
]
```

Dalam respons ini, semua nilai difilter sesuai dengan kontribusi kueri token AKIAIOSFODN7EXAMPLE yang ditentukan dalam file query.json. Kunci juga mungkin mengikuti urutan yang berbeda dari kueri tanpa filter, karena itu adalah lima status tunggu teratas yang memengaruhi kueri yang difilter.