নগদীকরণ বিজ্ঞপ্তি কাজ করছে না

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

লক্ষণ

মনিটাইজেশন নোটিফিকেশনগুলো কাজ করছে না, ফলে সাবস্ক্রাইব করা ব্যবহারকারীদের কাছে ইমেল পাঠানো যাচ্ছে না।

ত্রুটি বার্তা

সাবস্ক্রাইব করা ব্যক্তিদের কাছে মনিটাইজেশন নোটিফিকেশন সংক্রান্ত ইমেল পাঠানো হবে না। কোনো ত্রুটি বার্তাও দেখা যাবে না।

নগদীকরণ ইভেন্টের বিজ্ঞপ্তি সম্পর্কে

মনিটাইজেশন ইভেন্ট নোটিফিকেশন সমর্থন করে, যা আপনাকে নিম্নলিখিত কাজগুলো করতে সক্ষম করে:

1. নতুন পণ্য, শর্তাবলীর নতুন সংস্করণ বা নতুন মূল্য পরিকল্পনার মতো ঘটনা সম্পর্কে সকল ডেভেলপারকে অবহিত করুন।
2. নির্দিষ্ট ডেভেলপারদেরকে বিভিন্ন ইভেন্ট সম্পর্কে অবহিত করুন, যেমন একটি বিলিং ডকুমেন্ট প্রকাশিত হলে অথবা তাদের লক্ষ্যমাত্রার লেনদেনের একটি নির্দিষ্ট শতাংশে পৌঁছালে (যদি তারা একটি পরিবর্তনযোগ্য নোটিফিকেশন রেট প্ল্যান কিনে থাকেন)।
3. ডেভেলপার-সম্পর্কিত ইভেন্ট, যেমন কোনো ডেভেলপার যখন অ্যাকাউন্টের জন্য নিবন্ধন করেন বা কোনো রেট প্ল্যানের জন্য সাইন আপ করেন, সে সম্পর্কে এপিআই প্রোভাইডারকে অবহিত করুন।
4. কী ধরনের নোটিফিকেশন রয়েছে এবং কীভাবে তা সেট আপ করা যায়, সে সম্পর্কে আরও বিস্তারিত তথ্য এখানে পাওয়া যাবে।

পূর্বশর্ত

নিশ্চিত করুন যে নিম্নলিখিত পূর্বশর্তগুলি পূরণ করা হয়েছে:

1. রেট প্ল্যান গ্রহণ

   নিম্নলিখিত মনিটাইজেশন নোটিফিকেশনগুলোর জন্য, ডেভেলপাররা সংশ্লিষ্ট রেট প্ল্যানটি গ্রহণ করেছেন কিনা তা যাচাই করুন:

   1. নতুন রেট প্ল্যান
   2. সংশোধিত রেট পরিকল্পনা
   3. মেয়াদোত্তীর্ণ রেট প্ল্যান
   4. নবায়িত রেট প্ল্যান
   5. হারের সীমা অতিক্রম করেছে
   6. ক্ষয়প্রাপ্ত ফ্রিমিয়াম রেট প্ল্যান

      যদি ডেভেলপার রেট প্ল্যানটি গ্রহণ না করে থাকেন, তাহলে সেই নির্দিষ্ট ডেভেলপারের জন্য এই নোটিফিকেশনগুলো পাঠানো হবে না।

2. নির্দিষ্ট নোটিফিকেশনটির জন্য জব শিডিউলার চালানো উচিত।

   মনিটাইজেশন একটি জব শিডিউলার এবং কিছু জব প্রদান করে, যেগুলো পূর্ব-নির্ধারিত সময়ে চলার জন্য আগে থেকেই শিডিউল করা থাকে। একটি নির্দিষ্ট নোটিফিকেশনের জন্য জব শিডিউলারটি চালানো প্রয়োজন। যদি এটি চালানো না হয়, তাহলে নোটিফিকেশনগুলো ট্রিগার হবে না।

   1. কোনো নির্দিষ্ট নোটিফিকেশনের জন্য নির্ধারিত কাজটি চলেছে কিনা তা দেখতে, নিম্নলিখিত ডকে প্রদত্ত নির্দেশাবলী ব্যবহার করুন:

      নগদীকরণ কাজের সময়সূচী

      দ্রষ্টব্য: আপনি আপনার প্রয়োজন অনুযায়ী সময়সূচী পরিবর্তন করতে পারেন।

   2. যদি নির্দিষ্ট নোটিফিকেশনের জন্য নির্ধারিত কাজটি ইতিমধ্যেই সম্পন্ন হয়ে থাকে এবং তারপরেও আপনি নোটিফিকেশন না পান, তাহলে এই সমস্যাটি আরও ভালোভাবে সমাধানের জন্য 'সম্ভাব্য কারণসমূহ' (Possible Causes) অংশে যান।
   3. তা না হলে, নির্দিষ্ট নোটিফিকেশনটির জন্য নির্ধারিত কাজটি সম্পন্ন হওয়া পর্যন্ত অপেক্ষা করুন।

