ইন্টিগ্রেশনের সমস্যা সমাধান করুন

API হাব সংযোগকারী একীকরণের জন্য এখানে কিছু সাধারণ সমস্যা এবং তাদের সমস্যা সমাধানের পদক্ষেপ রয়েছে।

API মেটাডেটা API হাবে প্রদর্শিত হয় না

• প্রাথমিক সিঙ্ক সময়: প্রাথমিক সিঙ্ক্রোনাইজেশন শুরু হতে এবং API হাবে API ডেটা প্রদর্শিত হতে কয়েক ঘন্টা সময় লাগতে পারে। কয়েক ঘন্টা অপেক্ষা করার পরামর্শ দেওয়া হয়।
• প্লাগইন ইনস্ট্যান্স স্ট্যাটাস: যাচাই করুন যে API হাবের প্লাগইন ইনস্ট্যান্স মুছে ফেলা বা পরিবর্তন করা হয়নি।
• গেটওয়ে আইডি: প্রাইভেট ক্লাউড API হাব সংযোগকারী সেটিংসের জন্য আপনার Apigee এজ-এ সঠিক গেটওয়ে আইডি সঠিকভাবে কনফিগার করা হয়েছে তা নিশ্চিত করুন।
• লগ চেক করুন: প্রাইভেট ক্লাউড এপিআই হাব সংযোগকারী পরিষেবা লগ /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log এর জন্য এজ লগ ইন করা কোনো ত্রুটি আছে কিনা তা পরীক্ষা করুন।

প্রক্সি স্থাপন করা হয়েছে কিন্তু API হাবের তথ্য সঠিক নয়

• প্রচার বিলম্ব: প্রচারিত প্রক্সি তথ্যের জন্য কয়েক মিনিটের অনুমতি দিন এবং API হাবে প্রতিফলিত হবে।
• লগ চেক করুন: আপলোড করা প্রক্সিগুলির বিশদ বিবরণের জন্য ব্যক্তিগত ক্লাউড এপিআই হাব সংযোগকারী লগগুলির জন্য এজ পর্যালোচনা করুন৷ সিঙ্ক্রোনাইজেশনের জন্য প্রক্সি আপডেট সফলভাবে প্রক্রিয়া করা হয়েছে কিনা তা সনাক্ত করতে এটি সাহায্য করতে পারে।

ব্যবহারকারী সংস্থা API হাব সংযোগকারীতে কিছু পরিবর্তন না করেই সিঙ্ক করা বন্ধ করেছে৷

• প্লাগইন ইনস্ট্যান্স স্ট্যাটাস (API হাব সাইড): এপিআই হাবের সংশ্লিষ্ট প্লাগইন ইন্সট্যান্স ডিপ্রভিশন, মুছে বা পরিবর্তন করা হয়েছে কিনা তা যাচাই করুন। এপিআই হাব সাইডে যেকোনো পরিবর্তন সরাসরি এপিআই হাব সংযোগকারী থেকে সিঙ্ক্রোনাইজেশনকে প্রভাবিত করতে পারে।
• লগ চেক করুন: যেকোন ত্রুটি, সতর্কতা বা সমস্যাগুলির জন্য ব্যক্তিগত ক্লাউড এপিআই হাব সংযোগকারী লগগুলির জন্য এজ পর্যালোচনা করুন যা সিঙ্ক্রোনাইজেশন প্রক্রিয়াতে কোনও ব্যাঘাত নির্দেশ করতে পারে৷ এটি API হাবের সাথে সংযোগ সমস্যা বা প্রমাণীকরণ সমস্যা অন্তর্ভুক্ত করতে পারে।

স্থিতি API ব্যবহার করে (অপটেড-ইন সংস্থাগুলির জন্য প্রস্তাবিত):

স্থিতি API কোন সংস্থাগুলি বেছে নিয়েছে এবং সক্রিয়ভাবে সিঙ্ক্রোনাইজ করছে তা দেখার একটি সরাসরি উপায় প্রদান করে৷

লগ ভিত্তিক সমস্যা সমাধান

API হাব সংযোগকারী লগগুলি কোথায় সংরক্ষণ করা হয়?

/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

সক্রিয় করা প্রতিষ্ঠান সম্পর্কে আমি কিভাবে তথ্য পেতে পারি?

বর্তমানে কোন সংস্থাগুলি (orgs) সক্ষম করা হয়েছে এবং সিঙ্ক্রোনাইজ করা হচ্ছে তা নির্ধারণ করতে, আপনি স্থিতি API-এর সুবিধা নিতে পারেন এবং সিস্টেম লগগুলি পরীক্ষা করতে পারেন।

• অ্যাকশন: স্থিতি API এন্ডপয়েন্টে কল করুন।
• প্রত্যাশিত আউটপুট: অপ্ট-ইন করা প্রতিষ্ঠানগুলিকে API প্রতিক্রিয়ার মধ্যে apiSyncStatus এবং analyticsSyncStatus বিভাগের অধীনে তালিকাভুক্ত করা হবে। মেটাডেটা সিঙ্ক সক্ষম করা সংস্থাগুলি apiSyncStatus অধীনে প্রদর্শিত হবে এবং রানটাইম সিঙ্ক সক্ষম করা সংস্থাগুলি analyticsSyncStatus অধীনে প্রদর্শিত হবে৷

  {
   "apiSyncStatus": [
     {
       "organization": "foo",
       "phase": "Preparing", // ColdTransfer => Preparing
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 100, // total proxies known to uapim connector
             "pendingItems": 90,  // pending proxies to upload
             "completedItems": 6, // completed proxies to upload
             "failedItems": 4 // proxies failed to upload
           }
         },
         "environment": { //environment upload status
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 1, // pending environments to process
             "completedItems": 3, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "bar",
       "phase": "Processing", // "Streaming" -> "Processing"
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 110, // total proxies known to uapim connector
             "pendingItems": 16, // pending proxies to upload
             "completedItems": 3, // completed proxies to upload
             "failedItems": 1 // proxies failed to upload
           }
         },
         "environment": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 3, // pending environments to process
             "completedItems": 1, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "test",
       "phase": "Queued", // "Yet to start" -> "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"
     }
   ]
  }
  

