Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan opsi kueri metrik untuk menanyakan data Wawasan CloudWatch Metrik
**catatan**
Amazon CloudWatch Metrics Insights sedang dalam pratinjau. CloudWatch Fitur Wawasan Metrik terbuka untuk semua. Akun AWS Fitur dapat berubah sewaktu-waktu.
Anda dapat melakukan kueri data Wawasan CloudWatch Metrik dengan memilih `metric query` mode di Editor **kueri metrik**.
CloudWatch Metrics Insights adalah mesin kueri SQL berkinerja tinggi yang kuat yang dapat Anda gunakan untuk menanyakan metrik Anda dalam skala besar. Ini adalah mesin kueri berbasis SQL yang cepat, fleksibel, yang dapat Anda gunakan untuk mengidentifikasi tren dan pola dalam semua CloudWatch metrik Anda secara real time. Ini menggunakan dialek SQL. Untuk informasi selengkapnya tentang sintaks kueri Metrics Insights, lihat. [Sintaks kueri dan kata kunci](#metrics-insights-syntax-keywords)
## Sintaks kueri dan kata kunci
CloudWatch Metrics Insights menggunakan dialek SQL. Contoh berikut menunjukkan sintaks query.
```
SELECT FUNCTION(metricName)
FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ]
[ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ]
[ GROUP BY labelKey [, ...]]
[ ORDER BY FUNCTION() [DESC | ASC] ]
[ LIMIT number]
```
Kata kunci tidak peka huruf besar/kecil, tetapi pengenalnya peka huruf besar/kecil. Pengidentifikasi mencakup nama metrik, ruang nama, dan dimensi.
Tabel berikut menyediakan kata kunci query dan deskripsi mereka.
| Kata Kunci | Deskripsi |
| --- | --- |
| FUNCTION | Wajib. Menentukan fungsi agregat untuk digunakan, dan juga menentukan nama metrik untuk query. Nilai yang valid adalah AVG, COUNT, MAX, MIN, dan SUM. |
| MetricName | Wajib. Misalnya, CPUUtilization. |
| FROM | Wajib. Menentukan sumber metrik. Anda dapat menentukan namespace metrik yang berisi metrik untuk kueri, atau fungsi tabel SCHEMA. Beberapa contoh namespace adalah AWS/EC2 dan. AWS/Lambda |
| SCHEMA | (Opsional) Memfilter hasil kueri untuk hanya menampilkan metrik yang sama persis, atau metrik yang tidak cocok. |
| WHERE | (Opsional) Memfilter hasil untuk hanya menampilkan metrik yang cocok dengan ekspresi yang Anda tentukan. Misalnya, WHERE InstanceType \$1= 'c3.4xlarge'. |
| GROUP BY | (Opsional) Kelompokkan hasil kueri menjadi beberapa deret waktu. Misalnya, GROUP BY ServiceName. |
| ORDER BY | (Opsional) Menentukan urutan deret waktu untuk kembali. Pilihannya adalah ASC danDESC. |
| LIMIT | (Opsional) Membatasi jumlah deret waktu untuk kembali. |
Berikut ini beberapa contohnya:
+
```
SELECT AVG(CPUUtilization) FROM "AWS/EC2"
```
Mencocokkan semua `CPUUtilization` metrik di `AWS/EC2` namespace, mengabaikan dimensinya, dan mengembalikan satu deret waktu gabungan.
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2")
```
Hanya cocok dengan `CPUUtilization` metrik di `AWS/EC2` namespace yang tidak memiliki dimensi yang ditentukan.
+
```
SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId)
```
Hanya cocok dengan `CPUUtilization` metrik yang dilaporkan CloudWatch dengan tepat satu dimensi,`InstanceId`.
+
```
SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer,
AvailabilityZone)
```
Mtches hanya `RequestCount` metrik yang dilaporkan CloudWatch dari `AWS/ApplicationELB` dengan tepat dua dimensi, `LoadBalancer` dan. `AvailabilityZone`
Nilai label harus dilampirkan oleh tanda kutip tunggal.
### Karakter melarikan diri
Dalam kueri, nilai label harus selalu dikurung dengan tanda kutip tunggal. Misalnya, `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`.
Ruang nama metrik, nama metrik, dan kunci label yang berisi karakter selain huruf, angka, dan garis bawah (`_`) harus dikelilingi oleh tanda kutip ganda. Misalnya, `SELECT MAX("My.Metric")`. Jika salah satu dari ini berisi tanda kutip ganda itu sendiri (seperti`Bytes"Input"`), Anda harus menghindari tanda kutip ganda dengan garis miring terbalik, seperti pada. `SELECT AVG("Bytes\"Input\"")` Jika namespace metrik, nama metrik, atau kunci label, berisi kata yang merupakan kata kunci cadangan dalam Metrics Insights, ini juga harus diapit dalam tanda kutip ganda. Sebagai contoh, jika Anda memiliki metrik yang disebut `LIMIT`, Anda akan menggunakan `SELECT AVG("LIMIT")`. Ini juga benar untuk mengapit namespace, nama metrik, atau label dalam tanda kutip ganda bahkan jika itu tidak menyertakan kata kunci yang dicadangkan.
## Mode pembangun dan mode kode
Anda dapat membuat kueri dalam `Builder` mode atau `Code` mode.
**Untuk membuat kueri dalam `Builder` mode**
1. Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel sebelumnya.
1. Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.
**Untuk membuat kueri dalam `Code` mode**
1. Tulis kueri Anda di editor kode.
1. Untuk menjalankan kueri, pilih **Jalankan kueri** di editor kode.
Untuk membuat kueri dalam `builder` mode:
+ Jelajahi dan pilih namespace metrik, nama metrik, filter, grup, dan opsi urutan menggunakan informasi dari tabel di atas.
+ Untuk masing-masing opsi ini, pilih dari daftar opsi yang memungkinkan.
Grafana secara otomatis membuat kueri SQL berdasarkan pilihan Anda.
Untuk membuat kueri dalam `code` mode:
+ Tulis kueri Anda di editor kode.
+ Untuk menjalankan kueri, pilih **kueri Jalankan** pada editor kode.
Editor kode memiliki fitur pelengkapan otomatis bawaan yang memberikan saran untuk kata kunci, agregasi, ruang nama, metrik, label, dan nilai label. Saran ditampilkan saat Anda memasukkan tanda spasi, koma, atau dolar. Anda juga dapat menggunakan kombinasi keyboard`CTRL+Space`.
Editor kode dapat melengkapi kueri secara otomatis. Namun, penggunaan variabel template dalam editor kode dapat mengganggu pelengkapan otomatis.
## CloudWatch Contoh Wawasan Metrik
**catatan**
CloudWatch Wawasan Metrik ada dalam pratinjau terbuka. Pratinjau terbuka untuk semua AWS akun dan Anda tidak perlu meminta akses. Fitur dapat ditambahkan atau diubah sebelum mengumumkan Ketersediaan Umum.
Bagian ini berisi contoh kueri Wawasan CloudWatch Metrik yang berguna yang dapat Anda salin dan gunakan secara langsung atau salin dan modifikasi di editor kueri. Beberapa contoh ini sudah tersedia di konsol, dan Anda dapat mengaksesnya dengan memilih **Tambahkan kueri** di tampilan **Metrik**.
### Contoh EC2
Lihat pemanfaatan CPU per metrik instans
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
```
Lihat rata-rata pemanfaatan CPU di seluruh armada
```
SELECT AVG(CPUUtilization)
FROM SCHEMA("AWS/EC2", InstanceId)
```
Lihat 10 instans dengan pemanfaatan CPU rata-rata tertinggi
```
SELECT MAX(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
LIMIT 10
```
Lihat 10 instans dengan pemanfaatan CPU tertinggi, diurutkan berdasarkan maksimum, dalam urutan menurun
```
SELECT AVG(CPUUtilization)
FROM "AWS/EC2"
GROUP BY InstanceId
ORDER BY MAX() DESC
LIMIT 10
```
Dalam hal ini, CloudWatch agen mengumpulkan CPUUtilization metrik per aplikasi. Kueri ini menyaring rata-rata metrik ini untuk nama aplikasi tertentu.
```
SELECT AVG(CPUUtilization)
FROM "AWS/CWAgent"
WHERE ApplicationName = 'eCommerce'
SELECT AVG(ConcurrentExecutions)
FROM "AWS/Lambda"
```
Lihat waktu eksekusi rata-rata untuk 10 fungsi Lambda teratas, diurutkan berdasarkan maksimum, dalam urutan menurun
```
SELECT AVG(Duration)
FROM "AWS/Lambda"
GROUP BY FunctionName
ORDER BY MAX() DESC
LIMIT 10
```
Lihat maksimum, rata-rata, dan minimum waktu eksekusi Lambda
```
SELECT MAX(Duration)
FROM "AWS/Lambda"
```
### Contoh Penyeimbang Beban Aplikasi
Lihat metrik yang memiliki dimensi **LoadBalancer**dan **AvailabilityZone**
```
SELECT SUM(RequestCount)
FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone)
```
Lihat metrik dengan jumlah koneksi TCP bersamaan yang aktif
```
SELECT AVG(ActiveConnectionCount)
FROM "AWS/ApplicationELB"
```
### Contoh Amazon EBS
Lihat 10 byte tulis rata-rata per volume teratas dalam urutan menurun
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
GROUP BY VolumeId
ORDER BY MAX() DESC
LIMIT 10
```
Lihat rata-rata waktu tulis volume Amazon EBS
```
SELECT AVG(VolumeTotalWriteTime)
FROM "AWS/EBS"
```
Lihat rata-rata waktu idle volume Amazon EBS
```
SELECT AVG(VolumeIdleTime)
FROM "AWS/EBS"
View average burst balance per volume
SELECT AVG(BurstBalance)
FROM "AWS/EBS"
GROUP BY VolumeId
View average read bytes across Amazon EBS volumes
SELECT AVG(VolumeReadBytes)
FROM "AWS/EBS"
```
Lihat rata-rata byte tulis di seluruh volume Amazon EBS
```
SELECT AVG(VolumeWriteBytes)
FROM "AWS/EBS"
```
### Contoh Amazon Simple Storage Service
Lihat grup latensi rata-rata berdasarkan nama bucket
```
SELECT AVG(TotalRequestLatency)
FROM "AWS/S3"
GROUP BY BucketName
```
Lihat rata-rata jumlah objek per ember di semua bucket Amazon S3
```
SELECT AVG(NumberOfObjects)
FROM "AWS/S3"
GROUP BY BucketName
```
### Contoh Amazon Simple Notification Service
A mazon-simple-notificaation-service -contoh
```
SELECT AVG(NumberOfMessagesPublished)
FROM "AWS/SNS"
```
Melihat rata-rata jumlah pesan yang gagal untuk setiap nama topik
```
SELECT AVG(NumberOfNotificationsFailed)
FROM "AWS/SNS"
GROUP BY TopicName
```
### AWS Contoh penggunaan API
Lihat 20 teratas AWS APIs dengan jumlah panggilan di akun Anda
```
SELECT COUNT(CallCount)
FROM "AWS/Usage"
WHERE "Type" = 'API'
GROUP BY "Service", "Resource"
ORDER BY SUM() DESC
LIMIT 20
```
## CloudWatch Batas Wawasan Metrik
CloudWatch Metrics Insights saat ini memiliki batasan berikut:
+ Anda hanya dapat menanyakan tiga jam data terbaru.
+ Satu kueri dapat memproses tidak lebih dari 10.000 metrik. Ini berarti bahwa jika `WHERE` klausa `SELECT``FROM`,, dan cocok dengan lebih dari 10.000 metrik, hanya 10.000 metrik pertama yang ditemukan yang akan diproses oleh kueri.
+ Satu kueri dapat mengembalikan tidak lebih dari 500 deret waktu. Ini berarti bahwa jika kueri memproses lebih dari 500 metrik, tidak semua metrik akan dikembalikan dalam hasil kueri. Jika Anda menggunakan `ORDER BY` klausa, maka semua metrik yang sedang diproses akan diurutkan dan 500 yang memiliki nilai tertinggi atau terendah sesuai dengan `ORDER BY` klausa Anda akan dikembalikan. Jika Anda tidak menyertakan `ORDER BY` klausa, Anda tidak dapat mengontrol 500 metrik pencocokan mana yang dikembalikan.
+ Setiap `GetMetricData` operasi hanya dapat memiliki satu kueri, tetapi Anda dapat memiliki beberapa widget di dasbor yang masing-masing menyertakan kueri.