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
Apa itu Prometheus Query Language (PromQL)?
Prometheus Query Language (PromQL) adalah bahasa query 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 metrik kueri termasuk metrik yang dicerna melalui OpenTelemetry Line Protocol (OTLP) dan AWS metrik penjualan yang diperkaya. Saat Anda menelan metrik OTLP, CloudWatch pertahankan struktur semantik lengkap telemetri Anda, termasuk atribut sumber daya, cakupan instrumentasi, atribut datapoint, dan metadata AWS spesifik, dan memperlihatkannya sebagai label ProMQL yang dapat dikueri.
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.
Menggabungkan metrik di seluruh dimensi seperti layanan, wilayah, atau akun.
Hitung tarif, histogram, kuantil, dan rata-rata bergerak.
Anda dapat menggunakan kueri PromQL secara interaktif di Menjalankan kueri PromQL di Query Studio 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 UTF-8 metrik dan nama label.
Konsep-konsep berikut sangat mendasar untuk bekerja dengan PromQL di. CloudWatch
| Konsep | Deskripsi |
|---|---|
Deret waktu |
Aliran nilai stempel waktu yang diidentifikasi oleh nama metrik dan satu set pasangan kunci-nilai 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 |
Vektor rentang |
Satu set deret waktu yang berisi rentang 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 OTLP-ingested metrik, label berasal dari atribut sumber daya, lingkup instrumentasi, atribut datapoint, dan AWS metadata spesifik. |
Pencocokan label |
Ekspresi dalam kurung kurung yang memfilter deret waktu berdasarkan nilai label. Mendukung kecocokan tepat ( |
Operator agregasi |
Fungsi yang menggabungkan beberapa deret waktu menjadi seri yang lebih sedikit. Operator umum termasuk |
Batas dan batasan PromQL
Tabel berikut mencantumkan batasan dan batasan untuk PromQL:
| Kuota | Nilai | Informasi tambahan | Kode kesalahan |
|---|---|---|---|
Maks TPS untuk permintaan kueri per akun |
300 |
Jumlah maksimum permintaan kueri (/query, /query_range) per detik yang diizinkan per akun. |
422 |
Maks TPS untuk permintaan penemuan per akun |
10 |
Jumlah maksimum permintaan penemuan (/series, /label, /label_values) per detik yang diizinkan per akun. |
422 |
Permintaan permintaan kueri bersamaan maksimum per akun |
30 |
Jumlah maksimum kueri (/query, /query_range) yang dapat dieksekusi secara aktif akun pada saat yang sama. |
429 |
Permintaan penemuan serentak maksimum per akun |
30 |
Jumlah maksimum permintaan penemuan (/series, /labels, /label_values) yang dapat dieksekusi secara aktif oleh akun pada saat yang bersamaan. |
429 |
Seri maksimum dikembalikan per permintaan kueri |
500 |
Jumlah maksimum deret waktu unik yang dapat dikembalikan permintaan kueri (/query, /query_range). |
200 - respons terpotong |
Label maksimum yang dikembalikan per permintaan penemuan |
10,000 |
Jumlah maksimum label unik yang dapat dikembalikan oleh permintaan penemuan (/series, /labels, /label_values). |
200 - respons terpotong |
Rentang maksimum per permintaan |
7 hari |
Rentang waktu maksimum yang dapat direntangkan kueri, termasuk parameter rentang dan periode tampilan balik. |
422 |
Seri maksimum yang dipindai per jendela 24 jam |
100,000 |
Jumlah maksimum deret waktu unik yang dapat dipindai per jendela 24 jam eksekusi kueri. |
422 |
Sampel maksimum yang dipindai per jendela 24 jam |
300.000.000 |
Jumlah maksimum sampel yang dapat dipindai per jendela 24 jam eksekusi kueri. |
422 |
Sampel maksimum diproses per jendela 24 jam |
3.000.000.000 |
Jumlah maksimum sampel yang dapat diproses per jendela 24 jam eksekusi kueri. |
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 |
Didukung AWS Wilayah
Tabel berikut mencantumkan Wil AWS ayah tempat penyerapan metrik OTLP, kueri PromQL, dan Query Studio tersedia.
| Nama wilayah | Kode Wilayah | Menelan 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 |
✓ |
✓ |
✓ |
AS Barat (California Utara) |
us-west-1 |
✓ |
✓ |
✓ |
AS Timur (Ohio) |
us-east-2 |
✓ |
✓ |
✓ |
Eropa (London) |
eu-west-2 |
✓ |
✓ |
✓ |
Europe (Paris) |
eu-west-3 |
✓ |
✓ |
✓ |
Eropa (Frankfurt) |
eu-central-1 |
✓ |
✓ |
✓ |
Eropa (Stockholm) |
eu-north-1 |
✓ |
✓ |
✓ |
Europe (Milan) |
eu-south-1 |
✓ |
✓ |
✓ |
Eropa (Spanyol) |
eu-south-2 |
✓ |
✓ |
✓ |
Europe (Zurich) |
eu-central-2 |
✓ |
✓ |
✓ |
Asia Pasifik (Tokyo) |
ap-northeast-1 |
✓ |
✓ |
✓ |
Asia Pasifik (Seoul) |
ap-northeast-2 |
✓ |
✓ |
✓ |
Asia Pacific (Osaka) |
ap-northeast-3 |
✓ |
✓ |
✓ |
Asia Pasifik (Mumbai) |
ap-south-1 |
✓ |
✓ |
✓ |
Asia Pasifik (Hyderabad) |
ap-south-2 |
✓ |
✓ |
✓ |
Asia Pasifik (Hong Kong) |
ap-east-1 |
✓ |
✓ |
✓ |
Asia Pasifik (Taipei) |
ap-east-2 |
✓ |
✓ |
✓ |
Asia Pasifik (Jakarta) |
ap-southeast-3 |
✓ |
✓ |
✓ |
Asia Pacific (Melbourne) |
ap-southeast-4 |
✓ |
✓ |
✓ |
Asia Pasifik (Malaysia) |
ap-southeast-5 |
✓ |
✓ |
✓ |
Asia Pasifik (Auckland) |
ap-Southeast-6 |
✓ |
✓ |
✓ |
Asia Pasifik (Thailand) |
ap-Southeast-7 |
✓ |
✓ |
✓ |
Amerika Selatan (Sao Paulo) |
sa-east-1 |
✓ |
✓ |
✓ |
Kanada (Pusat) |
ca-central-1 |
✓ |
✓ |
✓ |
Kanada Barat (Calgary) |
ca-west-1 |
✓ |
✓ |
✓ |
Africa (Cape Town) |
af-south-1 |
✓ |
✓ |
✓ |
Meksiko (Tengah) |
mx-sentral-1 |
✓ |
✓ |
✓ |
Izin IAM untuk PromQL
Untuk menjalankan kueri PromQL, Anda memerlukan keduanya cloudwatch:GetMetricData dan cloudwatch:ListMetrics izin. Tabel berikut mencantumkan jalur titik akhir Prometheus-compatible API dan tindakan IAM yang diperlukan:
| Jalur titik akhir API | Metode HTTP | Tindakan yang diperlukan |
|---|---|---|
|
DAPATKAN, POSTING |
|
|
DAPATKAN, POSTING |
|
|
DAPATKAN, POSTING |
|
|
DAPATKAN, POSTING |
|
|
GET |
|
