Halaman ini diterjemahkan oleh Cloud Translation API.

Menyiapkan pemberitahuan dan notifikasi

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Salah satu tujuan utama Pemantauan API adalah untuk terus memberi tahu Anda tentang peristiwa atau pola yang tidak biasa, seperti lonjakan traffic atau latensi. Untuk melacak peristiwa seperti ini, Anda dapat menyiapkan notifikasi, yang dipicu saat peristiwa tertentu terjadi. Peristiwa sebenarnya yang memicu pemberitahuan disebut insiden.

Anda dapat menetapkan aturan tertentu untuk pemberitahuan—misalnya, pemberitahuan tersebut mungkin dipicu oleh kode respons 500 (Internal Service Error) di proxy. Saat insiden untuk pemberitahuan terjadi, Anda dapat melihat detailnya di panel Insiden di halaman Pemberitahuan konsol Google Cloud.

Jika ingin diberi tahu saat pemberitahuan tertentu dipicu, Anda dapat menyiapkan notifikasi untuk pemberitahuan tersebut. Saat insiden terjadi, Apigee akan mengirimkan notifikasi dengan ringkasan peristiwa, termasuk link ke konsol Google Cloud dan UI Apigee, untuk penyelidikan lebih lanjut.

Ada dua jenis pemberitahuan di Monitoring API:

Notifikasi berbasis metrik, yang dipicu oleh perubahan pada metrik API.
Notifikasi berbasis log, yang didasarkan pada data API yang disimpan oleh Cloud Logging.

Notifikasi berbasis metrik

Pemberitahuan berbasis metrik dipicu saat metrik untuk data API mencapai tingkat yang ditentukan, atau mulai berubah dengan cepat. Anda menentukan aturan pemberitahuan menggunakan dua properti utama:

Metrik: Kuantitas yang memicu pemberitahuan—misalnya, jumlah permintaan.
Nilai minimum: Level yang harus dicapai metrik untuk memicu pemberitahuan.

Bagian berikut memberikan contoh pemberitahuan berbasis metrik.

Pemberitahuan untuk kode respons 500 di proxy

Contoh berikutnya membuat pemberitahuan saat kode respons 500 (Error Server Internal) ditampilkan. Anda dapat membuat pemberitahuan serupa untuk kode respons apa pun.

Untuk membuat pemberitahuan, mulailah dengan melakukan langkah-langkah berikut:

Buka halaman Create alerting policy di konsol Google Cloud.
Klik Select a Metric.
Batalkan pilihan tombol Active.
Catatan: Jika tidak ada data traffic API terbaru di organisasi Anda, metrik di langkah berikutnya tidak akan ditampilkan kecuali jika opsi ini tidak dipilih.
Pilih metrik sebagai berikut:
1. Jika Anda menggunakan Apigee hybrid v1.12, salin dan tempel kode berikut di kolom Select a metric:
```
apigee.googleapis.com/proxy/response_count
```
  Catatan: Jika Anda menggunakan Apigee hybrid v1.10 atau v1.11, gunakan metrik berikut:
```
apigee.googleapis.com/proxyv2/response_count
```
2. Pilih Apigee Proxy.
3. Di panel yang terbuka di sebelah kanan, pilih Proxy.
4. Di panel berikutnya di sebelah kanan, pilih Jumlah respons proxy Apigee.
5. Klik Terapkan.
Tambahkan filter untuk kode respons sebagai berikut:
1. Klik Add filter.
2. Klik kolom Filter, lalu pilih response_code dari menu drop-down.
3. Di Comparator, pilih =.
4. Di kolom Nilai, ketik 500.
5. Klik Done.

Mengonfigurasi pemicu pemberitahuan

Untuk mengonfigurasi peristiwa yang memicu pemberitahuan, klik Konfigurasi pemicu di panel sebelah kiri terlebih dahulu. Kemudian, lakukan langkah-langkah berikut:

Di bagian Jenis kondisi, pilih Batas.
Di kolom Pemicu pemberitahuan, pilih Deret waktu mana pun melanggar.
Di kolom Threshold position, pilih Above threshold.
Di kolom Nilai minimum, masukkan 1.

Dengan setelan ini, pemberitahuan akan dipicu setiap kali respons dengan kode 500 ditampilkan.

Klik Next untuk membuka panel Configure notifications and finalize alert.

Menyiapkan notifikasi untuk pemberitahuan

