Notifikasi Monetisasi tidak berfungsi

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Gejala

Notifikasi Monetisasi tidak berfungsi sehingga email tidak dikirim ke pengguna yang berlangganan.

Pesan Error

Email tentang notifikasi Monetisasi kepada pengguna yang subscribe tidak akan dikirim. Tidak ada pesan error yang akan diamati.

Tentang Notifikasi peristiwa monetisasi

Monetisasi mendukung notifikasi peristiwa yang memungkinkan Anda untuk:

  1. Beri tahu semua developer tentang acara seperti produk baru, versi baru S&C, atau paket tarif baru.
  2. Beri tahu developer tertentu tentang peristiwa seperti dokumen penagihan yang dipublikasikan atau saat persentase jumlah transaksi target mereka tercapai (jika mereka membeli paket tarif notifikasi yang dapat disesuaikan).
  3. Beri tahu penyedia API tentang peristiwa terkait developer, seperti saat developer mendaftar untuk membuat akun atau saat developer mendaftar untuk paket tarif.
  4. Detail selengkapnya tentang jenis notifikasi ini dan cara menyiapkannya dapat dilihat di sini.

Prasyarat

Pastikan prasyarat berikut telah dipenuhi:

  1. Penerimaan Paket Tarif

    Untuk notifikasi Monetisasi berikut, periksa apakah developer telah menyetujui paket tarif yang sesuai :

    1. Paket Tarif Baru
    2. Paket Tarif yang Direvisi
    3. Paket Tarif Sudah Tidak Berlaku
    4. Paket Tarif yang Diperpanjang
    5. Batas Kapasitas Terlampaui
    6. Paket Tarif Freemium Habis

      Jika developer belum menyetujui paket tarif, notifikasi ini tidak akan dipicu untuk developer tersebut.

  2. Job Scheduler harus dijalankan untuk Notifikasi tertentu

    Monetisasi menyediakan penjadwal tugas dan serangkaian tugas yang telah dijadwalkan sebelumnya untuk dijalankan pada waktu yang telah ditentukan. Penjadwal tugas perlu dijalankan untuk notifikasi tertentu. Jika tidak dijalankan, notifikasi tidak akan dipicu.

    1. Gunakan petunjuk yang diberikan dalam dokumen berikut untuk melihat apakah tugas terjadwal untuk notifikasi tertentu telah berjalan:

      Menjadwalkan tugas monetisasi

      Catatan: Anda selalu dapat mengubah jadwal berdasarkan kasus penggunaan Anda.

    2. Jika tugas terjadwal untuk notifikasi tertentu telah berjalan dan Anda masih belum mendapatkan notifikasi, lanjutkan ke bagian Kemungkinan Penyebab untuk memecahkan masalah ini lebih lanjut.
    3. Jika tidak, tunggu hingga tugas terjadwal untuk notifikasi tertentu berjalan.

Kemungkinan Penyebab

Beberapa kemungkinan penyebab masalah ini adalah:

Penyebab Deskripsi Petunjuk Pemecahan Masalah Berlaku Untuk
Konfigurasi SMTP Salah Konfigurasi SMTP yang diberikan salah. Pengguna Edge Private Cloud

Jadwal tugas notifikasi

 Tugas notifikasi belum dimulai. Pengguna Edge Public Cloud dan Private Cloud

Penyebab 1: Konfigurasi SMTP Salah

