---
title: "Notifikasi Telepon Google Cloud Monitoring via Webhook"
description: "Cloud Monitoring bisa kirim email, SMS, atau push, tapi tak bisa menelepon. Arahkan alert policy GCP ke webhook panggilan: setup, field payload, filter."
date: 2026-11-15
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Google Cloud
  - Cloud Monitoring
  - GCP
  - notifikasi telepon
  - webhook
  - on-call
---

# Notifikasi telepon Google Cloud Monitoring: dari alert policy sampai ponsel berdering

Google Cloud Monitoring tidak punya cara untuk menelepon ponsel Anda. Kanal notifikasinya adalah email, SMS, aplikasi seluler Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub, dan webhook — dan dokumentasi Google sendiri menyebut SMS tidak sepenuhnya andal dan mungkin tidak tersedia di region Anda. Kalau Anda ingin alert policy berdering seperti telepon masuk, jalur terpendeknya adalah kanal webhook yang diarahkan ke kanal panggilan Echobell, dengan dua baris template dan satu kondisi.

Panduan ini membahas kanalnya, webhook-nya, field dalam payload yang benar-benar dikirim Cloud Monitoring, cara membuat insiden "open" tetap berdering dan insiden "closed" tetap sunyi, serta pengaturan di alert policy yang menentukan seberapa sering ponsel Anda berbunyi.

## Mengapa kanal bawaan tidak cukup pukul 3 pagi

- **Email** menunggu sampai Anda membukanya.
- **SMS**, menurut Google sendiri, bukan tipe kanal yang sepenuhnya andal, dan mungkin tidak ditawarkan di negara Anda. SMS juga dibisukan oleh Jangan Ganggu seperti pesan teks lainnya.
- **Aplikasi seluler** mengirim push biasa. Push itu muncul di layar kunci, tetapi tidak terus berdering.
- **PagerDuty** bisa menelepon Anda, tetapi itu platform on-call lengkap dengan setup dan kontraknya sendiri.

Sebaliknya, kanal webhook bisa menjangkau apa saja yang punya endpoint HTTPS publik, dan Cloud Monitoring mengirimkan dokumen JSON terstruktur untuk setiap insiden. Hanya itu yang dibutuhkan Echobell.

## Yang Anda butuhkan

- Proyek Google Cloud dengan minimal satu alerting policy (atau uptime check yang ingin Anda pasangi alert)
- Izin untuk mengedit kanal notifikasi (`roles/monitoring.notificationChannelEditor` atau Monitoring Editor)
- Echobell terpasang ([App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-id&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid))
- Sepuluh menit

Tidak ada apa pun di proyek Anda yang perlu menerima lalu lintas masuk. Cloud Monitoring yang membuat permintaan keluar.

## Langkah 1 — Buat kanal yang berdering

Di Echobell, buat kanal dan setel tipe notifikasinya ke **Panggilan**. Kanal panggilan berperilaku seperti telepon masuk, bukan push, sehingga mengambil alih layar dan berdering. Saat Mode Fokus iOS atau Jangan Ganggu aktif, ia hanya berdering jika pengaturan Fokus Anda mengizinkan panggilan masuk.

Buka **Pengaturan Lanjutan** kanal dan aktifkan **Template Kustom**. Cloud Monitoring membungkus semuanya di dalam objek `incident`, jadi template membaca field bersarang:

```
Judul: {{incident.state}}: {{incident.policy_name}}
Isi: {{incident.summary}}
```

Setel **template tautan** agar mengetuk notifikasi membuka insiden di konsol Google Cloud:

```
{{incident.url}}
```

Tambahkan **kondisi** agar hanya insiden yang baru terbuka yang berdering:

```
incident.state == "open"
```

Salin URL webhook kanal dari tampilan detail kanal:

```
https://hook.echobell.one/t/<channel-token>
```

## Langkah 2 — Tambahkan kanal notifikasi webhook di Google Cloud