Di panel Configure notifications and finalize alert, Anda dapat menyiapkan notifikasi yang akan dikirim saat pemberitahuan dipicu. Untuk melakukannya:

Klik di kolom Notification Channels. Jika sudah membuat saluran untuk notifikasi, seperti alamat email atau nomor SMS, Anda dapat memilihnya di bagian Saluran Notifikasi.

Jika tidak, Anda harus menambahkan saluran dengan memilih Kelola Saluran Notifikasi. Tindakan ini akan membuka panel Notification channels, tempat Anda dapat menambahkan satu atau beberapa saluran. Lihat Mengelola saluran notifikasi untuk mengetahui informasi selengkapnya. Setelah selesai, kembali ke panel Configure notifications and finalize alert.
Catatan: Anda mungkin perlu mengklik tombol muat ulang di samping Kelola Saluran Notifikasi untuk menampilkan saluran baru setelah membuatnya.
Setelah memilih satu atau beberapa saluran notifikasi, klik OK.
Di kolom Dokumentasi, Anda dapat menambahkan pesan yang akan dikirim dengan notifikasi. Misalnya, pesan mungkin menjelaskan alasan peringatan, dan berisi link ke dokumentasi yang menjelaskan cara meresponsnya.
Klik Berikutnya untuk meninjau detail pemberitahuan. Jika Anda puas dengan setelan tersebut, klik Create Policy untuk membuat kebijakan pemberitahuan.

Menambahkan kondisi: Pemberitahuan untuk kode respons 500 untuk permintaan POST HTTP di proxy

Anda dapat membuat beberapa kondisi untuk pemberitahuan. Misalnya, dalam pemberitahuan untuk kode respons 500 pada proxy yang dijelaskan di bagian sebelumnya, Anda dapat menambahkan kondisi bahwa pemberitahuan hanya dipicu untuk permintaan HTTP POST. Untuk melakukannya, cukup ikuti langkah yang sama seperti pada contoh sebelumnya, tetapi setelah langkah 8, tambahkan filter lain sebagai berikut:

Klik Add filter.
Klik kolom Filter, lalu pilih method HTTP method di daftar drop-down.
Di kolom Comparator, pilih =.
Di kolom Value, masukkan POST.
Klik Done.

Kemudian, lanjutkan dengan langkah-langkah di Mengonfigurasi pemicu pemberitahuan. Setelah Anda selesai, pemberitahuan akan dipicu saat proxy menerima kode respons 500 dari permintaan POST HTTP.

Lihat Pemberitahuan untuk kombinasi kode respons dan metode HTTP untuk contoh terkait.

Melihat detail insiden

Peristiwa API yang memicu pemberitahuan disebut insiden. Anda dapat melihat detail insiden terbaru di halaman Pemberitahuan di konsol Google Cloud.

Metrik dan filter

Metrik adalah kuantitas yang memicu pemberitahuan, misalnya, jumlah permintaan. Bagian ini menjelaskan metrik dan filter yang dapat Anda gunakan untuk membuat pemberitahuan berbasis metrik. Ada dua jenis metrik:

Metrik baru: Versi baru metrik Apigee dengan performa dan keandalan yang lebih baik. Metrik ini saat ini tersedia untuk Apigee dan Apigee hybrid v1.12 dan yang lebih baru. Sebaiknya gunakan metrik baru jika memungkinkan.
Metrik asli: Metrik asli masih didukung untuk digunakan dengan Apigee hybrid v1.10 dan v1.11.

Metrik baru

Tabel di bawah mencantumkan metrik baru.

Metrik	Deskripsi
`apigee.googleapis.com/proxy/details`	Detail yang relevan dengan proxy yang di-deploy ke lingkungan Apigee.
`apigee.googleapis.com/proxy/request_count`	Jumlah permintaan ke proxy Apigee sejak sampel terakhir dicatat.
`apigee.googleapis.com/proxy/response_count`	Jumlah respons yang dikirim oleh proxy API Apigee.
`apigee.googleapis.com/proxy/latencies`	Distribusi latensi, yang dihitung dari waktu permintaan diterima oleh proxy Apigee hingga waktu respons dikirim dari proxy Apigee ke klien.
`apigee.googleapis.com/target/request_count`	Jumlah permintaan yang dikirim ke target Apigee sejak sampel terakhir dicatat.
`apigee.googleapis.com/target/response_count`	Jumlah respons yang diterima dari target Apigee sejak sampel terakhir dicatat.
`apigee.googleapis.com/target/latencies`	Distribusi latensi, yang dihitung dari waktu permintaan dikirim ke target Apigee hingga waktu respons diterima oleh proxy Apigee. Waktu tidak mencakup overhead proxy Apigee API.

