Проверьте статус загрузки и наличие ошибок

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

Проверка статуса загрузки

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

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 Hub находится по адресу /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log .

  1. Коннектор Apigee API Hub для частного облака не запускается :
    • Проверьте журналы : проверьте /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log на наличие сообщений об ошибках, связанных с конфигурацией.
    • Проверьте настройки : дважды проверьте все настроенные параметры в uapim-connector.properties и переменные среды.
    • Доступ к публикации/подписке : проверьте в журналах, может ли opdk-connector получить доступ к предоставленным темам публикации/подписки.
    • Доступ к серверу управления : проверьте журналы, может ли opdk-connector успешно вызвать сервер управления Apigee с указанным URL-адресом и учетными данными.
    • Время запуска : если в вашей среде Apigee имеются тысячи развертываний, запуск коннектора концентратора Apigee может занять около 20–30 минут.
  2. Метаданные API не отображаются в API Hub :
    • Журналы коннектора : просмотрите журналы opdk-connector , чтобы узнать, может ли он получить доступ к теме Pub/Sub метаданных API и вызвать сервер управления.
    • Статус загрузки : проверьте вывод curl localhost:8080/v1/uapim/status . Найдите раздел APIMetadata .
      • LastUpdated был сделан недавно?
      • Увеличивается ли errorCount постоянно?
      • На какой стадии находится процесс?
    • Исключения/ошибки : просмотрите журналы на предмет любых исключений или ошибок, связанных с обработкой метаданных.
  3. Данные времени выполнения не отображаются в API Hub :
    • Журналы коннектора : проверьте, может ли opdk-connector получить доступ к теме Pub/Sub времени выполнения и вызвать сервер управления.
    • Статус загрузки : используйте команду curl localhost:8080/v1/uapim/status . Обратите внимание на раздел RuntimeData .
      • LastUpdated был сделан недавно?
      • Увеличивается ли errorCount постоянно?
    • Исключения/ошибки : найдите в журналах любые исключения или ошибки, связанные с обработкой данных во время выполнения.
    • Конфигурация процессора сообщений : убедитесь, что message-processor-communication.properties правильно настроен на всех MP для двойной записи и что MP были перезапущены.
    • Монтирование NFS : убедитесь, что монтирование NFS правильно настроено и доступно как для MP, так и для коннектора UAPIM.
  4. Прокси развернут, но информация в API-хабе неточная :
    • Время ожидания : подождите несколько минут, пока данные распространятся.
    • Журналы : Проверьте журналы opdk-connector на наличие информации о загруженных прокси-серверах. Это поможет определить, обрабатывает ли коннектор события развертывания.