সম্ভাব্য কারণসমূহ

এই সমস্যার কয়েকটি সম্ভাব্য কারণ হলো:

কারণ ১: SMTP কনফিগারেশন ভুল

রোগ নির্ণয়

1. /opt/apigee/edge-mint-management-server/conf/apix-mint.properties ফাইলটি পরীক্ষা করুন এবং যাচাই করুন যে নিম্নলিখিত SMTP প্রোপার্টিগুলো সঠিকভাবে সেট করা আছে কিনা।

   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. SMTP সার্ভার এবং ব্যবহারকারীর সেটিংস সঠিক আছে কিনা তা যাচাই করুন। যদি এই সেটিংস ভুল থাকে বা সেট করা না থাকে, তাহলে ধাপ #৩-এ যান। যদি এটি সঠিক থাকে, তাহলে ধাপ #৪-এ যান।
3. নিম্নলিখিত ডকে দেওয়া নির্দেশাবলী ব্যবহার করে SMTP সার্ভার এবং ব্যবহারকারীর সেটিংস সঠিকভাবে আপডেট করুন:

   /প্রাইভেট-ক্লাউড/সর্বশেষ/এজ-এসএমটিপি-সার্ভার কনফিগার করা

4. মনিটাইজেশন নোটিফিকেশনগুলো এখন কাজ করছে কিনা তা আবার যাচাই করুন। যদি না করে, তবে অনুগ্রহ করে ধাপ ৫-এ যান।
5. যদি SMTP সেটিংস সঠিক থাকে, তাহলে পাঠানো নোটিফিকেশনের অবস্থা দেখতে 'View notifications sent ' API কলটি চালান।
   1. এই API-টি একটি JSON ফাইল রিটার্ন করে, যাতে পাঠানো সমস্ত নোটিফিকেশন এবং সেগুলোর প্রতিটির স্ট্যাটাস উল্লেখ থাকে।
   2. নীচে একটি নমুনা JSON দেওয়া হল:

      {
              "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" : "..."
      }

      আপনি যদি JSON চেক করেন, তাহলে দেখতে পাবেন যে উপরে উল্লিখিত 'Update Developer' নোটিফিকেশনটির স্ট্যাটাস 'FAILED' হিসেবে দেখানো হয়েছে।

6. এর একটি সম্ভাব্য কারণ হতে পারে যে, ম্যানেজমেন্ট সার্ভার থেকে SMTP সার্ভার এবং পোর্টটি অ্যাক্সেসযোগ্য নয়। নির্দিষ্ট পোর্টে নির্দিষ্ট SMTP সার্ভারে সংযোগ করতে পারছেন কিনা তা পরীক্ষা করার জন্য telnet কমান্ডটি ব্যবহার করুন।

   telnet <SMTP-server-IP-address> <SMTP-Port#>

   যদি টেলনেট আউটপুটে "Connection timed out" বা "Connection refused" ত্রুটি বার্তা পান, তাহলে সমাধান অংশে যান।

সমাধান

1. আপনার নেটওয়ার্ক অ্যাডমিনিস্ট্রেটরের সাথে কাজ করে নিশ্চিত করুন যে, SMTP সার্ভারটি অন্যান্য মেশিন থেকে সংযোগ গ্রহণ করতে সক্ষম এবং যোগাযোগের জন্য নির্দিষ্ট পোর্টটিও বহির্বিশ্বের জন্য খোলা আছে।
2. যদি সমস্যাটি এখনও থেকে যায়, তাহলে অবশ্যই ডায়াগনস্টিক তথ্য সংগ্রহ করার ধাপে এগিয়ে যান।

কারণ ২: বিজ্ঞপ্তি কাজের সময়সূচী

