Mengonfigurasi pengaturan SMTP

Dalam panduan ini, Anda mempelajari cara mengonfigurasi pengaturan SMTP untuk menghasilkan pemberitahuan email di Azure Managed Grafana. Pemberitahuan memperingatkan pengguna ketika beberapa skenario tertentu terjadi di dasbor Grafana.

Pengaturan SMTP dapat diaktifkan pada instans Azure Managed Grafana yang ada melalui portal Azure dan Azure CLI. Mengaktifkan pengaturan SMTP saat membuat instans baru saat ini tidak didukung.

Prasyarat

Untuk mengikuti langkah-langkah dalam panduan ini, Anda harus memiliki:

• Akun Azure dengan langganan aktif. Buat akun secara gratis.
• Instans Azure Managed Grafana dalam paket Standar. Jika Anda belum memilikinya, buat instans baru.
• Server SMTP. Jika Anda belum memilikinya, Anda mungkin ingin mempertimbangkan untuk menggunakan API email Twilio SendGrid untuk Azure.

Mengaktifkan dan mengonfigurasi pengaturan SMTP

Ikuti langkah-langkah ini untuk mengaktifkan pengaturan SMTP, mengaktifkan pemberitahuan email, dan mengonfigurasi titik kontak email di Azure Managed Grafana.

Portal

1. Di portal Azure, buka instans Grafana Anda dan di bawah Pengaturan, pilih Konfigurasi.

2. Pilih tab Pengaturan Email.

3. Aktifkan Pengaturan SMTP, sehingga Aktifkan ditampilkan.

4. Pengaturan SMTP muncul. Isi formulir dengan konfigurasi berikut:

   Parameter	Contoh	Deskripsi
   Host	test.sendgrid.net:587	Masukkan nama host server SMTP dengan port.
   User	admin	Masukkan nama pengguna autentikasi SMTP.
   Kata sandi	kata sandi	Masukkan kata sandi autentikasi SMTP. Jika kata sandi berisi "#" atau ";" bungkus dalam tanda kutip tiga kali lipat.
   Dari Alamat	user@domain.com	Masukkan alamat email yang digunakan saat mengirim email.
   Dari Nama	Pemberitahuan Grafana Terkelola Azure	Masukkan nama yang digunakan saat mengirim email. Defaultnya adalah "Pemberitahuan Grafana Terkelola Azure" jika parameter tidak diberikan atau kosong.
   Lewati Verifikasi	Nonaktifkan	Pengaturan ini mengontrol apakah klien memverifikasi rantai sertifikat server dan nama host. Jika Lewati Verifikasi adalah Aktifkan, klien menerima sertifikat apa pun yang disajikan oleh server dan nama host apa pun dalam sertifikat tersebut. Dalam mode ini, TLS rentan terhadap serangan mesin di tengah kecuali verifikasi kustom digunakan. Defaultnya adalah Nonaktifkan (nonaktif). Informasi selengkapnya.
   Kebijakan StartTLS	OpportunisticStartTLS	Ada tiga opsi. Informasi selengkapnya. OpportunisticStartTLS berarti bahwa transaksi SMTP dienkripsi jika STARTTLS didukung oleh server SMTP. Jika tidak, pesan dikirim dengan jelas. Ini adalah pengaturan default. MandatoryStartTLS berarti bahwa transaksi SMTP harus dienkripsi. Transaksi SMTP dibatalkan kecuali STARTTLS didukung oleh server SMTP. NoStartTLS berarti enkripsi dinonaktifkan dan pesan dikirim dengan jelas.

5. Pilih Simpan untuk menyimpan pengaturan SMTP. Pembaruan mungkin memakan waktu beberapa menit.

   

6. Setelah proses selesai, pesan "Memperbarui pilihan. Pembaruan berhasil" ditampilkan di Pemberitahuan Azure. Di halaman Gambaran Umum , status provisi instans beralih ke Pembaruan, lalu Berhasil setelah pembaruan selesai.

Azure CLI

1. Ekstensi CLI Azure Managed Grafana 1.1 atau lebih tinggi diperlukan untuk mengaktifkan atau memperbarui pengaturan SMTP. Untuk memperbarui ekstensi Anda, jalankan az extension update --name amg.

