अपलोड का स्टेटस और गड़बड़ियां देखना

Apigee API Hub for Private Cloud कनेक्टर के लोकल स्टेटस एंडपॉइंट से क्वेरी करके, मेटाडेटा और रनटाइम डेटा अपलोड करने की स्थिति कभी भी देखी जा सकती है.

अपलोड की स्थिति देखना

Apigee API Hub for Private Cloud कनेक्टर चलाने वाली वर्चुअल मशीन पर, यहां दिए गए curl निर्देश का इस्तेमाल करें:

curl localhost:8080/v1/uapim/status
सफल रिस्पॉन्स में, इस तरह का JSON ऑब्जेक्ट दिखता है:
    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

आउटपुट से इनके बारे में अहम जानकारी मिलती है:

  • एपीआई मेटाडेटा: एपीआई मेटाडेटा अपलोड करने की स्थिति. इसमें संगठन, एनवायरमेंट, मौजूदा चरण (उदाहरण के लिए, "बल्क ट्रांसफ़र", "स्ट्रीमिंग", "अभी शुरू नहीं हुआ"), कुल/पूरे/लंबित अपलोड, गड़बड़ियों की संख्या, और अपडेट करने का आखिरी समय शामिल है.
  • रनटाइम मेटाडेटा: रनटाइम डेटा अपलोड करने की स्थिति. इसमें संगठन, एनवायरमेंट, गड़बड़ियों की संख्या, और आखिरी अपडेट का समय दिखता है.

सामान्य समस्याएं और उन्हें हल करने का तरीका

अगर आपको समस्याएं आती हैं, तो कनेक्टर के लॉग और स्टेटस एंडपॉइंट देखें. Apigee हब कनेक्टर की मुख्य लॉग फ़ाइल, /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log पर मौजूद होती है

  1. Apigee API Hub for Private Cloud कनेक्टर शुरू नहीं होता है:
    • लॉग देखें: कॉन्फ़िगरेशन से जुड़ी गड़बड़ियों के मैसेज के लिए, /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log देखें.
    • सेटिंग की पुष्टि करें: uapim-connector.properties और एनवायरमेंट वैरिएबल में कॉन्फ़िगर की गई सभी सेटिंग की दोबारा जांच करें.
    • Pub/Sub का ऐक्सेस: लॉग में देखें कि opdk-connector, दिए गए Pub/Sub विषयों को ऐक्सेस कर पा रहा है या नहीं.
    • मैनेजमेंट सर्वर का ऐक्सेस: अगर opdk-connector दिए गए यूआरएल और क्रेडेंशियल के साथ Apigee मैनेजमेंट सर्वर को कॉल कर सकता है, तो लॉग देखें.
    • स्टार्टअप का समय: अगर आपके Apigee एनवायरमेंट में हज़ारों डिप्लॉयमेंट हैं, तो Apigee हब कनेक्टर को शुरू होने में करीब 20 से 30 मिनट लग सकते हैं.
  2. एपीआई हब में एपीआई मेटाडेटा नहीं दिखता:
    • कनेक्टर लॉग: opdk-connector लॉग की समीक्षा करें. इससे यह पता चलेगा कि कनेक्टर, एपीआई मेटाडेटा Pub/Sub विषय को ऐक्सेस कर सकता है या नहीं. साथ ही, यह भी पता चलेगा कि कनेक्टर, मैनेजमेंट सर्वर को कॉल कर सकता है या नहीं.
    • अपलोड की स्थिति: curl localhost:8080/v1/uapim/status आउटपुट देखें. APIMetadata सेक्शन देखें.
      • क्या lastUpdated हाल ही का है?
      • क्या errorCount लगातार बढ़ रहा है?
      • यह किस स्टेज पर है?
    • अपवाद/गड़बड़ियां: मेटाडेटा प्रोसेसिंग से जुड़े किसी भी अपवाद या गड़बड़ी के लिए लॉग खोजें.
  3. एपीआई हब में रनटाइम डेटा नहीं दिखता:
    • कनेक्टर लॉग: देखें कि क्या opdk-connector, रनटाइम Pub/Sub विषय को ऐक्सेस कर सकता है और मैनेजमेंट सर्वर को कॉल कर सकता है.
    • अपलोड का स्टेटस: curl localhost:8080/v1/uapim/status कमांड का इस्तेमाल करें. RuntimeData सेक्शन पर फ़ोकस करें.
      • क्या lastUpdated हाल ही का है?
      • क्या errorCount लगातार बढ़ रहा है?
    • अपवाद/गड़बड़ियां: रनटाइम डेटा प्रोसेसिंग से जुड़े लॉग में, किसी भी अपवाद या गड़बड़ी का पता लगाएं.
    • मैसेज प्रोसेसर का कॉन्फ़िगरेशन: पक्का करें कि ड्यूअल-राइट के लिए, सभी एमपी पर message-processor-communication.properties को सही तरीके से कॉन्फ़िगर किया गया हो. साथ ही, यह भी पक्का करें कि एमपी को रीस्टार्ट कर दिया गया हो.
    • एनएफ़एस माउंट: पुष्टि करें कि एनएफ़एस माउंट को सही तरीके से कॉन्फ़िगर किया गया हो और इसे एमपी और यूएपीआईएम कनेक्टर, दोनों ऐक्सेस कर सकते हों.
  4. प्रॉक्सी डिप्लॉय की गई है, लेकिन एपीआई हब में दी गई जानकारी सही नहीं है:
    • इंतज़ार का समय: डेटा को लागू होने में कुछ मिनट लग सकते हैं.
    • लॉग: अपलोड की गई प्रॉक्सी के बारे में जानकारी पाने के लिए, opdk-connector लॉग देखें. इससे यह पता लगाया जा सकता है कि कनेक्टर, डिप्लॉयमेंट इवेंट को प्रोसेस कर रहा है या नहीं.