You can check the status of metadata and runtime data uploads at any time by querying the Apigee API Hub for Private Cloud connector's local status endpoint.
Checking upload status
Use the following curl command on the virtual machine running the Apigee API Hub for Private Cloud connector:
curl localhost:8080/v1/uapim/status
{ "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" } ] }
The output provides insights into:
- API metadata: Status of API metadata uploads, including organization, environment, current stage (for example, "Bulk Transfer", "Streaming", "Yet to start"), total/completed/pending uploads, error count, and last update time.
- Runtime metadata: Status of runtime data uploads, showing organization, environment, error count, and last update time.
Common issues and troubleshooting steps
If you encounter issues, consult the connector's logs and the status endpoint. The main log file for the Apigee hub connector is located at /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
- Apigee API Hub for Private Cloud connector does not start up:
- Check logs: Examine
/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
for error messages related to configuration. - Verify settings: Double-check all configured settings in
uapim-connector.properties
and environment variables. - Pub/sub access: Verify in the logs if the
opdk-connector
is able to access the provided Pub/Sub topics. - Management server access: Check logs if
opdk-connector
can successfully call the Apigee management server with the given URL and credentials. - Startup time: If there are thousands of deployments in your Apigee environment, the Apigee hub connector can take approximately 20-30 minutes to start up.
- Check logs: Examine
- API metadata does not show up in API hub:
- Connector logs: Review the
opdk-connector
logs to see if it can access the API metadata Pub/Sub topic and call the management server. - Upload status: Check the
curl localhost:8080/v1/uapim/status
output. Look for theAPIMetadata
section.- Is lastUpdated recent?
- Is errorCount consistently increasing?
- What stage is it in?
- Exceptions/errors: Search the logs for any exceptions or errors thrown related to metadata processing.
- Connector logs: Review the
- Runtime data does not show up in API hub:
- Connector logs: Check if the opdk-connector can access the runtime Pub/Sub topic and call the management server.
- Upload status: Use the
curl localhost:8080/v1/uapim/status
command. Focus on theRuntimeData
section.- Is lastUpdated recent?
- Is errorCount consistently increasing?
- Exceptions/errors: Look for any exceptions or errors in the logs related to runtime data processing.
- Message processor configuration: Ensure that
message-processor-communication.properties
is correctly configured on all MPs for dual-write, and that MPs have been restarted. - NFS mount: Verify the NFS mount is correctly configured and accessible by both MPs and the UAPIM connector.
- Proxy deployed, but information in API hub is not accurate:
- Wait time: Allow a few minutes for the data to propagate.
- Logs: Check the
opdk-connector
logs for information about uploaded proxies. This can help identify if the connector is processing the deployment events.