Diagnosis

  1. Periksa file /opt/apigee/edge-mint-management-server/conf/apix-mint.properties dan pastikan properti SMTP berikut disetel dengan benar. 
    mint.notification.javaMail.properties={"mail.smtp.host": "smtp.gmail.com",
"mail.smtp.port": "465", "mail.smtp.starttls.enable": "true", "mail.smtp.auth": "true", "mail.smtp.username": "blah@gmail.com", "mail.smtp.password": "blah" }
  2. Pastikan setelan pengguna dan server SMTP sudah benar. Jika setelan ini salah atau tidak ditetapkan, lanjutkan ke Langkah #3. Jika ini benar, lanjutkan ke Langkah #4.
  3. Perbarui server SMTP dan setelan pengguna secara benar menggunakan petunjuk di dokumen berikut:

    /private-cloud/latest/configuring-edge-smtp-server

  4. Periksa kembali apakah notifikasi Monetisasi berfungsi. Jika belum, lanjutkan ke Langkah 5.
  5. Jika setelan SMTP benar, jalankan panggilan API Lihat notifikasi terkirim untuk melihat status notifikasi yang dikirim.
    1. API ini menampilkan JSON beserta semua notifikasi yang telah diaktifkan dan status setiap notifikasi tersebut.
    2. Contoh JSON tersedia di bawah ini: 
      {
        "hasMoreItems" : false,
        "notifications" : [ {
        "fromAlias" : "No Reply",
        "fromEmail" : "****@apigee.com",
        "id" : "4e2d0d9a-69a4-4430-957d-02fa2a3cb581",
        "notificationType" : "EMAIL",
        "orgId" : "myorg",
        "rawMessage" : "...",
        "retryCount" : 0,
        "retryStatuses" : [ {
             "responseCode" : 0,
             "responseMessage" : "{\"Headers\":null,\"Content : \":null,\"StatusCode\":\"0\"}",
             "retriedAt" : 1518605291092,
             "retryAttempt" : 0
        } ],
        "source" : "MailTo: [****@blah.com], Org: [myorg], EventType: [UPDATE_DEVELOPER]",
        "status" : "FAILED",
        "subject" : "Notification of developer changing company details",
        "templateId" : "814315c8-d8ca-4b3e-90bb-a8366600e625",
        "templateName" : "DEFAULT_UPDATE_DEVELOPER_TEMPLATE",
        "templateParametersJSON" : "{\"developer.legalName\":\"\",\"developer.name\":\"John Smith\"}",
        "toAlias" : "***@blah.com",
        "toEmail" : "***@blah.com",
        "unsubscribeURL" : "..."
}

      Jika JSON diperiksa, hasilnya akan menampilkan status 'FAILED' (GAGAL') untuk notifikasi khusus di atas 'Update Developer'.

  6. Hal ini mungkin terjadi karena server dan port SMTP mungkin tidak dapat dijangkau dari Server Pengelolaan. Gunakan perintah telnet untuk memeriksa apakah Anda dapat terhubung ke server SMTP yang ditentukan pada port yang ditentukan. 
    telnet <SMTP-server-IP-address> <SMTP-Port#>

    Jika Anda mendapatkan error "Waktu tunggu koneksi habis" atau "Koneksi ditolak" untuk output telnet, lanjutkan ke Resolusi.

Resolusi

  1. Bekerja samalah dengan administrator jaringan Anda dan pastikan server SMTP dapat menerima koneksi dari mesin lain dan juga port tertentu terbuka untuk komunikasi dari luar.
  2. Jika masalah masih berlanjut, lanjutkan ke Harus Mengumpulkan Informasi Diagnostik dengan

Penyebab 2: Jadwal Pekerjaan Pemberitahuan

Tugas notifikasi belum dimulai.

Diagnosis

  1. Jalankan panggilan API berikut untuk melihat semua tugas monetisasi yang saat ini dijadwalkan.

    /monetize/apis/get/triggers

  2. Periksa apakah kondisi notifikasi ada dan diaktifkan untuk notifikasi yang tidak berfungsi. Jika tidak ada, lanjutkan ke Langkah #3 untuk membuat kondisi notifikasi dan lewati langkah selanjutnya.
    1. Jika ada, periksa apakah statusnya diaktifkan ke true. Jika tidak, jalankan Update a notification condition and action API untuk memperbarui kondisi notifikasi.

      ATAU

    2. Gunakan UI untuk memperbarui kondisi notifikasi menggunakan proses yang diberikan dalam dokumen di bawah:

      UI Peristiwa

    3. Jalankan panggilan Create a notification condition and action API untuk membuat kondisi notifikasi yang sesuai dan tindakan yang sesuai.
      1. Setelah kondisi notifikasi dibuat, jalankan panggilan API kondisi dan tindakan notifikasi daftar untuk memverifikasi apakah kondisi notifikasi telah dibuat.
      2. Anda juga dapat memproses ulang notifikasi menggunakan Proses ulang API notifikasi.
    4. Langkah ini hanya berlaku untuk pengguna Private Cloud. Jika kondisi notifikasi ada dari langkah #1 dan email notifikasi masih belum masuk, periksa log server pengelolaan /opt/apigee/var/log/edge-management-server/logs/system.log dan lihat apakah kondisi notifikasi telah dipicu. 
      grep "Executing Mint Scheduler" /opt/apigee/var/log/edge-management-server/logs/system.log | grep  -o  "Executing Mint Scheduler : \[.*\]" | grep -v "for org : \[null\]" |sort | uniq -c
    5. Jika kondisi notifikasi dipicu, dan Anda masih belum mendapatkan notifikasi, lanjutkan ke Harus Mengumpulkan Informasi Diagnostik dengan informasi dan output dari langkah-langkah di atas yang diambil.

Resolusi

  1. Memproses ulang notifikasi menggunakan Memproses ulang API notifikasi

Harus Mengumpulkan Informasi Diagnostik

Jika masalah berlanjut bahkan setelah mengikuti petunjuk di atas, hubungi Dukungan Apigee Edge dan berikan informasi diagnostik berikut.

Pengguna Cloud Publik dan Pribadi harus memberikan informasi di bawah:

  1. Nama Organisasi
  2. Nama Lingkungan
  3. Ketentuan Notifikasi Monetisasi yang tidak berfungsi
  4. Detail tentang bagian mana dalam Playbook ini yang telah dicoba dan insight lain apa pun yang akan membantu kami menyelesaikan masalah ini dengan cepat.

Selain informasi di atas, pengguna Private Cloud juga harus memberikan informasi berikut:

  • Log Server Pengelolaan

    /opt/apigee/var/log/edge-management-server/logs/system.log