您可以随时查询 Apigee API Hub for Private Cloud 连接器的本地状态端点，以检查元数据和运行时数据上传的状态。
检查上传状态
在运行 Apigee API Hub for Private Cloud 连接器的虚拟机上使用以下 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 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日志，了解有关已上传代理的信息。这有助于确定连接器是否正在处理部署事件。