2. Jalankan perintah az grafana update untuk mengonfigurasi pengaturan SMTP untuk instans Azure Managed Grafana tertentu. Ganti tempat penampung dengan informasi dari instans Anda sendiri.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp enabled \
       --from-address <from-address> \
       --from-name <from-name> \
       --host "<host>" \
       --user <user> \
       --password "<password>" \
       --start-tls-policy <start-TLS-policy> \
       --skip-verify <true-or-false> \
   

   Parameter	Contoh	Deskripsi
   --resource-group	my-resource-group	Masukkan nama grup sumber daya instans Azure Managed Grafana.
   --name	my-azure-managed-grafana	Masukkan nama instans Azure Managed Grafana.
   --smtp	diaktifkan	Masukkan diaktifkan untuk menonaktifkan pengaturan SMTP.
   --from-address	user@domain.com	Masukkan alamat email yang digunakan saat mengirim email.
   --from-name	Pemberitahuan Grafana Terkelola Azure	Masukkan nama yang digunakan saat mengirim email. Defaultnya adalah "Pemberitahuan Grafana Terkelola Azure" jika parameter tidak diberikan atau kosong.
   --host	test.sendgrid.net:587	Masukkan nama host server SMTP dengan port.
   --user	admin	Masukkan nama pengguna autentikasi SMTP.
   --password	kata sandi	Masukkan kata sandi autentikasi SMTP. Jika kata sandi berisi "#" atau ";" bungkus dalam tanda kutip tiga kali lipat.
   --start-tls-policy	OpportunisticStartTLS	Pengaturan StartTLSPolicy dari konfigurasi SMTP. Ada tiga opsi. Informasi selengkapnya. OpportunisticStartTLS berarti bahwa transaksi SMTP dienkripsi jika STARTTLS didukung oleh server SMTP. Jika tidak, pesan dikirim dengan jelas. Ini adalah pengaturan default. MandatoryStartTLS berarti bahwa transaksi SMTP harus dienkripsi. Transaksi SMTP dibatalkan kecuali STARTTLS didukung oleh server SMTP. NoStartTLS berarti enkripsi dinonaktifkan dan pesan dikirim dengan jelas.
   --skip-verify	salah	Pengaturan ini mengontrol apakah klien memverifikasi rantai sertifikat server dan nama host. Jika --skip-verify benar, klien menerima sertifikat apa pun yang disajikan oleh server dan nama host apa pun dalam sertifikat tersebut. Dalam mode ini, TLS rentan terhadap serangan mesin di tengah kecuali verifikasi kustom digunakan. Default adalah salah. Informasi selengkapnya.

Tip

Berikut adalah beberapa tips untuk mengonfigurasi SMTP dengan benar:

• Saat menggunakan akun email bisnis seperti Office 365, Anda mungkin perlu menghubungi administrator email Anda untuk mengaktifkan SMTP AUTH (misalnya, enable-smtp-auth-for-specific-mailboxes). Anda harus dapat membuat kata sandi aplikasi setelah itu dan menggunakannya sebagai pengaturan kata sandi SMTP.
• Saat menggunakan akun email pribadi seperti Outlook atau Gmail, Anda harus membuat kata sandi aplikasi dan menggunakannya sebagai pengaturan kata sandi SMTP. Perhatikan bahwa akun Anda tidak akan berfungsi untuk pemberitahuan email jika dikonfigurasi dengan autentikasi multifaktor.
• Disarankan agar Anda memverifikasi konfigurasi SMTP agar berfungsi seperti yang diharapkan sebelum menerapkannya ke ruang kerja Managed Grafana Anda. Misalnya, Anda dapat menggunakan alat sumber terbuka seperti swaks (Swiss Army Knife for SMTP) untuk mengirim email pengujian menggunakan konfigurasi SMTP dengan menjalankan perintah berikut di jendela terminal:

  # fill in all the empty values for the following parameters
  host="" # SMTP host name with port separated by a ":", e.g. smtp.office365.com:587
  user="" # email address, e.g. team1@microsoft.com
  password="" # password
  fromAddress="" # source email address (usually the same as user above), e.g. team1@contoso.com
  toAddress="" # destination email address, e.g. team2@contoso.com
  ehlo="" # grafana endpoint, e.g. team1-ftbghja6ekeybng8.wcus.grafana.azure.com
  
  header="Subject:Test"
  body="Testing!"
  
  # test SMTP connection by sending an email
  swaks --auth -tls \
      --server $host \
      --auth-user $user \
      --auth-password $password \
      --from $fromAddress \
      --to $toAddress \
      --ehlo $ehlo \
      --header $header \
      --body $body
  

