此页面由 Cloud Translation API 翻译。

查看上传状态和错误

您可以随时查询 Apigee API Hub for Private Cloud 连接器的本地状态端点，以检查元数据和运行时数据上传的状态。

检查上传状态

在运行 Apigee API Hub for Private Cloud 连接器的虚拟机上，使用以下 curl 命令：

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

适用于私有云的 Apigee API Hub 连接器未启动：
- 检查日志：检查 /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log 是否有与配置相关的错误消息。
- 验证设置：仔细检查 uapim-connector.properties 中的所有已配置设置和环境变量。
- 发布/订阅访问权限：在日志中验证 opdk-connector 是否能够访问所提供的 Pub/Sub 主题。
- 管理服务器访问权限：检查日志，了解 opdk-connector 是否能够使用给定的网址和凭据成功调用 Apigee 管理服务器。
- 启动时间：如果您的 Apigee 环境中有数千个部署，Apigee Hub 连接器可能需要大约 20-30 分钟才能启动。
API 元数据未显示在 API Hub 中：
- 连接器日志：查看 opdk-connector 日志，了解连接器是否可以访问 API 元数据 Pub/Sub 主题并调用管理服务器。
- 上传状态：检查 curl localhost:8080/v1/uapim/status 输出。查找 APIMetadata 部分。
  - lastUpdated 是否为近期？
  - errorCount 是否持续增加？
  - 它处于哪个阶段？
- 异常/错误：在日志中搜索与元数据处理相关的任何抛出的异常或错误。
运行时数据未显示在 API Hub 中：
- 连接器日志：检查 opdk-connector 是否可以访问运行时 Pub/Sub 主题并调用管理服务器。
- 上传状态：使用 curl localhost:8080/v1/uapim/status 命令。重点关注 RuntimeData 部分。
  - lastUpdated 是否为近期？
  - errorCount 是否持续增加？
- 异常/错误：在日志中查找与运行时数据处理相关的任何异常或错误。
- 消息处理器配置：确保在所有 MP 上正确配置了 message-processor-communication.properties 以进行双重写入，并且 MP 已重新启动。
- NFS 装载：验证 NFS 装载是否已正确配置，并且 MP 和 UAPIM 连接器均可访问。
代理已部署，但 API Hub 中的信息不准确：
- 等待时间：请等待几分钟，让数据传播完毕。
- 日志：检查 opdk-connector 日志，了解有关已上传代理的信息。这有助于确定连接器是否正在处理部署事件。