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

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

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

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

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"
        }
      ]
    }

เอาต์พุตจะให้ข้อมูลเชิงลึกเกี่ยวกับสิ่งต่อไปนี้

  • ข้อมูลเมตาของ 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 เพื่อดูข้อมูลเกี่ยวกับพร็อกซีที่อัปโหลด ซึ่งจะช่วยระบุว่าตัวเชื่อมต่อกำลังประมวลผลเหตุการณ์การติดตั้งใช้งานหรือไม่