Panduan

Menyiapkan Notifikasi Pemantauan

Ada beberapa pemberitahuan yang telah ditetapkan sebelumnya di dasbor pemantauan. Saat pemberitahuan berganti status, notifikasi dikirimkan. Untuk menerima pemberitahuan dari Grafana, Anda harus mengonfigurasi saluran notifikasi.

Grafana mendukung berbagai jenis notifikasi (email, Slack, Webhooks, dsb.). Silakan buka dokumentasi Grafana untuk selengkapnya tentang dukungan jenis notifikasi.

Dokumen ini mencakup pengaturan saluran notifikasi umum seperti: email, Slack, PagerDuty, dan Webhooks.

Sebelum menyiapkan notifikasi, pastikan kontainer pemantauan Anda sudah berjalan.

Email

  1. Konfigurasikan Pengaturan SMTP di file monitoring-compose.yml. 
    services:
  ...
  grafana:
  ...
    environment:
      GF_SECURITY_ADMIN_PASSWORD: ${GF_SECURITY_ADMIN_PASSWORD:?Missing env GF_SECURITY_ADMIN_PASSWORD for Grafana admin password}
      WA_PROMETHEUS_ENDPOINT: ${WA_PROMETHEUS_ENDPOINT:-http://prometheus:9090}
      GF_SERVER_ROOT_URL: your-grafana-public-endpoint #(ex. https://foo.bar.com:3000)
      GF_SMTP_ENABLED: 1
      GF_SMTP_HOST: your-smtp-host #(ex. smtp.gmail.com:465)
      GF_SMTP_USER: your-smtp-auth-user #(ex. you@email.com)
      GF_SMTP_PASSWORD: your-smtp-auth-password
      GF_SMTP_SKIP_VERIFY: 1
    depends_on:
      - 'prometheus'
  2. Mulai Ulang Grafana. 
    docker-compose -f monitoring-compose.yml up -d
  3. Akses Notification channels di panel Alerting.
    Saluran Notifikasi
  4. Masukkan alamat email Anda dan uji pengaturan Anda dengan mengeklik tombol Send Test.
    Kirim Tes
    Jika konfigurasi sudah benar, Anda akan menerima email seperti ini:
    Email Grafana
    Jika tidak, periksa log kontainer Grafana Anda untuk melakukan debug.
  5. Klik Save untuk menyimpan pengaturan Anda. Setelah itu, Anda akan menerima pemberitahuan dari Grafana. Lihat dokumentasi notifikasi email Grafana untuk detail selengkapnya.

Slack

  1. Buat Aplikasi Slack dengan memasukkan nama (misal: pemberitahuan) dan pilih workspace untuk menginstal aplikasi Anda.
  2. Klik tombol Incoming Webhooks untuk menambahkan fitur ini ke aplikasi Anda.
    Webhooks Masuk
  3. Klik tombol Activate Incoming Webhooks untuk mengaktifkannya, lalu klik Add New Webhook to Workspace.
    Tambahkan Webhooks Baru ke Workspace
  4. Pilih saluran yang akan menjadi tujuan postingan aplikasi, dan klik tombol Authorize untuk mengotorisasi aplikasi Anda.
  5. Salin URL Webhook (misal: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX) untuk menyiapkan notifikasi Slack di Grafana. Uji penyiapan Anda dengan mengeklik tombol Send Test. Jika konfigurasi sudah benar, Anda akan menerima pesan di saluran yang telah dikonfigurasi, seperti ini:
    Notifikasi Slack
    Jika tidak, periksa log kontainer Grafana Anda untuk melakukan debug.
  6. Klik Save untuk menyimpan pengaturan Anda. Setelah itu, Anda akan menerima pemberitahuan dari Grafana. Lihat dokumentasi notifikasi Slack Grafana untuk detail selengkapnya.

PagerDuty

  1. Tambahkan layanan baru (misal: https://XXXX.pagerduty.com/services/new), dan pilih Use our API directly sebagai Integration Type.
    Tambahkan Layanan
  2. Salin Kunci Integrasi (misal: de7439f367354513b9e1ba4042f0e3b8) untuk menyiapkan notifikasi PagerDuty di Grafana. Uji penyiapan Anda dengan mengeklik tombol Send Test. Jika konfigurasi sudah benar, Anda akan menerima pemberitahuan di Halaman Pemberitahuan PagerDuty, seperti ini:
    Notifikasi PagerDuty
    Jika tidak, periksa log kontainer Grafana Anda untuk melakukan debug.
  3. Klik Save untuk menyimpan pengaturan Anda. Setelah itu, Anda akan menerima pemberitahuan dari Grafana. Lihat dokumentasi notifikasi PagerDuty Grafana untuk detail selengkapnya.

Webhooks

Anda juga dapat menyiapkan server Webhooks untuk menerima pemberitahuan.

  1. Menyiapkan notifikasi Webhooks di Grafana. Uji penyiapan Anda dengan mengeklik tombol Send Test. Jika konfigurasi sudah benar, Anda akan menerima muatan JSON, seperti ini: 
    {
    "evalMatches": [
        {
            "metric": "High value",
            "tags": null,
            "value": 100
        },
        {
            "metric": "Higher Value",
            "tags": null,
            "value": 200
        }
    ],
    "message": "Someone is testing the alert notification within grafana.",
    "ruleId": 0,
    "ruleName": "Test notification",
    "ruleUrl": "http://localhost:3000/",
    "state": "alerting",
    "title": "[Alerting] Test notification"
}
    Jika tidak, periksa log kontainer Grafana Anda untuk melakukan debug.
  2. Klik Save untuk menyimpan pengaturan Anda. Setelah itu, Anda akan menerima pemberitahuan dari Grafana. Lihat dokumentasi notifikasi Webhooks Grafana untuk detail selengkapnya.