1. Buka **Monitoring → Alerting** lalu klik **Edit notification channels**
2. Di bawah **Webhooks**, klik **Add new**
3. **Endpoint URL**: URL kanal Echobell Anda dari Langkah 1
4. **Display name**: `Echobell (call)`
5. Biarkan **Use HTTP Basic Auth** nonaktif
6. Klik **Test connection**, lalu **Save**

Basic Auth sengaja dibiarkan nonaktif. Handshake Basic Auth milik Google mengharapkan endpoint menjawab permintaan pertama dengan `401` dan header `WWW-Authenticate`; Echobell justru mengautentikasi lewat token rahasia di URL, jadi perlakukan URL itu seperti kata sandi.

Kalau Anda mengelola kanal dengan Terraform, kanal yang sama ditulis seperti ini:

```hcl
resource "google_monitoring_notification_channel" "echobell_call" {
  display_name = "Echobell (call)"
  type         = "webhook_tokenauth"

  labels = {
    url = "https://hook.echobell.one/t/<channel-token>"
  }
}
```

Jangan masukkan token ke version control — baca dari variabel atau Secret Manager, alih-alih meng-commit URL-nya.

## Langkah 3 — Pasang kanal ke policy yang pantas ditelepon

Buka sebuah alerting policy, masuk ke **Notifications and name**, dan tambahkan `Echobell (call)` di bawah **Notification channels**. Satu policy bisa memberi tahu beberapa kanal sekaligus, jadi pertahankan kanal email atau Slack yang sudah ada di sampingnya.

Pilih dengan cermat di sini. Inilah filter yang sesungguhnya: kanal yang hanya dipasang pada "API produksi mati" dan "disk database penuh" cukup jarang berdering sehingga Anda tetap akan mengangkatnya. Biarkan "CPU di atas 70% selama lima menit" tetap lewat email.

Dua pengaturan di halaman yang sama menentukan apa yang sampai ke ponsel Anda:

- **Notify on incident closure.** Jika aktif, Cloud Monitoring juga mengirim notifikasi saat insiden ditutup. Kondisi `incident.state == "open"` dari Langkah 1 mencegahnya berdering; Langkah 6 menunjukkan cara menerimanya dengan tenang.
- **Incident autoclose duration.** Jika metrik berhenti melaporkan data, insiden yang terbuka akan ditutup setelah periode ini. Biarkan di nilai bawaan kecuali Anda punya alasan untuk mengubahnya.

## Langkah 4 — Ketahui seperti apa payload sebenarnya

Cloud Monitoring mengirim schema versi 1.2 secara bawaan. Setelah dipangkas ke field yang kemungkinan Anda pakai, insiden yang terbuka terlihat seperti ini:

```json
{
  "version": "1.2",
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "my-project",
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.opqiw61fsv7p?project=my-project",
    "state": "open",
    "renotify": false,
    "started_at": 1794713564,
    "ended_at": null,
    "policy_name": "Prod API 5xx rate",
    "condition_name": "5xx ratio above 5%",
    "resource_display_name": "prod-api",
    "threshold_value": "0.05",
    "observed_value": "0.183",
    "severity": "Critical",
    "policy_user_labels": {
      "team": "payments"
    },
    "documentation": {
      "content": "Check the latest deploy first. Runbook: https://wiki.example.com/api-5xx",
      "mime_type": "text/markdown"
    },
    "summary": "5xx ratio for prod-api with metric labels {response_code_class=500} is above the threshold of 0.050 with a value of 0.183."
  }
}
```

Hal yang perlu diketahui sebelum mengubah template:

