Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Metrik kueri dengan PromQL
Topik
catatan
Penyerapan metrik OTLP, kueri PromQL, OTel pengayaan AWS metrik yang dijual, dan Query Studio dalam rilis pratinjau publik, gratis, dan dapat berubah sewaktu-waktu.
Apa itu Prometheus Query Language (PromQL)?
Prometheus Query Language (PromQL) adalah bahasa kueri fungsional yang memungkinkan Anda memilih, menggabungkan, dan mengubah data deret waktu secara real time. PromQL awalnya dirancang untuk Prometheus dan telah menjadi bahasa kueri populer untuk metrik.
Amazon CloudWatch mendukung PromQL untuk menanyakan metrik termasuk metrik yang dicerna melalui OpenTelemetry Line Protocol (OTLP) dan metrik vended yang diperkaya.AWS Saat Anda mengonsumsi metrik OTLP, CloudWatch pertahankan struktur semantik lengkap telemetri Anda, termasuk atribut sumber daya, cakupan instrumentasi, atribut titik data, dan metadata -spesifik, dan memaparkannya sebagai label PromQL yang dapat dikueri. AWS
Dengan PromQL Anda dapat melakukan hal berikut:
Pilih deret waktu berdasarkan nama metrik dan pencocokan label.
Menerapkan fungsi matematika dan operator di seluruh deret waktu.
Metrik agregat di seluruh dimensi seperti layanan, wilayah, atau akun.
Tingkat komputasi, histogram, kuantil, dan rata-rata bergerak.
Anda dapat menggunakan kueri PromQL secara interaktif di Menjalankan kueri PromQL di Query Studio (Pratinjau) dan juga untuk membuat Alarm. CloudWatch Untuk informasi selengkapnya, lihat Kueri PromQL dan Menggunakan PromQL di alarm.
catatan
CloudWatch menggunakan PromQL berdasarkan spesifikasi Prometheus 3.0. Ini termasuk dukungan untuk nama metrik UTF-8 dan nama label.
Konsep-konsep berikut sangat penting untuk bekerja dengan PromQL di. CloudWatch
| Konsep | Deskripsi |
|---|---|
Deret waktu |
Aliran nilai stempel waktu yang diidentifikasi dengan nama metrik dan satu set pasangan nilai kunci yang disebut label. Setiap kombinasi unik dari nama metrik dan label membentuk deret waktu yang berbeda. |
vektor instan |
Satu set deret waktu yang berisi satu sampel untuk setiap seri, semuanya berbagi stempel waktu yang sama. Dikembalikan oleh kueri seperti |
Rentang vektor |
Satu set deret waktu yang berisi berbagai titik data dari waktu ke waktu untuk setiap seri. Dibuat dengan menambahkan pemilih durasi waktu dalam tanda kurung, misalnya,. |
Label |
Pasangan kunci-nilai yang melekat pada deret waktu. Dalam metrik yang dicerna OTLP, label berasal dari atribut sumber daya, lingkup instrumentasi, atribut titik data, dan metadata -spesifik. AWS |
Pencocokan label |
Ekspresi dalam kurawal kurawal yang menyaring deret waktu berdasarkan nilai label. Mendukung exact match ( |
Operator agregasi |
Fungsi yang menggabungkan beberapa deret waktu menjadi seri yang lebih sedikit. Operator umum termasuk |
Batas dan batasan PromQL
Tabel berikut mencantumkan batas dan batasan untuk PromQL:
| Kuota | Nilai | Informasi tambahan | Kode kesalahan |
|---|---|---|---|
TPS maks untuk permintaan kueri per akun |
300 |
Jumlah maksimum permintaan kueri (/query, /query_range) per detik diperbolehkan per akun. |
422 |
TPS Maks untuk permintaan penemuan per akun |
10 |
Jumlah maksimum permintaan penemuan (/series, /label, /label_values) per detik diperbolehkan per akun. |
422 |
Permintaan kueri bersamaan maksimum per akun |
30 |
Jumlah maksimum kueri (/query, /query_range) akun dapat secara aktif mengeksekusi pada saat yang sama. |
429 |
Permintaan penemuan bersamaan maksimum per akun |
30 |
Jumlah maksimum permintaan penemuan (/series, /labels, /label_values) akun dapat secara aktif mengeksekusi pada saat yang sama. |
429 |
Seri maks dikembalikan per permintaan kueri |
500 |
Jumlah maksimum deret waktu unik yang dapat dikembalikan oleh permintaan kueri (/query, /query_range). |
200 - respon terpotong |
Label maks dikembalikan per permintaan penemuan |
10.000 |
Jumlah maksimum label unik yang dapat dikembalikan oleh permintaan penemuan (/series, /labels, /label_values). |
200 - respon terpotong |
Kisaran maks per permintaan |
7 hari |
Rentang waktu maksimum yang dapat direntang oleh kueri, termasuk parameter rentang dan periode lookback. |
422 |
Seri maks dipindai per jendela 24 jam |
100.000 |
Jumlah maksimum deret waktu unik yang dapat dipindai per jendela eksekusi kueri 24 jam. |
422 |
Sampel maks dipindai per jendela 24 jam |
300.000.000 |
Jumlah maksimum sampel yang dapat dipindai per jendela eksekusi kueri 24 jam. |
422 |
Sampel maks diproses per jendela 24 jam |
3.000.000.000 |
Jumlah maksimum sampel yang dapat diproses per jendela eksekusi kueri 24 jam. |
422 |
Batas waktu pelaksanaan |
20 detik |
Waktu maksimum yang dapat dihabiskan mesin untuk mengevaluasi kueri, tidak termasuk waktu yang dihabiskan dalam antrian dan mengambil data dari penyimpanan. |
422 |
AWS Wilayah yang Didukung
Tabel berikut mencantumkan AWS Wilayah tempat konsumsi metrik OTLP, kueri PromQL, dan Query Studio tersedia.
| Nama wilayah | Kode Wilayah | Pencerapan metrik OTLP | kueri PromQL | Studio Kueri |
|---|---|---|---|---|
US East (Northern Virginia) |
us-east-1 |
✓ |
✓ |
✓ |
AS Barat (Oregon) |
us-west-2 |
✓ |
✓ |
✓ |
Eropa (Irlandia) |
eu-west-1 |
✓ |
✓ |
✓ |
Asia Pasifik (Singapura) |
ap-southeast-1 |
✓ |
✓ |
✓ |
Asia Pacific (Sydney) |
ap-southeast-2 |
✓ |
✓ |
✓ |
Izin IAM untuk PromQL
Untuk menjalankan kueri PromQL, Anda memerlukan keduanya dan izin. cloudwatch:GetMetricData cloudwatch:ListMetrics Tabel berikut mencantumkan operasi API PromQL baru dan tindakan IAM yang diperlukan:
| Operasi API | Tindakan yang diperlukan |
|---|---|
ExecuteMetricQueryPost |
|
ExecuteMetricQueryGet |
|
ExecuteMetricRangeQuery |
|
ExecuteMetricRangeQueryGet |
|
ExecuteMetricSeriesPost |
|
ExecuteMetricSeriesGet |
|
ExecuteMetricLabelsPost |
|
ExecuteMetricLabelsGet |
|
ExecuteMetricLabelValuesGet |
|
