# Kirim baris log yang cocok ke ponsel Anda.

> Dapatkan push notification saat pola log cocok. Hubungkan Loki, ELK stack, atau Graylog ke webhook Pocket Alert, dan baris error yang cocok sampai ke HP Anda dalam sedetik.

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

Terakhir diperbarui: 2026-08-11

Loki, stack ELK, Graylog, atau skrip tail | grep sudah mendeteksi lonjakan error dan rentetan login gagal. Baris yang cocok sampai di ponsel Anda dalam waktu kurang dari satu detik, jadi entri log yang penting selalu ada di saku Anda.

## Tiga langkah dari baris log ke push notification

1. **Tentukan polanya** — Tambahkan aturan Loki ruler, Elastic Watcher, atau pola grep yang terpicu saat sebuah baris cocok.
2. **Hubungkan** — Jalankan curl ke API pesan dari skrip tail | grep, atau arahkan Alertmanager ke URL penerima webhook Pocket Alert dengan template GJSON.
3. **Pisahkan saluran** — Berikan setiap layanan atau environment aplikasinya sendiri agar log prod dan staging tetap di saluran terpisah.

## Dari baris log ke layar kunci

Pipeline log Anda sudah menemukan baris yang bermasalah. Pocket Alert membawanya ke ponsel Anda.

- **Bekerja dengan stack Anda** — Loki ruler, Elastic Watcher, Graylog, atau skrip tail | grep semuanya dapat mengirim ke satu webhook.
- **Alert berbasis pola** — Aturan LogQL, kondisi Watcher, atau pola grep menentukan kapan push dikirim.
- **Pemetaan field** — Path GJSON mengambil nama alert, baris yang cocok, dan jumlah hit langsung dari JSON alert.
- **CLI atau webhook** — Skrip tail | grep dapat menjalankan curl langsung ke API pesan, tanpa perlu platform monitoring.
- **Saluran per aplikasi** — Satu aplikasi Pocket Alert per layanan atau environment menjaga log prod dan staging tetap di saluran terpisah.
- **Pengiriman di bawah satu detik** — Webhook dipicu dan push tiba dalam waktu kurang dari satu detik, cukup cepat untuk menangkap pod OOMKilled secara langsung.

## Kirim push notification saat pola log terpicu

### 1. Curl langsung dari skrip tail | grep (CLI)

Pasang CLI, autentikasi sekali, lalu tail log dan kirim push untuk setiap baris yang cocok.

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

```
tail -Fn0 /var/log/app.log | grep --line-buffered "OutOfMemory" | while read -r line; do
  pocketalert send -t "OOM on $(hostname)" -m "$line"
done
```

Atau kirim POST langsung ke API pesan tanpa CLI.

```
tail -Fn0 /var/log/app.log | grep --line-buffered "ERROR" | while read -r line; do
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"Log error\",\"level\":\"critical\",\"message\":\"${line//\"/\\\"}\"}"
done
```

### 2. Atau teruskan Loki / Alertmanager melalui webhook

Definisikan aturan alerting LogQL di Loki ruler yang terpicu saat jumlah kecocokan melebihi ambang batas.

```
groups:
  - name: app-errors
    rules:
      - alert: HighErrorRate
        expr: sum(count_over_time({app="api"} |= "ERROR" [5m])) > 20
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "{{ $value }} ERROR lines in the last 5m"
```

Ruler meneruskan ke Alertmanager (`alertmanager_url`), yang kemudian meneruskan ke Pocket Alert. Buat webhook di halaman [Webhooks](https://pocketalert.app/id/webhooks) dengan template GJSON yang memetakan payload Alertmanager, lalu arahkan `webhook_config` ke URL penerima.

```
curl -X POST 'https://api.pocketalert.app/v1/webhooks' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Loki Alerts","application_id":"qm47b9pzxzxg","message":"%status%: %alerts.0.labels.alertname% — %alerts.0.annotations.summary%"}'
```

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

Aksi `webhook` Elastic Watcher atau event definition HTTP Notification Graylog dapat mengirim POST ke URL penerima yang sama. [Dokumentasi](https://info.pocketalert.app/api/webhooks/settings.html) membahas pemetaan GJSON dan perutean per aplikasi.

## FAQ

### Bagaimana cara mendapatkan push notification saat pola log cocok?

Atur alert Loki ruler, Elastic Watcher, atau event definition Graylog yang memicu webhook ke URL aplikasi Pocket Alert Anda. Baris log yang cocok dan jumlahnya akan dikirim dalam body JSON.

### Apakah saya perlu memasang agent?

Tidak ada yang perlu dijalankan tambahan di server Anda. Pocket Alert berada di ujung pipeline yang sudah Anda miliki, sehingga Loki, Elastic, Graylog, atau skrip tail cron yang melakukan pencocokan dan hanya mengirim hasilnya.

### Bagaimana cara memetakan field log ke dalam notifikasi?

Pemetaan field GJSON membaca path apa pun dalam payload alert. Masukkan nama alert ke judul dan baris yang cocok atau jumlahnya ke pesan, misalnya %alerts.0.labels.alertname% dan %alerts.0.annotations.summary%.

### Bisakah saya memisahkan lonjakan 500 dari peringatan yang tidak penting?

Berikan setiap layanan atau environment aplikasi Pocket Alert sendiri, sehingga lonjakan 500 di prod masuk ke saluran yang berbeda dari peringatan parser yang tidak penting di staging. Feed yang tenang tetap terpisah dari yang seharusnya membangunkan Anda.

### Bagaimana cara memisahkan layanan dan environment?

Berikan setiap layanan atau environment aplikasi Pocket Alert sendiri. Dengan begitu, kegagalan autentikasi prod dan log job staging masuk ke saluran terpisah, bukan satu feed yang bising.

### Bisakah lonjakan error menembus Jangan Ganggu di malam hari?

Bisa. Tambahkan "level":"critical" ke POST dan Android akan mengirimkannya melalui channel notifikasi khusus yang melewati Jangan Ganggu. Anda cukup memberikan akses DND sekali saja. Di iPhone, high dan critical datang sebagai notifikasi sensitif waktu yang menembus mode Fokus. Anda juga bisa mengatur default_level pada webhook agar setiap alert dari pipeline tersebut tiba dengan prioritas yang sama, dan menyetel feed yang berisik ke level silent, tanpa suara atau getaran, tetapi tetap tercatat di riwayat. Paket gratis mengirim critical sebagai high: langsung sampai, tetapi tanpa melewati Jangan Ganggu.
