Mengonfigurasi saluran notifikasi untuk pemberitahuan

Halaman ini menguraikan proses untuk mengonfigurasi saluran notifikasi guna menerima pemberitahuan.

Saluran notifikasi adalah mekanisme pengiriman untuk pemberitahuan yang dikonfigurasi. Sistem akan memberi tahu penerima yang ditentukan melalui saluran ini saat peristiwa memicu pemberitahuan. Proses ini memastikan bahwa pemberitahuan penting menjangkau personel yang tepat melalui metode komunikasi pilihan mereka.

Di lingkungan perangkat dengan air gap Google Distributed Cloud (GDC), saluran notifikasi yang telah ditentukan sebelumnya seperti Slack atau email tidak tersedia. Untuk menerima pemberitahuan, Anda harus mengonfigurasi setidaknya satu saluran notifikasi kustom. Anda mengedit resource kustom ObservabilityPipeline di namespace project untuk menerapkan konfigurasi channel.

Dengan menyesuaikan saluran notifikasi, administrator dapat melakukan hal berikut:

  • Menargetkan penerima tertentu: Mengarahkan pemberitahuan langsung ke individu, tim, atau rotasi petugas yang bertugas yang bertanggung jawab untuk mengatasi masalah.
  • Menggunakan metode komunikasi pilihan: Kirimkan pemberitahuan melalui saluran seperti SMS, PagerDuty, webhook, atau integrasi kustom, yang disesuaikan dengan preferensi individu dan alur kerja operasional.
  • Mencegah kelelahan merespons peringatan: Kurangi gangguan dan pastikan bahwa peringatan diterima oleh orang yang perlu mengambil tindakan.

Penerapan saluran notifikasi di GDC mengharuskan administrator menentukan konfigurasi saluran dalam sistem. Proses ini biasanya melibatkan penentuan parameter seperti:

  • Jenis saluran: jenis saluran yang digunakan.
  • Tujuan: endpoint tempat sistem harus mengirim notifikasi.
  • Autentikasi: kredensial yang diperlukan untuk mengakses tujuan.

Dengan mengonfigurasi saluran notifikasi, administrator dapat memastikan bahwa platform pemantauan secara efektif menyampaikan pemberitahuan penting, sehingga memungkinkan respons cepat terhadap potensi masalah dan menjaga stabilitas serta performa lingkungan GDC.

Sebelum memulai

Untuk mendapatkan izin yang Anda perlukan untuk mengelola ObservabilityPipelineresource kustom, minta Admin IAM Organisasi atau Admin IAM Project Anda untuk memberi Anda salah satu ObservabilityPipelineperan terkait.

Selain itu, untuk mendapatkan izin yang diperlukan guna mengelola objek ConfigMap di namespace project Anda yang diperlukan untuk menentukan aturan konfigurasi, minta Admin IAM Organisasi atau Admin IAM Project Anda untuk memberi Anda peran Pembuat ConfigMap.

Bergantung pada tingkat akses dan izin yang Anda perlukan, Anda mungkin mendapatkan peran pembuat, editor, atau pelihat untuk resource ini dalam organisasi atau project. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan izin IAM.

Mengonfigurasi saluran notifikasi

Konfigurasi saluran notifikasi untuk pemberitahuan di namespace project Anda:

  1. Tentukan konfigurasi kustom untuk saluran notifikasi dalam file YAML bernama alertmanager.yml. Anda harus mengikuti sintaksis yang sama dengan spesifikasi Alertmanager:

    https://prometheus.io/docs/alerting/latest/configuration/.

  2. Buat objek ConfigMap dan sertakan konfigurasi kustom Anda dari file alertmanager.yml di kolom data.

    Contoh berikut menunjukkan tampilan objek ConfigMap dengan file alertmanager.yml:

    apiVersion: v1
kind: ConfigMap
metadata:
  name: CONFIGMAP_NAME
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
data:
  # The file name must be alertmanager.yml
  alertmanager.yml: |
    # Define your notification channels.
    # Add the custom configuration in the following lines of this file.
    # Follow the same syntax as in https://prometheus.io/docs/alerting/latest/configuration

  [...]

    Ganti kode berikut:

    • CONFIGMAP_NAME: nama file definisi ConfigMap. Anda akan menggunakan nama ini nanti di resource kustom ObservabilityPipeline.
    • PROJECT_NAMESPACE: namespace project Anda.

  3. Terapkan objek ConfigMap ke server Management API dalam namespace yang sama dengan pemberitahuan yang dikonfigurasi:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f CONFIGMAP_NAME.yaml

    Ganti kode berikut:

    • KUBECONFIG_PATH: jalur ke file kubeconfig untuk server Management API.
    • CONFIGMAP_NAME: nama file definisi ConfigMap.

  4. Edit spesifikasi resource kustom ObservabilityPipeline untuk mengimpor konfigurasi Anda ke kolom alertmanagerConfig:

     # Configure the observability pipeline.
apiVersion: observability.gdc.goog/v1
kind: ObservabilityPipeline
metadata:
  # The namespace must match your project namespace.
  namespace: PROJECT_NAMESPACE
  name: OBSERVABILITY_PIPELINE_NAME
spec:
  # Configure alerts.
  alerting:
    # The alerting configuration must be in the ConfigMap.
    # The value must match the ConfigMap name exactly.
    alertmanagerConfig: CONFIGMAP_NAME

  [...]

    Ganti kode berikut:

    • PROJECT_NAMESPACE: namespace project Anda.
    • OBSERVABILITY_PIPELINE_NAME: nama resource kustom ObservabilityPipeline.
    • CONFIGMAP_NAME: nama yang Anda gunakan untuk file definisi ConfigMap. Nama harus sama persis.

  5. Simpan file.

  6. Terapkan perubahan resource kustom ObservabilityPipeline ke server Management API dalam namespace yang sama dengan pemberitahuan yang Anda konfigurasi:

    kubectl --kubeconfig KUBECONFIG_PATH apply -f OBSERVABILITY_PIPELINE_NAME.yaml

    Ganti kode berikut:

    • KUBECONFIG_PATH: jalur ke file kubeconfig untuk server Management API.
    • OBSERVABILITY_PIPELINE_NAME: nama file definisi ObservabilityPipeline.