নোটিফিকেশনের কাজটি শুরু হয়নি।

রোগ নির্ণয়

1. বর্তমানে নির্ধারিত সমস্ত মনিটাইজেশন জব দেখতে নিম্নলিখিত API কলটি চালান।

   /monetize/apis/get/triggers

2. যে নোটিফিকেশনটি কাজ করছে না, সেটির জন্য নোটিফিকেশন কন্ডিশনটি আছে এবং সক্রিয় করা আছে কিনা তা পরীক্ষা করুন। যদি তা না থাকে, তাহলে নোটিফিকেশন কন্ডিশন তৈরি করতে ধাপ #৩-এ যান এবং বাকি ধাপগুলো এড়িয়ে যান।
   1. যদি এটি উপস্থিত থাকে, তাহলে এটি 'true' তে সক্রিয় করা আছে কিনা তা পরীক্ষা করুন। যদি না থাকে, তাহলে নোটিফিকেশন কন্ডিশন আপডেট করার জন্য 'Update a notification condition and action API' চালান।

      অথবা

   2. নিচের ডকে দেওয়া পদ্ধতি অনুসরণ করে UI ব্যবহার করে নোটিফিকেশন কন্ডিশন আপডেট করুন:

      ইভেন্ট UI

   3. উপযুক্ত নোটিফিকেশন কন্ডিশন এবং সংশ্লিষ্ট অ্যাকশন তৈরি করতে 'Create a notification condition and action' এপিআই কলটি চালান।
      1. নোটিফিকেশন কন্ডিশন তৈরি হয়ে গেলে, সেটি তৈরি হয়েছে কিনা তা যাচাই করতে 'List notification conditions and actions' এপিআই কলটি চালান।
      2. আপনি 'Reprocess a notification API' ব্যবহার করে নোটিফিকেশনটি পুনরায় প্রসেস করতে পারেন।
   4. এই ধাপটি শুধুমাত্র প্রাইভেট ক্লাউড ব্যবহারকারীদের জন্য প্রযোজ্য। যদি ধাপ #১ থেকে নোটিফিকেশন শর্তটি পূরণ হয় এবং তারপরেও নোটিফিকেশন ইমেল না আসে, তাহলে ম্যানেজমেন্ট সার্ভার লগ /opt/apigee/var/log/edge-management-server/logs/system.log চেক করে দেখুন নোটিফিকেশন শর্তটি ট্রিগার হয়েছে কিনা।

      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. যদি নোটিফিকেশন শর্তটি পূরণ হয় এবং তারপরেও আপনি নোটিফিকেশন না পান, তাহলে উপরের ধাপগুলো থেকে সংগৃহীত তথ্য ও আউটপুট ব্যবহার করে 'অবশ্যই ডায়াগনস্টিক তথ্য সংগ্রহ করুন' ধাপে এগিয়ে যান।

সমাধান

1. রিপ্রসেস এ নোটিফিকেশন এপিআই ব্যবহার করে নোটিফিকেশনটি পুনরায় প্রক্রিয়া করুন।

রোগ নির্ণয়ের তথ্য অবশ্যই সংগ্রহ করতে হবে

উপরোক্ত নির্দেশাবলী অনুসরণ করার পরেও যদি সমস্যাটি থেকে যায়, তাহলে অনুগ্রহ করে Apigee Edge Support-এর সাথে যোগাযোগ করুন এবং নিম্নলিখিত ডায়াগনস্টিক তথ্য প্রদান করুন।

পাবলিক ও প্রাইভেট ক্লাউড ব্যবহারকারীদের নিম্নলিখিত তথ্যগুলো প্রদান করতে হবে:

1. সংস্থার নাম
2. পরিবেশের নাম
3. নগদীকরণ বিজ্ঞপ্তির শর্ত যা কাজ করেনি
4. এই প্লেবুকের কোন কোন অংশ চেষ্টা করা হয়েছে সে সম্পর্কিত বিবরণ এবং অন্য কোনো তথ্য যা এই সমস্যার সমাধান দ্রুত করতে আমাদের সাহায্য করবে।

উপরোক্ত তথ্য ছাড়াও প্রাইভেট ক্লাউড ব্যবহারকারীদের নিম্নলিখিত তথ্যগুলোও প্রদান করতে হবে:

• ম্যানেজমেন্ট সার্ভার লগ
  
  /opt/apigee/var/log/edge-management-server/logs/system.log