Khắc phục sự cố tích hợp

Sau đây là một số vấn đề thường gặp và các bước khắc phục sự cố đối với việc tích hợp trình kết nối trung tâm API.

Siêu dữ liệu API không xuất hiện trong trung tâm API

• Thời gian đồng bộ hoá ban đầu: Có thể mất vài giờ để quá trình đồng bộ hoá ban đầu bắt đầu và dữ liệu API xuất hiện trong API Hub. Bạn nên đợi vài giờ.
• Trạng thái của thực thể Plugin: Xác minh rằng thực thể Plugin trong trung tâm API chưa bị xoá hoặc thay đổi.
• Mã nhận dạng cổng: Đảm bảo rằng bạn đã định cấu hình đúng Mã nhận dạng cổng trong phần cài đặt trình kết nối trung tâm API Apigee Edge cho Đám mây riêng.
• Kiểm tra nhật ký: Kiểm tra xem có lỗi nào được ghi lại trong nhật ký dịch vụ trình kết nối trung tâm API Edge cho Đám mây riêng /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log hay không.

Đã triển khai proxy nhưng thông tin trong trung tâm API không chính xác

• Độ trễ lan truyền: Chờ vài phút để thông tin về proxy đã triển khai lan truyền và xuất hiện trong trung tâm API.
• Kiểm tra nhật ký: Xem nhật ký của trình kết nối trung tâm API Edge cho Đám mây riêng tư để biết thông tin chi tiết về các proxy đã tải lên. Điều này có thể giúp xác định xem bản cập nhật proxy đã được xử lý thành công để đồng bộ hoá hay chưa.

Tổ chức người dùng ngừng đồng bộ hoá mà không thay đổi bất kỳ nội dung nào trong trình kết nối trung tâm API

• Trạng thái của thực thể trình bổ trợ (phía trung tâm API): Xác minh xem thực thể trình bổ trợ được liên kết trong trung tâm API đã bị huỷ cấp phép, xoá hoặc thay đổi hay chưa. Mọi thay đổi ở phía trung tâm API đều có thể ảnh hưởng trực tiếp đến quá trình đồng bộ hoá từ trình kết nối trung tâm API.
• Kiểm tra nhật ký: Xem xét nhật ký trình kết nối trung tâm API Edge cho Đám mây riêng để biết mọi lỗi, cảnh báo hoặc vấn đề có thể cho thấy quá trình đồng bộ hoá bị gián đoạn. Điều này có thể bao gồm các vấn đề về kết nối hoặc xác thực với trung tâm API.

Sử dụng API trạng thái (Khuyên dùng cho các tổ chức đã chọn sử dụng):

API trạng thái cung cấp một cách trực tiếp để xem những tổ chức đã chọn sử dụng và đang đồng bộ hoá.

Khắc phục sự cố dựa trên nhật ký

Nhật ký của trình kết nối trung tâm API được lưu trữ ở đâu?

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

Làm cách nào để biết thông tin về những tổ chức được bật?

Để xác định những tổ chức (org) hiện đang được bật và đồng bộ hoá, bạn có thể tận dụng API trạng thái và kiểm tra nhật ký hệ thống.

• Hành động: Gọi điểm cuối API trạng thái.
• Kết quả dự kiến: Các tổ chức đã chọn sử dụng sẽ được liệt kê trong các phần apiSyncStatus và analyticsSyncStatus trong phản hồi của API. Những tổ chức đã bật tính năng Đồng bộ hoá siêu dữ liệu sẽ xuất hiện trong phần apiSyncStatus, còn những tổ chức đã bật tính năng Đồng bộ hoá thời gian chạy sẽ xuất hiện trong phần 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"
     }
   ]
  }
  

• Kiểm tra nhật ký hệ thống: Để có chế độ xem chi tiết hơn và xác nhận việc thiết lập tính năng đồng bộ hoá cho từng tổ chức, bạn có thể kiểm tra nhật ký hệ thống để xem các mục nhập cụ thể.
  • Kiểm tra nhật ký:

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

  • Lệnh tìm kiếm: Sử dụng grep hoặc các công cụ tìm kiếm nhật ký tương tự để tìm các dòng nhật ký sau:
    • Để đồng bộ hoá siêu dữ liệu của org metadata-org:

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

    • Ví dụ về đoạn mã nhật ký:

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

    • Tìm văn bản Thiết lập tính năng đồng bộ hoá siêu dữ liệu cho tổ chức:, theo sau là tên tổ chức.
    • Để đồng bộ hoá dữ liệu thời gian chạy của org runtime-org:

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

    • Ví dụ về đoạn mã nhật ký:

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

    • Tìm văn bản Thiết lập tính năng đồng bộ hoá dữ liệu thời gian chạy cho tổ chức:, theo sau là tên tổ chức.

Làm cách nào để lấy thông tin về tất cả (org,env) không bật được từ nhật ký?

Để biết thông tin về những tổ chức không bật được tính năng này, bạn có thể xem xét nhật ký hệ thống để tìm các mục nhập lỗi cụ thể.

• Kiểm tra nhật ký: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Lệnh tìm kiếm: Sử dụng grep hoặc các công cụ tìm kiếm nhật ký tương tự để tìm các dòng nhật ký cho biết lỗi trong quá trình cập nhật trạng thái đồng bộ hoá siêu dữ liệu.
  • Đối với các bản cập nhật trạng thái đồng bộ hoá siêu dữ liệu không thành công cho org/env failed-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

  • Ví dụ về đoạn mã nhật ký:

    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

  • Tìm văn bản Error while updating metadata sync status for org/env:, theo sau là tổ chức và môi trường (ví dụ: failed-org/failed-env).

Làm cách nào để xem tóm tắt về thay đổi trạng thái chuyển tổ chức trong nhật ký?

Để xem thông tin tóm tắt về thời điểm trạng thái chuyển đồng bộ hoá (org, env) được cập nhật, bạn có thể kiểm tra nhật ký hệ thống để xem các mục nhập cụ thể.

• Kiểm tra nhật ký: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Lệnh tìm kiếm Sử dụng grep hoặc các công cụ tìm kiếm nhật ký tương tự để tìm các dòng nhật ký cho biết trạng thái chuyển của một tổ chức và môi trường đã được cập nhật.
  • Để biết thông tin cập nhật về trạng thái chuyển:

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

  • Ví dụ về đoạn mã nhật ký:

    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

  • Tìm chính xác văn bản "Trạng thái chuyển được cập nhật cho tổ chức/môi trường", theo sau là tổ chức và môi trường cụ thể (ví dụ: org1/prod) và trạng thái.