- **Semuanya berada di bawah `incident`.** `{{policy_name}}` dirender kosong; `{{incident.policy_name}}` tidak.
- **`state` bernilai `open` atau `closed`.** Satu field itulah yang diandalkan kondisi dan template judul.
- **`summary` adalah teks buatan sistem.** Google tidak menjanjikan format yang stabil untuknya, jadi tampilkan saja, tetapi jangan mencocokkannya di kondisi.
- **Field bisa tidak ada.** Google mencatat bahwa sebagian field tidak ada atau bernilai null tergantung policy dan status insiden. Field yang tidak ada dirender sebagai string kosong di Echobell, jadi template tetap berfungsi; hanya saja jangan membangun kondisi di atas field yang tidak disetel policy Anda.
- **`documentation.content` milik Anda.** Apa pun yang Anda ketik di kotak **Documentation** pada policy akan tiba di sini. Instruksi satu baris ("Periksa deploy terakhir dulu") lebih berguna di ponsel yang sedang berdering daripada ringkasan buatan sistem.
- **Severity mengikuti policy.** Nilainya adalah level apa pun yang Anda setel di policy. Kirim insiden uji ke diri sendiri dan periksa nilai persisnya sebelum memfilter berdasarkan field itu.

Body yang mendahulukan kata-kata Anda sendiri dan memakai summary sebagai cadangan:

```
{{incident.documentation.content}}
{{incident.summary}}
```

## Langkah 5 — Tentukan apa yang berdering, dan seberapa sering

Sebagian besar penyaringan sudah terjadi saat Anda memilih policy mana yang mendapat kanal ini. Kondisi kanal Echobell menangani sisanya.

| Tujuan | Kondisi |
| --- | --- |
| Berdering hanya saat insiden terbuka | `incident.state == "open"` |
| Berdering sekali, bukan di setiap pengingat | `incident.state == "open" && !incident.renotify` |
| Berdering hanya untuk policy satu tim | `incident.state == "open" && incident.policy_user_labels.team == "payments"` |
| Berdering hanya malam hari (00:00–07:00 UTC) | `incident.state == "open" && hour < 7` |

**Pengingat.** Sebuah policy bisa mengirim ulang notifikasi selama insiden masih terbuka: di API namanya `alertStrategy.notificationChannelStrategy[].renotifyInterval`, antara 30 menit hingga 24 jam. Pengulangan itu tiba dengan `renotify: true`. Apakah pengulangan perlu berdering adalah pilihan: berdering lagi adalah eskalasi yang kasar tapi efektif untuk insiden yang belum diperbaiki siapa pun, sedangkan melewatinya mencegah gangguan panjang membuat ponsel berdering semalaman. Baris kedua tabel melakukan yang terakhir.

**User label.** User label pada policy, seperti `team: payments`, ikut terkirim di `policy_user_labels`. Kondisi berdasarkan label ini membuat satu kanal yang dipasang ke banyak policy berdering untuk sebagian dan tetap diam untuk sisanya. Label hanya menyaring, tidak mengarahkan: setiap URL webhook selalu memicu kanal Echobell yang sama, jadi label tidak bisa mengirim insiden ke kanal orang lain.

Variabel waktu Echobell memakai UTC, jadi konversikan dulu dari zona waktu Anda. [Referensi kondisi](/id/docs/conditions) memuat daftar variabel lengkapnya.

## Langkah 6 — Beri penutupan insiden pintu yang lebih sunyi

Dengan **Notify on incident closure** aktif, insiden yang ditutup adalah kabar baik yang layak dilihat, bukan layak berdering. Buat kanal Echobell kedua bertipe **Sensitif Waktu (Time Sensitive)** (atau normal) dengan template yang sama tanpa kondisi, tambahkan ke Google Cloud sebagai kanal webhook kedua, dan pasang keduanya ke policy. Template judulnya sudah terbaca "closed: Prod API 5xx rate".

| Kanal Echobell | Kondisi | Tipe kanal | Perilaku |
| --- | --- | --- | --- |
| `gcp-call` | `incident.state == "open"` | Panggilan | Berdering seperti telepon masuk |
| `gcp-log` | tidak ada | Sensitif Waktu atau Normal | Setiap pembukaan, pengingat, dan penutupan, tanpa dering |

