Notifikasi Monetisasi tidak berfungsi

Anda 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 orang yang berlangganan tidak akan dikirim. Tidak ada pesan error yang akan diamati.

Tentang notifikasi peristiwa Monetisasi

Monetisasi mendukung notifikasi peristiwa yang memungkinkan Anda untuk:

  1. Memberi tahu semua developer tentang peristiwa seperti produk baru, versi baru dari Syarat dan Ketentuan, atau paket tarif baru.
  2. Memberi 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. Memberi tahu penyedia API tentang peristiwa terkait developer, seperti saat developer mendaftar akun atau saat developer mendaftar paket tarif.
  4. Detail selengkapnya tentang jenis notifikasi yang ada dan cara menyiapkan notifikasi dapat ditemukan di sini.

Prasyarat

Pastikan prasyarat berikut telah terpenuhi:

  1. Penerimaan Paket Tarif

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

    1. Paket Tarif Baru
    2. Paket Tarif yang Direvisi
    3. Paket Tarif Kedaluwarsa
    4. Paket Tarif yang Diperpanjang
    5. Batas Tarif Terlampaui
    6. Paket Tarif Freemium Habis

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

  2. Penjadwal Tugas harus dijalankan untuk Notifikasi tertentu

    Monetisasi menyediakan penjadwal tugas dan sekumpulan tugas yang telah dijadwalkan untuk dijalankan pada waktu yang telah ditentukan sebelumnya. Penjadwal tugas harus 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 dijalankan:

      Menjadwalkan tugas monetisasi

      Catatan: Anda dapat mengubah jadwal kapan saja berdasarkan kasus penggunaan Anda.

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

Kemungkinan Penyebab

Beberapa kemungkinan penyebab masalah ini adalah:

Penyebab Deskripsi Petunjuk Pemecahan Masalah yang Berlaku Untuk
Konfigurasi SMTP Salah Konfigurasi SMTP yang diberikan tidak benar. 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 telah ditetapkan 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 setelan server SMTP dan pengguna sudah benar. Jika setelan ini salah atau tidak ditetapkan, lanjutkan ke Langkah #3. Jika benar, lanjutkan ke Langkah #4.
  3. Perbarui setelan server dan pengguna SMTP dengan benar menggunakan petunjuk dalam dokumen berikut:

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

  4. Periksa kembali apakah notifikasi Monetisasi kini berfungsi. Jika tidak, lanjutkan ke Langkah 5.
  5. Jika setelan SMTP sudah benar, jalankan panggilan API Lihat notifikasi yang dikirim untuk melihat status notifikasi yang dikirim.
    1. API ini menampilkan JSON dengan semua notifikasi yang telah diaktifkan dan status setiap notifikasi tersebut.
    2. Contoh JSON diberikan di bawah : 
      {
        "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 'GAGAL' untuk notifikasi tertentu di atas 'Perbarui Developer'.

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

    Jika Anda mendapatkan error "Connection timed out" atau "Connection refused" 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 port tertentu terbuka untuk dunia luar untuk komunikasi.
  2. Jika masalah masih berlanjut, lanjutkan ke Mengumpulkan Informasi Diagnostik yang Harus Dikumpulkan 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 lainnya.
    1. Jika ada, periksa apakah diaktifkan ke benar. Jika tidak, jalankan API Perbarui kondisi dan tindakan notifikasi 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 API Buat kondisi dan tindakan notifikasi untuk membuat kondisi notifikasi yang sesuai dan tindakan yang sesuai.
      1. Setelah kondisi notifikasi dibuat, jalankan panggilan API Daftar kondisi dan tindakan notifikasi untuk memverifikasi apakah kondisi notifikasi telah dibuat.
      2. Anda juga dapat memproses ulang notifikasi menggunakan API Proses ulang notifikasi.
    4. Langkah ini hanya berlaku untuk pengguna Private Cloud. Jika kondisi notifikasi ada dari langkah #1 dan email notifikasi masih belum diterima, 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 tidak mendapatkan notifikasi, lanjutkan ke Mengumpulkan Informasi Diagnostik yang Harus Dikumpulkan dengan informasi dan output dari langkah-langkah di atas yang diambil.

Resolusi

  1. Proses ulang notifikasi menggunakan API Proses ulang notifikasi

Mengumpulkan Informasi Diagnostik yang Harus Dikumpulkan

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

Pengguna Public dan Private Cloud harus memberikan informasi di bawah:

  1. Nama Organisasi
  2. Nama Lingkungan
  3. Kondisi Notifikasi Monetisasi yang tidak berfungsi
  4. Detail tentang bagian mana dalam Playbook ini yang telah dicoba dan insight lainnya yang akan membantu kami mempercepat penyelesaian masalah ini.

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