আপলোড স্ট্যাটাস ও সমস্যা চেক করা

আপনি যেকোনও সময় Apigee API Hub-এ কোয়েরি করে প্রাইভেট ক্লাউড কানেক্টরের লোকাল স্ট্যাটাস এন্ডপয়েন্ট থেকে মেটাডেটা ও রানটাইম ডেটা আপলোডের স্ট্যাটাস চেক করতে পারবেন।

আপলোড স্ট্যাটাস চেক করা

প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API হাব রান করছে এমন ভার্চুয়াল মেশিনে নিম্নলিখিত curl কমান্ড ব্যবহার করুন:

curl localhost:8080/v1/uapim/status
সফল রেসপন্স নিম্নলিখিতগুলির মতো একটি JSON অবজেক্ট রিটার্ন করে:
  {
 "apiSyncStatus": [
   {
     "organization": "foo",
     "phase": "Preparing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 100,
           "pendingItems": 90,
           "completedItems": 6,
           "failedItems": 4
         }
       },
       "environment": { //environment upload status
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 1,
           "completedItems": 3,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "bar",
     "phase": "Processing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 110,
           "pendingItems": 16,
           "completedItems": 3,
           "failedItems": 1
         }
       },
       "environment": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 3,
           "completedItems": 1,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "test",
     "phase": "Queued",
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ],
 "analyticsSyncStatus": [
   {
     "organization": "test",
     "environment": "dev",
     "failedItems": 2,
     "lastUpdated": "2025-04-16T00:56:45Z"
   },
   {
     "organization": "test",
     "environment": "prod",
     "failedItems": 4,
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ]
}

আউটপুট থেকে এইসব বিষয়ে ইনসাইট পাওয়া যায়:

  • API মেটাডেটা: API মেটাডেটা আপলোডের স্ট্যাটাস, যার মধ্যে রয়েছে সংস্থা, এনভায়রনমেন্ট, বর্তমান স্টেজ (যেমন, "প্রস্তুতি চলছে", "প্রসেস করা হচ্ছে", "সারিতে আছে"), মোট/সম্পূর্ণ/বাকি থাকা আপলোড, ভুলের সংখ্যা এবং শেষ আপডেট করার সময়।
  • রানটাইম মেটাডেটা: রানটাইম ডেটা আপলোডের স্ট্যাটাস, এতে সংস্থা, এনভায়রনমেন্ট, সমস্যার সংখ্যা ও শেষ আপডেট করার সময় দেখানো হয়।

সাধারণ সমস্যা ও তার সমাধান করার ধাপ

আপনি সমস্যার সম্মুখীন হলে, কানেক্টরের লগ ও স্ট্যাটাস এন্ডপয়েন্ট দেখুন। Apigee হাব কানেক্টরের মূল লগ ফাইল /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log-এ থাকে

  1. প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API Hub চালু হয় না:
    • লগ চেক করুন: কনফিগারেশন সম্পর্কিত সমস্যার মেসেজের জন্য /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log পরীক্ষা করুন।
    • সেটিংস যাচাই করুন: uapim-connector.properties এবং এনভায়রনমেন্ট ভেরিয়েবলে কনফিগার করা সব সেটিংস ডবল-চেক করুন।
    • Pub/sub অ্যাক্সেস: opdk-connector প্রদান করা Pub/Sub টপিক অ্যাক্সেস করতে পারছে কিনা তা লগ থেকে যাচাই করুন।
    • ম্যানেজমেন্ট সার্ভার অ্যাক্সেস: প্রদত্ত URL ও ক্রেডেনশিয়াল দিয়ে opdk-connector Apigee ম্যানেজমেন্ট সার্ভারকে সফলভাবে কল করতে পারছে কিনা তা লগ চেক করে দেখুন।
    • চালু হওয়ার সময়: আপনার Apigee এনভায়রনমেন্টে হাজার হাজার ডিপ্লয়মেন্ট থাকলে, Apigee হাব কানেক্টর চালু হতে আনুমানিক ২০-৩০ মিনিট সময় লাগতে পারে।
  2. API হাবে API মেটাডেটা দেখা যাচ্ছে না:
    • কানেক্টর লগ: API মেটাডেটা Pub/Sub টপিক অ্যাক্সেস করতে এবং ম্যানেজমেন্ট সার্ভার কল করতে পারে কিনা তা দেখতে opdk-connector লগ পর্যালোচনা করুন।
    • আপলোড স্ট্যাটাস: curl localhost:8080/v1/uapim/status আউটপুট চেক করুন। APIMetadata বিভাগটি খুঁজে দেখুন।
      • lastUpdated কি সাম্প্রতিক?
      • errorCount কি ক্রমাগত বাড়ছে?
      • এটি কোন পর্যায়ে আছে?
    • ব্যতিক্রম/সমস্যা: মেটাডেটা প্রসেসিং সংক্রান্ত কোনও ব্যতিক্রম বা সমস্যা হলে তা লগ থেকে খুঁজে দেখুন।
  3. API হাবে রানটাইম ডেটা দেখা যাচ্ছে না:
    • কানেক্টর লগ: opdk-কানেক্টর রানটাইম Pub/Sub টপিক অ্যাক্সেস করতে এবং ম্যানেজমেন্ট সার্ভার কল করতে পারে কিনা তা চেক করুন।
    • আপলোড স্ট্যাটাস: curl localhost:8080/v1/uapim/status কমান্ড ব্যবহার করুন। RuntimeData বিভাগে ফোকাস করুন।
      • lastUpdated কি সাম্প্রতিক?
      • errorCount কি ক্রমাগত বাড়ছে?
    • ব্যতিক্রম/সমস্যা: রানটাইম ডেটা প্রসেসিং সম্পর্কিত লগে কোনও ব্যতিক্রম বা সমস্যা আছে কিনা দেখুন।
    • মেসেজ প্রসেসর কনফিগারেশন: নিশ্চিত করুন যে ডুয়াল-রাইটের জন্য সব MP-তে message-processor-communication.properties সঠিকভাবে কনফিগার করা হয়েছে এবং MP রিস্টার্ট করা হয়েছে।
    • NFS মাউন্ট: NFS মাউন্ট সঠিকভাবে কনফিগার করা হয়েছে কিনা এবং MP ও UAPIM কানেক্টর, দু'টিই এটি অ্যাক্সেস করতে পারছে কিনা তা যাচাই করুন।
  4. প্রক্সি ডেপ্লয় করা হয়েছে, কিন্তু API হাবে তথ্য সঠিক নয়:
    • অপেক্ষার সময়: ডেটা প্রোপাগেট করার জন্য কয়েক মিনিট সময় দিন।
    • লগ: আপলোড করা প্রক্সি সম্পর্কে তথ্য পেতে opdk-connector লগ চেক করুন। কানেক্টর ডিপ্লয়মেন্ট ইভেন্ট প্রসেস করছে কিনা তা শনাক্ত করতে এটি সাহায্য করতে পারে।