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
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|
||The directory configured for the given dataset did not exist
and the UDCA failed to create it. It could be a permission issue in
This issue prevents UDCA from starting.
||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.
||An attempt to perform an action on the given dataset encountered an unexpected exception while polling the configured directory or while uploading the files.|
||The UDCA failed to upload the given file and moved the file to the dataset's /failed subdirectory.|
||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.
||The UDCA experienced an exception when trying to shut down.|
||The UDCA encountered an exception while moving a file between sub-directories for internal lifecycle management.|
||The UDCA encountered an exception while deleting a file after a successful upload.|
||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.|
||The UDCA failed to upload the given file due to the returned
The UDCA will attempt to upload the file 3 times before moving it to the dataset's /failed subdirectory.
||The specified asynchronous request to upload the file timed out and was cancelled.|
||The specified asynchronous request to upload the file failed with an exception.|
||The periodic computation of the UDCA's file system metrics encountered an exception.|