Kiểm tra trạng thái tải lên và lỗi

Bạn có thể kiểm tra trạng thái của quá trình tải siêu dữ liệu và dữ liệu thời gian chạy lên bất cứ lúc nào bằng cách truy vấn điểm cuối trạng thái cục bộ của trình kết nối Apigee API Hub cho Đám mây riêng.

Kiểm tra trạng thái tải lên

Sử dụng lệnh curl sau đây trên máy ảo đang chạy trình kết nối Apigee API Hub cho Đám mây riêng tư:

curl localhost:8080/v1/uapim/status

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

Kết quả cung cấp thông tin chi tiết về:

• Siêu dữ liệu API: Trạng thái của các lượt tải siêu dữ liệu API lên, bao gồm cả tổ chức, môi trường, giai đoạn hiện tại (ví dụ: "Chuyển hàng loạt", "Phát trực tuyến", "Chưa bắt đầu"), tổng số lượt tải lên/số lượt đã hoàn tất/số lượt đang chờ xử lý, số lỗi và thời gian cập nhật gần đây nhất.
• Siêu dữ liệu thời gian chạy: Trạng thái của quá trình tải dữ liệu thời gian chạy lên, cho biết tổ chức, môi trường, số lượng lỗi và thời gian cập nhật gần đây nhất.

Các vấn đề thường gặp và các bước khắc phục sự cố

Nếu bạn gặp vấn đề, hãy tham khảo nhật ký của trình kết nối và điểm cuối trạng thái. Tệp nhật ký chính cho trình kết nối trung tâm Apigee nằm tại /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

1. Trình kết nối Apigee API Hub cho Private Cloud không khởi động:
   • Kiểm tra nhật ký: Kiểm tra /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log để xem thông báo lỗi liên quan đến cấu hình.
   • Xác minh chế độ cài đặt: Kiểm tra kỹ tất cả chế độ cài đặt đã định cấu hình trong uapim-connector.properties và các biến môi trường.
   • Quyền truy cập Pub/Sub: Xác minh trong nhật ký xem opdk-connector có thể truy cập vào các chủ đề Pub/Sub được cung cấp hay không.
   • Quyền truy cập vào máy chủ quản lý: Kiểm tra nhật ký nếu opdk-connector có thể gọi thành công máy chủ quản lý Apigee bằng URL và thông tin đăng nhập đã cho.
   • Thời gian khởi động: Nếu có hàng nghìn lượt triển khai trong môi trường Apigee, thì trình kết nối trung tâm Apigee có thể mất khoảng 20 đến 30 phút để khởi động.
2. Siêu dữ liệu API không xuất hiện trong trung tâm API:
   • Nhật ký trình kết nối: Xem nhật ký opdk-connector để biết liệu trình kết nối có thể truy cập vào chủ đề Pub/Sub siêu dữ liệu API và gọi máy chủ quản lý hay không.
   • Trạng thái tải lên: Kiểm tra đầu ra curl localhost:8080/v1/uapim/status. Tìm phần APIMetadata.
     • lastUpdated có phải là gần đây không?
     • errorCount có liên tục tăng lên không?
     • Sản phẩm hoặc dịch vụ này đang ở giai đoạn phát triển nào?
   • Ngoại lệ/lỗi: Tìm trong nhật ký mọi ngoại lệ hoặc lỗi phát sinh liên quan đến quá trình xử lý siêu dữ liệu.
3. Dữ liệu thời gian chạy không xuất hiện trong trung tâm API:
   • Nhật ký trình kết nối: Kiểm tra xem opdk-connector có thể truy cập vào chủ đề Pub/Sub thời gian chạy và gọi máy chủ quản lý hay không.
   • Trạng thái tải lên: Sử dụng lệnh curl localhost:8080/v1/uapim/status. Tập trung vào phần RuntimeData.
     • lastUpdated có phải là gần đây không?
     • errorCount có liên tục tăng lên không?
   • Ngoại lệ/lỗi: Tìm mọi ngoại lệ hoặc lỗi trong nhật ký liên quan đến quá trình xử lý dữ liệu trong thời gian chạy.
   • Cấu hình trình xử lý thông báo: Đảm bảo rằng message-processor-communication.properties được định cấu hình chính xác trên tất cả các MP để ghi kép và các MP đã được khởi động lại.
   • NFS mount: Xác minh rằng cả MP và trình kết nối UAPIM đều có thể truy cập và được định cấu hình đúng cách.
4. Đã triển khai proxy, nhưng thông tin trong trung tâm API không chính xác:
   • Thời gian chờ: Chờ vài phút để dữ liệu được truyền đi.
   • Nhật ký: Kiểm tra nhật ký opdk-connector để biết thông tin về các proxy đã tải lên. Điều này có thể giúp xác định xem trình kết nối có đang xử lý các sự kiện triển khai hay không.