Notifikasi Monetisasi tidak berfungsi

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

ini.

Gejala

Notifikasi Monetisasi tidak berfungsi sehingga email tidak dikirim ke pengguna 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, Persyaratan & Ketentuan versi baru, atau paket tarif baru.
  2. Memberi tahu developer tertentu tentang peristiwa seperti dokumen penagihan yang dipublikasikan atau ketika 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 mendapatkan akun atau saat developer mendaftar paket tarif.
  4. Detail selengkapnya tentang jenis notifikasi yang ada dan cara menyiapkannya dapat ditemukan 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 Diperpanjang
    5. Batas Jumlah 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 dapat mengubah jadwal kapan saja 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 yang 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 verifikasi apakah properti SMTP berikut sudah 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. Verifikasi apakah server SMTP dan setelan pengguna sudah benar. Jika setelan ini salah atau tidak disetel, lanjutkan ke Langkah #3. Jika sudah benar, lanjutkan ke Langkah #4.
  3. Perbarui server SMTP dan setelan pengguna dengan benar menggunakan petunjuk dalam dokumen berikut:

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

  4. Periksa kembali apakah notifikasi Monetisasi kini berfungsi. Jika belum, lanjutkan ke Langkah 5.
  5. Jika setelan SMTP sudah benar, jalankan panggilan API View notifications sent untuk melihat status notifikasi yang dikirim.
    1. API ini menampilkan JSON dengan semua notifikasi yang telah diaktifkan dan status setiap notifikasi.
    2. Contoh JSON diberikan 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 Anda memeriksa JSON, statusnya akan ditampilkan sebagai 'FAILED' untuk pemberitahuan 'Update Developer' di atas.

  6. Hal ini mungkin disebabkan 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 pesan error "Waktu koneksi habis" atau "Koneksi ditolak" untuk {i>output<i} telnet, lalu lanjutkan ke Resolution.

Resolusi

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

Penyebab 2: Jadwal Tugas Notifikasi

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 atribut tersebut diaktifkan ke true. Jika tidak, jalankan Update a notifikasi condition and action API untuk memperbarui kondisi notifikasi.

      ATAU

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

      UI Peristiwa

    3. Jalankan panggilan Create a notifikasi condition and action API untuk membuat kondisi notifikasi yang tepat dan tindakan yang sesuai.
      1. Setelah kondisi notifikasi dibuat, jalankan panggilan Daftar kondisi notifikasi dan API tindakan untuk memverifikasi apakah kondisi notifikasi telah dibuat.
      2. Anda juga dapat memproses ulang notifikasi menggunakan Memproses 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 terpicu, dan Anda masih belum mendapatkan notifikasi, lanjutkan ke Harus Mengumpulkan Informasi Diagnostik dengan informasi dan output dari langkah di atas yang direkam.

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 berikut:

  1. Nama Organisasi
  2. Nama Lingkungan
  3. Kondisi Notifikasi Monetisasi yang tidak berfungsi
  4. Detail tentang bagian mana saja dalam Playbook ini yang telah dicoba dan insight lain 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