Как проверить статус загрузки и ошибки

Вы можете в любое время проверить статус загрузки метаданных и данных времени выполнения, запросив локальную конечную точку статуса коннектора Apigee API Hub для частного облака.

Как проверить статус загрузки

На виртуальной машине, на которой работает коннектор Apigee API Hub для частного облака, выполните следующую команду curl:

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 Hub может занять примерно 20–30 минут.
2. Метаданные API не отображаются в центре API:
   • Журналы коннектора. Проверьте журналы opdk-connector, чтобы узнать, может ли он получить доступ к теме издатель-подписчик с метаданными API и вызвать сервер управления.
   • Статус загрузки. Проверьте выходные данные curl localhost:8080/v1/uapim/status. Найдите раздел APIMetadata.
     • Является ли значение lastUpdated недавним?
     • Значение errorCount постоянно увеличивается?
     • На каком этапе находится проект?
   • Исключения и ошибки. Найдите в журналах исключения или ошибки, связанные с обработкой метаданных.
3. Данные времени выполнения не отображаются в центре API:
   • Журналы коннектора. Проверьте, может ли коннектор opdk-connector получить доступ к теме издатель-подписчик во время выполнения и вызвать сервер управления.
   • Статус загрузки. Используйте команду curl localhost:8080/v1/uapim/status. Перейдите к разделу RuntimeData.
     • Является ли значение lastUpdated недавним?
     • Значение errorCount постоянно увеличивается?
   • Исключения и ошибки. Проверьте, нет ли в журналах исключений или ошибок, связанных с обработкой данных во время выполнения.
   • Конфигурация обработчика сообщений. Убедитесь, что message-processor-communication.properties правильно настроен на всех обработчиках сообщений для двойной записи и что обработчики сообщений были перезапущены.
   • Монтирование NFS. Убедитесь, что монтирование NFS настроено правильно и доступно как для процессоров сообщений, так и для коннектора UAPIM.
4. Прокси-сервер развернут, но информация в центре API неточная:
   • Время ожидания. Подождите несколько минут, пока данные не будут распространены.
   • Журналы. Проверьте журналы opdk-connector, чтобы узнать информацию о загруженных прокси-серверах. Это поможет определить, обрабатывает ли коннектор события развертывания.