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

# Buat alarm menggunakan kueri PromQL
<a name="Create_PromQL_Alarm"></a>

Anda dapat membuat CloudWatch alarm yang menggunakan kueri instan PromQL untuk memantau metrik yang dicerna melalui titik akhir OTLP. CloudWatch Semua deret waktu yang cocok yang dikembalikan oleh kueri dianggap melanggar, dan alarm melacak setiap deret waktu yang melanggar sebagai kontributor. Untuk informasi selengkapnya tentang cara kerja alarm PromQL, lihat. [Alarm PromQL](alarm-promql.md)

## Membuat alarm PromQL menggunakan Konsol Manajemen AWS
<a name="promql-alarm-create-console"></a>

Contoh ini menunjukkan cara membuat alarm yang memantau metrik pengukur dan memberi tahu Anda saat nilainya turun di bawah 20.

**Untuk membuat alarm PromQL**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Pada panel navigasi, silakan pilih **Alarm**, **Semua Alarm**.

1. Pilih **Buat alarm**.

1. Pilih **PromQL untuk jenis** metrik.

1. Dalam mode **Editor**, masukkan kueri PromQL:

   ```
   my_gauge_metric < 20
   ```

1. Pada **Ketentuan**, tentukan hal-hal berikut:
   + Untuk **interval Evaluasi**, pilih**1 minute**, untuk menentukan seberapa sering kueri PromQL dievaluasi.
   + Untuk **periode Tertunda****120**, masukkan, durasi dalam detik kontributor harus melanggar sebelum memasuki status ALARM.
   + Untuk **periode Pemulihan**, masukkan**300**, durasi dalam detik kontributor tidak boleh melanggar sebelum memasuki status OK.

1. Konfigurasikan pemberitahuan dan tindakan sesuai kebutuhan.

1. Tambahkan nama dan deskripsi untuk alarm Anda.

1. Pilih **Berikutnya**.

1. Pilih **Buat alarm**.

## Membuat alarm PromQL ()AWS CLI
<a name="promql-alarm-create-cli"></a>

Gunakan tindakan [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API untuk membuat alarm PromQL.

**Example Buat alarm PromQL yang memicu ketika metrik pengukur turun di bawah 20**  

```
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \
  --evaluation-interval 60
```

**Example Buat alarm PromQL dengan periode tertunda**  
Alarm ini menunggu 300 detik (5 menit) sebelum beralih ke `ALARM` status, dan menunggu 600 detik (10 menit) sebelum pulih.  

```
aws cloudwatch put-metric-alarm \
  --alarm-name HighLatencyAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5","PendingPeriod":300,"RecoveryPeriod":600}}' \
  --evaluation-interval 60
```

**Example Buat alarm PromQL dengan tindakan notifikasi SNS**  

```
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarmWithAction \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20","PendingPeriod":0,"RecoveryPeriod":0}}' \
  --evaluation-interval 60 \
  --alarm-actions arn:aws:sns:us-east-1:123456789012:MyTopic
```

## Membuat alarm PromQL dari Query Studio
<a name="promql-alarm-create-query-studio"></a>

Contoh ini menunjukkan cara membuat alarm PromQL dari Query Studio yang memberi tahu Anda ketika durasi permintaan HTTP rata-rata untuk layanan melebihi 500 milidetik.

Tidak seperti CloudWatch alarm standar di mana ambang batas dikonfigurasi sebagai langkah terpisah, alarm PromQL mendefinisikan kondisi alarm (ambang batas) sebagai bagian dari kueri itu sendiri. Misalnya, operator perbandingan (`>`) dan nilai ambang (`0.5`) disematkan langsung dalam ekspresi promQL.

**Untuk membuat alarm PromQL dari Query Studio**

1. Buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Di panel navigasi di bawah **Metrik**, pilih **Query Studio (Pratinjau)**.

1. Pilih **PromQL dari menu** drop-down bahasa query.

1. Buat kueri Anda menggunakan salah satu mode berikut:
   + Dalam mode **Builder**, pilih nama metrik dari bidang **Metrik** (misalnya,`http.server.request.duration`). Tambahkan filter label sesuai kebutuhan (misalnya, `@resource.service.name` =`my-api`). Untuk menentukan ambang alarm, pilih **Operasi Dasar** (misalnya,`>`) dan masukkan **Nomor** (misalnya,`0.5`).
   + Dalam mode **Kode**, masukkan ekspresi PromQL secara langsung, misalnya:

     ```
     histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5
     ```

1. Pilih **Jalankan** untuk mengeksekusi kueri dan memverifikasinya mengembalikan hasil yang diharapkan.

1. Pilih **Buat alarm** dari menu tindakan.

1. Anda diarahkan ke halaman pembuatan CloudWatch alarm dengan kueri PromQL Anda sudah diisi sebelumnya.

1. Pada **Ketentuan**, tentukan hal-hal berikut:
   + Untuk **interval Evaluasi**, pilih**1 minute**, untuk menentukan seberapa sering kueri PromQL dievaluasi.
   + Untuk **periode Tertunda****60**, masukkan, durasi dalam detik kueri harus dilanggar sebelum memasuki status ALARM. Ini berarti latensi harus melebihi ambang batas setidaknya 60 detik sebelum alarm menyala.
   + Untuk **periode Pemulihan**, masukkan**120**, durasi dalam detik kueri tidak boleh dilanggar sebelum memasuki status OK. Ini berarti latensi harus tetap di bawah ambang batas setidaknya selama 120 detik sebelum alarm pulih.

1. Konfigurasikan pemberitahuan dan tindakan sesuai kebutuhan.

1. Tambahkan nama dan deskripsi untuk alarm Anda.

1. Pilih **Berikutnya**.

1. Pilih **Buat alarm**.

**catatan**  
Query PromQL harus mengembalikan satu deret waktu untuk membuat alarm. Jika kueri Anda mengembalikan beberapa deret waktu, gunakan fungsi agregasi seperti `sum``avg`,, atau `topk` untuk mengurangi hasilnya menjadi satu seri sebelum membuat alarm.