ตรวจสอบสถานะการอัปโหลดและข้อผิดพลาด

คุณตรวจสอบสถานะของการอัปโหลดข้อมูลเมตาและข้อมูลระยะเวลาการทำงานได้ทุกเมื่อโดยการค้นหา Apigee API Hub สำหรับปลายทางสถานะภายในของตัวเชื่อมต่อ Private Cloud

การตรวจสอบสถานะการอัปโหลด

ใช้คำสั่ง curl ต่อไปนี้ในเครื่องเสมือนที่เรียกใช้ตัวเชื่อมต่อ Apigee API Hub สำหรับ Private Cloud

curl localhost:8080/v1/uapim/status

  {
 "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 สำหรับ 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 ด้วย URL และข้อมูลเข้าสู่ระบบที่ระบุได้สำเร็จหรือไม่
   • เวลาเริ่มต้น: หากมีการติดตั้งใช้งานหลายพันรายการในสภาพแวดล้อม Apigee ตัวเชื่อมต่อฮับ Apigee อาจใช้เวลาประมาณ 20-30 นาทีในการเริ่มต้น
2. ข้อมูลเมตาของ API ไม่ปรากฏใน API Hub
   • บันทึกตัวเชื่อมต่อ: ตรวจสอบบันทึก opdk-connector เพื่อดูว่าตัวเชื่อมต่อเข้าถึงหัวข้อ Pub/Sub ของข้อมูลเมตา API และเรียกเซิร์ฟเวอร์การจัดการได้หรือไม่
   • สถานะการอัปโหลด: ตรวจสอบเอาต์พุต curl localhost:8080/v1/uapim/status มองหาส่วน APIMetadata
     • มีการอัปเดตล่าสุดเมื่อไม่นานมานี้ใช่ไหม
     • errorCount เพิ่มขึ้นอย่างต่อเนื่องไหม
     • อยู่ในขั้นตอนใด
   • ข้อยกเว้น/ข้อผิดพลาด: ค้นหาข้อยกเว้นหรือข้อผิดพลาดที่เกิดขึ้นในบันทึกที่เกี่ยวข้องกับการประมวลผลข้อมูลเมตา
3. ข้อมูลรันไทม์ไม่แสดงในฮับ API
   • บันทึกของเครื่องมือเชื่อมต่อ: ตรวจสอบว่า opdk-connector เข้าถึงหัวข้อ Pub/Sub ของรันไทม์และเรียกเซิร์ฟเวอร์การจัดการได้หรือไม่
   • สถานะการอัปโหลด: ใช้คำสั่ง curl localhost:8080/v1/uapim/status มุ่งเน้นที่ส่วนRuntimeData
     • มีการอัปเดตล่าสุดเมื่อไม่นานมานี้ใช่ไหม
     • errorCount เพิ่มขึ้นอย่างต่อเนื่องไหม
   • ข้อยกเว้น/ข้อผิดพลาด: มองหาข้อยกเว้นหรือข้อผิดพลาดในบันทึกที่เกี่ยวข้องกับการประมวลผลข้อมูลรันไทม์
   • การกำหนดค่าตัวประมวลผลข้อความ: ตรวจสอบว่าได้กำหนดค่า message-processor-communication.properties อย่างถูกต้องใน MP ทั้งหมดสำหรับการเขียนแบบคู่ และได้รีสตาร์ท MP แล้ว
   • การติดตั้ง NFS: ตรวจสอบว่าได้กำหนดค่าการติดตั้ง NFS อย่างถูกต้องและทั้ง MP และตัวเชื่อมต่อ UAPIM สามารถเข้าถึงได้
4. พร็อกซีได้รับการติดตั้งใช้งานแล้ว แต่ข้อมูลในฮับ API ไม่ถูกต้อง
   • เวลารอ: รอสักครู่เพื่อให้ข้อมูลมีผล
   • บันทึก: ตรวจสอบบันทึก opdk-connector เพื่อดูข้อมูลเกี่ยวกับพร็อกซีที่อัปโหลด ซึ่งจะช่วยระบุว่าตัวเชื่อมต่อกำลังประมวลผลเหตุการณ์การติดตั้งใช้งานหรือไม่