# Alert Kubernetes di ponsel Anda.

> Kirim alert Kubernetes ke HP Anda. Arahkan webhook_config Alertmanager ke Pocket Alert, dan CrashLoopBackOff atau OOMKilled tiba sebagai push notification kurang dari satu detik.

<!-- source: https://pocketalert.app/id/use-cases/kubernetes-alerts -->

Terakhir diperbarui: 2026-08-11

Pod CrashLoopBackOff, container OOMKilled, rollout yang gagal, atau node NotReady berubah menjadi push di ponsel Anda, lengkap dengan nama namespace dan pod yang langsung terlihat di layar. Pantau masalah cluster tanpa terus-menerus membuka kubectl.

## Tiga langkah dari Alertmanager ke ponsel

1. **Dapatkan URL penerimaan** — Buat webhook Pocket Alert dengan template pesan GJSON, lalu salin URL penerimaannya.
2. **Hubungkan Alertmanager** — Tambahkan receiver webhook_configs di Alertmanager dan arahkan alert critical Anda ke sana.
3. **Jalankan** — Alert terpicu berikutnya akan dikirim ke ponsel Anda dalam kurang dari satu detik. Sesuaikan template GJSON saat Anda menyempurnakan route.

## Dari alert yang terpicu ke ponsel

Tetap gunakan Alertmanager yang sudah Anda jalankan. Pocket Alert mengubah output webhook-nya menjadi push di ponsel Anda.

- **webhook_config bawaan** — Alertmanager memiliki receiver webhook_config bawaan. Arahkan ke URL aplikasi Anda dan selesai.
- **Pemetaan field GJSON** — GJSON mengambil alertname, namespace, pod, dan severity dari JSON menjadi judul dan pesan yang mudah dibaca.
- **Status dan severity inline** — Tampilkan status dan severity secara langsung agar alert critical yang terpicu tampil berbeda dengan pemberitahuan resolved.
- **Event pod dan node** — Tangkap CrashLoopBackOff, OOMKilled, rollout yang gagal, node NotReady, dan event PVC penuh.
- **Kanal per cluster** — Aplikasi terpisah memberi prod dan staging kanal masing-masing, dengan URL webhook sendiri.
- **Pengiriman di bawah satu detik** — Push tiba dalam kurang dari satu detik setelah Alertmanager terpicu. Tanpa agent tambahan di dalam cluster.

## Kirim alert Kubernetes ke ponsel Anda

### 1. Buat webhook Pocket Alert

Di halaman [Webhooks](https://pocketalert.app/id/webhooks), buat webhook yang template `message` GJSON-nya membaca payload Alertmanager (`status` dan `commonLabels` di level teratas, serta array `alerts`):

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"K8s Alertmanager","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.labels.namespace%/%alerts.0.labels.pod%\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Anda akan mendapatkan URL masuk seperti `https://p4a.me/wh/1234abcd`. Gunakan satu webhook per cluster agar prod dan staging tetap terpisah.

### 2. Arahkan Alertmanager ke webhook tersebut

Tambahkan receiver `webhook_configs` dan arahkan alert critical Anda ke sana ([dokumentasi Alertmanager](https://prometheus.io/docs/alerting/latest/configuration/#webhook_config)):

```
receivers:
  - name: 'pocketalert'
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'

route:
  receiver: 'pocketalert'
  group_by: ['alertname', 'namespace']
```

Alertmanager mengirim POST dengan JSON standarnya; path GJSON di atas mengambil status, alertname, severity, namespace, dan pod ke dalam push. Saat alert selesai, `status` berubah menjadi `resolved`.

### 3. Atau POST dari controller / kubectl

Controller atau skrip sekali jalan dapat memanggil API pesan secara langsung dengan header Token:

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"CrashLoopBackOff","level":"critical","message":"api-7c9 in prod, 12 restarts","application_id":"qm47b9pzxzxg"}'
```

Dokumentasi [pengaturan webhook](https://info.pocketalert.app/api/webhooks/settings.html) mencakup seluruh path GJSON dan opsi webhook.

## FAQ

### Bagaimana cara mengirim alert Kubernetes ke Pocket Alert?

Tambahkan receiver webhook_configs di Alertmanager yang mengarah ke URL penerimaan Pocket Alert Anda, https://p4a.me/wh/1234abcd. Alert CrashLoopBackOff atau OOMKilled yang terpicu akan menjadi push.

### Bagaimana Pocket Alert membaca payload Alertmanager?

Pemetaan field GJSON membaca JSON Alertmanager. Ambil commonLabels.alertname untuk judul dan alerts.0.labels.namespace / alerts.0.labels.pod untuk isi, sehingga namespace dan pod tampil di layar Anda, bukan payload mentah.

### Bisakah saya membedakan alert yang terpicu dari yang sudah resolved?

Payload memuat status (firing atau resolved) dan commonLabels.severity. Gunakan keduanya dalam template pesan GJSON Anda agar alert critical yang sedang terpicu tampil berbeda dengan pemberitahuan resolved.

### Bagaimana cara memisahkan cluster prod dan staging?

Berikan prod dan staging aplikasi Pocket Alert masing-masing, dengan URL webhook sendiri. Arahkan satu route Alertmanager ke masing-masing agar node NotReady di staging tidak pernah tertukar dengan prod.

### Apakah saya perlu menjalankan agent di dalam cluster?

Tidak. Anda sudah menjalankan Alertmanager. Pocket Alert tidak memerlukan apa pun tambahan di dalam cluster. Controller atau skrip juga dapat langsung melakukan POST ke https://api.pocketalert.app/v1/messages dengan header Token.

### Bisakah saya memetakan tingkat keparahan alert ke prioritas notifikasi?

Ya. Setiap pesan menerima level: silent, low, default, high, atau critical. Sertakan field "level" dalam payload webhook, atau atur default_level pada webhook itu sendiri; level eksplisit di payload selalu diutamakan. Pemisahan yang umum adalah firing=critical dan resolved=silent: alert yang terpicu akan menembus Jangan Ganggu di Android dan masuk sebagai time-sensitive di iPhone, sementara pemulihan tetap tenang di riwayat. Nilai yang tidak valid akan kembali ke default, tidak pernah ditolak.