## Uji sebelum Anda percaya

**Uji sisi Echobell dulu.** Kirim payload yang bentuknya seperti milik Cloud Monitoring:

```bash
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H 'Content-Type: application/json' \
  -d '{"version":"1.2","incident":{"state":"open","renotify":false,"policy_name":"Manual test","summary":"Testing the Echobell path","url":"https://console.cloud.google.com/monitoring/alerting"}}'
```

**Lalu uji sisi Google.** Tombol **Test connection** mengirim payload contoh yang field-nya bukan insiden sungguhan, jadi mungkin tidak lolos kondisi Anda. Untuk uji ujung ke ujung, buat policy sementara dengan ambang yang sudah Anda lampaui — misalnya utilisasi CPU VM di atas 1% — pasang `Echobell (call)`, tunggu sampai menyala, lalu hapus policy-nya.

Kalau `curl` berdering sementara policy sungguhan tidak, masalahnya ada di sisi Google — kanal belum terpasang, kondisi belum terpenuhi selama durasinya, atau endpoint URL salah disalin — bukan di kanal Echobell.

## Alert berbasis log dan uptime check

- **Uptime check** tidak memberi tahu siapa pun dengan sendirinya; ia memasok alerting policy. Buat policy dari uptime check tersebut dan pasang kanal webhook yang sama.
- **Alerting policy berbasis log** hanya memberi tahu saat insiden terbuka — Google tidak mengirim notifikasi penutupan untuknya — dan membutuhkan batas laju notifikasi, yang membatasi seberapa sering baris log yang berisik bisa membuat Anda ditelepon. Kondisi `incident.state == "open"` tetap berfungsi; kanal penutupan memang tidak akan pernah menerima apa pun dari policy ini.

## Batas yang penting saat insiden

- **Body 1 MiB.** Echobell menolak body pemicu di atas 1 MiB dengan HTTP 413. Satu insiden Cloud Monitoring hanya beberapa kilobyte.
- **120 permintaan per menit per token.** Di atas itu pemicu menjawab `429` dengan `RATE_LIMIT_EXCEEDED` dan sebuah `Retry-After`. Satu policy jarang mendekatinya, tetapi puluhan policy yang menyala bersamaan saat gangguan regional bisa — satu alasan lagi untuk menjaga daftar kanal panggilan tetap pendek.
- **1500 byte isi notifikasi.** Hasil render yang lebih panjang dipotong. Buat dokumentasi policy singkat, atau taruh tautan runbook di sana, bukan isi runbook-nya.

## Yang tidak diberikan setup ini

- **Tanpa pengakuan (ack).** Mengangkat telepon tidak mengakui atau menutup insiden di Google Cloud.
- **Tanpa eskalasi atau rotasi.** Semua yang berlangganan kanal ditelepon; tidak ada yang ditelepon berikutnya.
- **Tanpa deduplikasi di luar insiden.** Kondisi yang berkedip membuka insiden baru setiap kali, dan setiap insiden berdering. Atasi di policy dengan jendela durasi yang lebih panjang.

Kalau itu semua penghalang, Anda butuh platform on-call lengkap. Kalau yang Anda perlukan adalah "telepon saya saat policy produksi menyala", ini hanya dua layar di konsol.

## Pemecahan masalah

**Insiden terbuka tapi tidak ada yang datang.** Buka insiden di **Monitoring → Alerting** dan pastikan policy mencantumkan kanal webhook. Pastikan endpoint URL adalah URL Echobell lengkap, termasuk tokennya.

**Notifikasi datang tapi tidak berdering.** Tipe kanalnya bukan **Panggilan**, atau pengaturan Fokus di ponsel Anda tidak mengizinkan panggilan masuk. Periksa kanal dan konfigurasi Fokus Anda.

**Notifikasi kosong.** Template membaca field tingkat atas. Beri awalan `incident.` — `{{incident.policy_name}}`, bukan `{{policy_name}}`.

