To troubleshoot the UDCA in Apigee hybrid, look at the log files. UDCA logs are written to stdout/stderr and can be viewed using the kubectl logs command.
On the Kubernetes administration machine, execute the following command:
kubectl logs pod_name apigee-udca -n namespace
The following table lists common error messages that might appear in the UDCA log files and their meanings. Log messages will include a timestamp and often a stacktrace or other information to help you diagnose and fix the issue.
| Entry Type | Log message | Meaning |
|---|---|---|
| Error | Failed to create directory for dataset dataset_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 dataset dataset_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 file filename. 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 from directory_name to directory_name. | The UDCA encountered an exception while moving a file between sub-directories for internal lifecycle management. |
| Error | Failed to delete file filename. | The UDCA encountered an exception while deleting a file after a successful upload. |
| Error | Failed to rename file from file_name to file_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. Exception exception | 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 file file_name uncompressed | The UDCA encountered an issue trying to compress the file before uploading. The uncompressed file will be uploaded in this case. |