Metrik asli

Berikut adalah daftar versi asli metrik yang ditampilkan dalam tabel di atas, yang masih didukung untuk digunakan dengan Apigee hybrid v1.10 dan v1.11 saja.

Metrik	Deskripsi
`apigee.googleapis.com/proxyv2/details`	Detail yang relevan dengan proxy yang di-deploy ke lingkungan Apigee.
`apigee.googleapis.com/proxyv2/request_count`	Total jumlah permintaan yang diterima oleh proxy API Apigee.
`apigee.googleapis.com/proxyv2/response_count`	Jumlah total respons yang ditampilkan oleh proxy API Apigee.
`apigee.googleapis.com/proxyv2/latencies_percentile`	Persentil dari semua respons proxy API terhadap permintaan.
`apigee.googleapis.com/targetv2/request_count`	Total jumlah permintaan yang diterima oleh target Apigee API.
`apigee.googleapis.com/targetv2/response_count`	Jumlah total respons yang ditampilkan oleh target Apigee API.
`apigee.googleapis.com/targetv2/latencies_percentile`	Persentil dari semua respons target API terhadap permintaan.

Filter

Filter memungkinkan Anda membuat pemberitahuan untuk subkumpulan data API. Filter menentukan kondisi yang menentukan subset. Misalnya, Anda dapat membuat pemberitahuan berdasarkan data untuk satu proxy.

Anda dapat memilih dari filter berikut:

Filter	Deskripsi	Metrik yang filternya dapat diterapkan
`env`	Lingkungan untuk data.	Semua
`location`	Lokasi untuk data.	Semua
`proxy_name`	Proxy untuk data.	Semua
`proxy_deployment_type`	Jenis deployment proxy Apigee	`apigee.googleapis.com/proxy/details` `apigee.googleapis.com/proxyv2/details`
`runtime_version`	Versi runtime untuk data.	Metrik asli
`instance_id`	ID instance untuk data.	Metrik asli
`method`	Metode HTTP untuk data.	Semua
`response_code`	Kode respons HTTP untuk data.	`apigee.googleapis.com/proxy/response_count` `apigee.googleapis.com/proxyv2/response_count`
`fault_code`	Kode error untuk data.	`apigee.googleapis.com/proxy/response_count` `apigee.googleapis.com/proxyv2/response_count`
`fault_source`	Sumber error untuk data. Jika Anda ingin menangkap error umum yang dapat terjadi di mana saja dalam jaringan API, tetapkan `fault_source` ke `proxy`.	`apigee.googleapis.com/proxy/response_count` `apigee.googleapis.com/proxyv2/response_count`
`percentile`	Persentil latensi respons proxy Apigee.	`apigee.googleapis.com/proxyv2/latencies_percentile`

Pemberitahuan berbasis log

Selain pemberitahuan berbasis metrik yang dijelaskan di bagian sebelumnya, Anda juga dapat membuat pemberitahuan berbasis log, yang memantau data API yang disimpan oleh Cloud Logging.

Menyiapkan pemberitahuan berbasis log

Contoh berikutnya menunjukkan cara menyiapkan pemberitahuan berbasis log. Lihat Membuat kueri di Logs Explorer untuk mengetahui informasi selengkapnya.

Buka Logs Explorer di Konsol Google Cloud.
Pilih Tampilkan kueri di sisi kanan Logs Explorer.
Di panel Query, masukkan kueri seperti contoh yang ditampilkan di bawah.
```
resource.type="apigee.googleapis.com/Environment"
logName="projects/<project_id>/logs/apigee.googleapis.com%2Fanomaly_event"
```
Catatan: / sebelum anomaly_event ( [LOG_ID]) harus dienkode URL sebagai %2F. Lihat halaman referensi LogEntry.
Klik Run query. Hasilnya ditampilkan di bagian Verify that the query returns the log entries you want to alert on.
Klik Buat pemberitahuan di bawah panel Kueri.
Ikuti prosedur dalam dialog Buat kebijakan pemberitahuan berbasis log untuk membuat pemberitahuan. Lihat Mengonfigurasi pemberitahuan berbasis log untuk mengetahui detailnya.