UDCA logs
To troubleshoot the UDCA in Apigee hybrid, look at the log files. UDCA logs arewritten tostdout/stderr and can be viewed using thekubectllogs command.
On the Kubernetes administration machine, execute the following command:
kubectl logspod_name apigee-udca -nnamespace
The following table lists common error messages that mightappear in the UDCA log files and their meanings. Log messages willinclude a timestamp and often a stacktrace or other information tohelp you diagnose and fix the issue.
| Entry Type | Log message | Meaning |
|---|---|---|
| Error | Failed to create directory for datasetdataset_name | The directory configured for the given dataset did not exist and the UDCA failed to create it. It could be a permission issue in the setup. This issue prevents UDCA from starting. |
| Error | Shutdown action was interrupted. It is possible that some data will be lost | As part of a shutdown, UDCA tries to upload all files on disk. This message indicates that the shutdown took longer than expected and some data might not be uploaded and hence lost. |
| Error | Scheduled DatasetHandler for datasetdataset_name encountered an exception. | An attempt to perform an action on the given dataset encountered an unexpected exception while polling the configured directory or while uploading the files. |
| Error | Upload failed for filefilename. Max Retries exceeded! Moving dir to failed folder. | The UDCA failed to upload the given file and moved the file to the dataset's/failed subdirectory. |
| Error | Re-queuing files from failed directory encountered an exception. | The UDCA requeues files from the/failed directory after a successful upload. This ensures that the UDCA retry to upload files after network/upstream issues are resolved.This message indicates that UDCA experienced an error when trying to requeue the file. |
| Error | Shutting down datasetHandler encountered an exception. | The UDCA experienced an exception when trying to shut down. |
| Error | Failed to move file fromdirectory_name todirectory_name. | The UDCA encountered an exception while moving a file between sub-directories for internal lifecycle management. |
| Error | Failed to delete filefilename. | The UDCA encountered an exception while deleting a file after a successful upload. |
| Error | Failed to rename file fromfile_name tofile_name. | The UDCA encountered an exception while appending UUID to a file while renaming. |
| Warning | Received 429 - Too many Requests from upstream service. Skipping remaining files in this iteration and will retry again | The UDCA received an error that it had exceeded its quota from an upstream service. As a result, the UDCA skipped the remaining files in this iteration and will retry in the next interval. |
| Warning | File upload failed for filename.error_message | The UDCA failed to upload the given file due to the returned error. The UDCA will attempt to upload the file 3 times before moving it to the dataset's |
| Warning | Request request_URI timed out. Aborting request | The specified asynchronous request to upload the file timed out and was cancelled. |
| Warning | Request request_URI failed. Exceptionexception | The specified asynchronous request failed with an exception. |
| Warning | Metrics Computation Failed:error_message | The periodic computation of the UDCA's file system metrics encountered an exception. |
| Warning | Will attempt to upload api filefile_name uncompressed | The UDCA encountered an issue trying to compress the file before uploading. The uncompressed file will be uploaded in this case. |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.