**Berdering lagi setiap setengah jam.** Policy punya interval renotify. Hapus interval itu, atau tambahkan `!incident.renotify` ke kondisi.

**Berdering saat insiden ditutup.** Kondisinya tidak memuat `incident.state == "open"`, atau terpasang di kanal yang salah.

## Pertanyaan yang sering diajukan

### Bisakah Google Cloud Monitoring menelepon nomor telepon secara bawaan?

Tidak. Kanal notifikasinya adalah email, SMS, aplikasi seluler Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub, dan webhook. Panggilan suara memerlukan layanan eksternal: platform on-call, atau webhook panggilan seperti Echobell.

### Perlukah Pub/Sub atau Cloud Function?

Tidak. Cloud Monitoring sendiri yang mengirim insiden ke URL webhook. Pub/Sub adalah rekomendasi Google untuk endpoint yang tidak publik; endpoint Echobell bersifat publik, jadi kanal webhook sudah cukup.

### Apakah alert Cloud Monitoring menembus Jangan Ganggu?

Hanya jika tiba sebagai alert bergaya panggilan. Kanal Echobell bertipe panggilan berperilaku seperti telepon masuk, yang dilewatkan oleh Mode Fokus dan Jangan Ganggu di iOS jika pengaturan Fokus Anda mengizinkan panggilan. SMS atau push biasa tidak. Aktifkan juga **Coba Lagi Panggilan yang Gagal**: jika Izinkan Panggilan Berulang aktif di pengaturan Fokus Anda, panggilan kedua dalam tiga menit bisa berdering.

### Haruskah saya memakai opsi Basic Auth pada webhook?

Tidak. Echobell mengautentikasi lewat token di URL. Alur Basic Auth milik Google mengharapkan tantangan `401` lebih dulu, yang tidak dikirim Echobell.

### Bisakah saya menelepon orang berbeda untuk policy berbeda?

Bisa. Buat satu kanal Echobell per audiens, tambahkan URL tiap kanal ke Google Cloud sebagai kanal webhook tersendiri, lalu pasang masing-masing ke policy yang menjadi tanggung jawab audiens itu. Satu URL webhook selalu memicu kanal Echobell yang sama, jadi kondisi `policy_user_labels` bisa membisukan policy tertentu di kanal itu, tetapi tidak bisa menyerahkannya ke kanal lain. Tidak ada pengakuan, jadi semua yang berlangganan dengan "panggilan" akan ditelepon.

### Bagaimana dengan beberapa proyek?

Kanal notifikasi milik satu proyek. Buat kanal webhook di setiap proyek — URL Echobell yang sama berfungsi di semuanya — atau kirim alert dari scoping project yang memantau proyek lainnya.

## Penutup

Jalurnya terdiri dari empat bagian: kanal panggilan dengan kondisi `incident.state == "open"`, kanal notifikasi webhook yang mengarah ke sana, daftar pendek policy yang pantas ditelepon, dan uji sungguhan sebelum Anda mengandalkannya. Sisanya adalah soal menjaga daftar itu cukup pendek agar sebulan dari sekarang deringnya masih berarti sesuatu.

[Unduh Echobell untuk iPhone](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-id&mt=8) atau [dapatkan di Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid), lalu arahkan alerting policy terpenting Anda ke sana.

## Artikel terkait

- [Referensi kondisi kanal](/id/docs/conditions)
- [Referensi template](/id/docs/template)
- [Panduan integrasi webhook](/id/docs/webhook)
- [Notifikasi telepon alarm CloudWatch](/id/blog/cloudwatch-alarm-phone-call-alerts)
- [Notifikasi telepon Alertmanager](/id/blog/alertmanager-phone-call-alerts)
- [Panduan developer mengatasi kelelahan alert](/id/blog/fix-alert-fatigue-developer-guide)
- [Menembus Mode Fokus iOS untuk alert kritis](/id/blog/how-to-bypass-ios-focus-mode-for-critical-alerts)