• সিস্টেম লগগুলি পরিদর্শন করা: আরও দানাদার দৃশ্যের জন্য এবং পৃথক সংস্থাগুলির জন্য সিঙ্ক্রোনাইজেশন সেটআপ নিশ্চিত করতে, আপনি নির্দিষ্ট এন্ট্রিগুলির জন্য সিস্টেম লগগুলি পরীক্ষা করতে পারেন।
  • লগ চেক করুন:

    /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • অনুসন্ধান কমান্ড: নিম্নলিখিত লগ লাইনগুলি খুঁজে পেতে grep বা অনুরূপ লগ অনুসন্ধান সরঞ্জামগুলি ব্যবহার করুন:
    • org metadata-org-এর মেটাডেটা সিঙ্ক্রোনাইজেশনের জন্য:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • উদাহরণ লগ স্নিপেট:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • প্রতিষ্ঠানের জন্য মেটাডেটা সিঙ্ক সেটআপ করুন: প্রতিষ্ঠানের নাম অনুসরণ করুন।
    • org রানটাইম-অর্গ-এর রানটাইম ডেটা সিঙ্ক্রোনাইজেশনের জন্য:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • উদাহরণ লগ স্নিপেট:

      2025-07-10 08:47:09,902  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupRuntimeSyncData() : Setup runtime data sync for organization: runtime-org

    • প্রতিষ্ঠানের জন্য টেক্সট সেটআপ রানটাইম ডেটা সিঙ্ক দেখুন: প্রতিষ্ঠানের নাম অনুসরণ করুন।

লগ থেকে সক্ষম হতে ব্যর্থ হওয়া সমস্ত (org,env) তথ্য আমি কিভাবে পেতে পারি?

সক্রিয় হতে ব্যর্থ হওয়া সংস্থাগুলির সম্পর্কে তথ্য পেতে, আপনি নির্দিষ্ট ত্রুটি এন্ট্রিগুলির জন্য সিস্টেম লগগুলি পরীক্ষা করতে পারেন।

• লগ চেক করুন: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• অনুসন্ধান কমান্ড: মেটাডেটা সিঙ্ক স্থিতি আপডেটের সময় একটি ত্রুটি নির্দেশ করে লগ লাইনগুলি খুঁজে পেতে grep বা অনুরূপ লগ অনুসন্ধান সরঞ্জামগুলি ব্যবহার করুন৷
  • org/env ব্যর্থ-org/failed-env-এর জন্য ব্যর্থ মেটাডেটা সিঙ্ক্রোনাইজেশন স্থিতি আপডেটের জন্য:

    grep "Error while updating metadata sync status for org: failed-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • উদাহরণ লগ স্নিপেট:

    2025-07-15 10:30:15,123 main ERROR c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateMetadataSyncStatus() : Error while updating metadata sync status for org: failed-org

  • Error while updating metadata sync status for org/env: তারপরে প্রতিষ্ঠান এবং পরিবেশ (উদাহরণস্বরূপ, ব্যর্থ-অর্গ/বিফল-এনভি)।

আমি কিভাবে লগ থেকে org এর স্থানান্তর অবস্থা পরিবর্তনের একটি সারাংশ পেতে পারি?

কখন একটি (org, env) সিঙ্ক্রোনাইজেশন ট্রান্সফার স্টেট আপডেট করা হয় তার একটি সারাংশ পেতে, আপনি নির্দিষ্ট এন্ট্রিগুলির জন্য সিস্টেম লগগুলি পরীক্ষা করতে পারেন।

• লগ চেক করুন: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• অনুসন্ধান কমান্ডগুলি একটি প্রতিষ্ঠান এবং পরিবেশের জন্য স্থানান্তর অবস্থার একটি আপডেট নির্দেশ করে লগ লাইনগুলি খুঁজতে grep বা অনুরূপ লগ অনুসন্ধান সরঞ্জাম ব্যবহার করুন।
  • স্থানান্তর অবস্থা আপডেটের জন্য:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • উদাহরণ লগ স্নিপেট:

    2025-07-15 18:35:01,789 main INFO c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateTransferStatus() : Transfer status is updated for org: org1 to BULK_TRANSFER
    2025-07-10 08:47:11,364  main INFO  c.a.u.m.UAPIMMetadataServiceImpl - UAPIMMetadataServiceImpl.updateEnvironmentStatus() : Transfer status is updated for org: org1 to STREAMING

  • নির্দিষ্ট সংস্থা এবং পরিবেশ (যেমন, org1/prod) এবং রাষ্ট্র দ্বারা অনুসরণ করে "অর্গ/এনভির জন্য স্থানান্তর স্থিতি আপডেট করা হয়েছে" সঠিক পাঠ্যটি সন্ধান করুন।