Mengonfigurasi titik kontak Grafana dan mengirim email pengujian

Mengonfigurasi titik kontak Grafana dilakukan di portal Grafana:

1. Di ruang kerja Azure Managed Grafana Anda, di Gambaran Umum, pilih URL Titik Akhir.

2. Buka Pemberitahuan > Titik kontak.

3. Pilih Titik kontak baru atau Edit titik kontak untuk memperbarui titik kontak yang sudah ada.

   

4. Tambahkan atau perbarui Nama, dan Jenis titik kontak.

5. Masukkan email tujuan di bawah Alamat, dan pilih Uji.

6. Pilih Kirim pemberitahuan pengujian untuk mengirim pemberitahuan dengan pesan pengujian yang telah ditentukan sebelumnya atau pilih Kustom untuk terlebih dahulu mengedit pesan.

7. Pemberitahuan "Pemberitahuan uji terkirim" ditampilkan, yang berarti bahwa penyiapan email telah berhasil dikonfigurasi. Email pengujian telah dikirim ke alamat email yang disediakan. Jika ada kesalahan konfigurasi, pesan kesalahan ditampilkan sebagai gantinya.

Menonaktifkan pengaturan SMTP

Untuk menonaktifkan pengaturan SMTP, ikuti langkah-langkah ini.

Portal

1. Di portal Azure, buka Pengaturan Email Konfigurasi > dan alihkan Pengaturan SMTP, sehingga Nonaktifkan ditampilkan.
2. Pilih Simpan untuk memvalidasi dan mulai memperbarui instans Azure Managed Grafana.

Azure CLI

1. Ekstensi CLI Azure Managed Grafana 1.1 atau lebih tinggi diperlukan untuk menonaktifkan pengaturan SMTP. Untuk memperbarui ekstensi Anda, jalankan az extension update --name amg.

2. Jalankan perintah az grafana update untuk mengonfigurasi pengaturan SMTP untuk instans Azure Managed Grafana tertentu. Ganti tempat penampung dengan informasi dari instans Anda sendiri.

   az grafana update --resource-group <resource-group> \
       --name <azure-managed-grafana-name> \
       --smtp disabled
   

   Parameter	Contoh	Deskripsi
   --resource-group	my-resource-group	Masukkan nama grup sumber daya instans Azure Managed Grafana.
   --name	my-azure-managed-grafana	Masukkan nama instans Azure Managed Grafana.
   --smtp	dinonaktifkan	Masukkan dinonaktifkan untuk menonaktifkan pengaturan SMTP.

Catatan

Saat pengguna menonaktifkan pengaturan SMTP, semua kredensial SMTP dihapus dari backend. Azure Managed Grafana tidak akan mempertahankan kredensial SMTP saat dinonaktifkan.

Grafana memperingatkan pesan kesalahan

Dalam portal Grafana, Anda dapat menemukan daftar semua pesan kesalahan peringatan Grafana yang terjadi di Pemberitahuan Pemberitahuan>.

Berikut ini adalah beberapa pesan kesalahan umum yang mungkin Anda temui:

• "Autentikasi gagal: Pemberian otorisasi yang disediakan tidak valid, kedaluwarsa, atau dicabut". Grafana tidak dapat tersambung ke server SMTP. Periksa apakah kata sandi yang dimasukkan dalam pengaturan SMTP di portal Azure sudah benar.
• "Gagal mengirim pemberitahuan pengujian: SMTP tidak dikonfigurasi". SMTP dinonaktifkan. Buka instans Azure Managed Grafana di portal Azure dan aktifkan pengaturan SMTP.

Langkah berikutnya

Dalam panduan cara ini, Anda mempelajari cara mengonfigurasi pengaturan Grafana SMTP. Untuk mempelajari cara membuat laporan dan mengirim email ke penerima, lihat Membuat dasbor.