> [!CAUTION]
> You are currently viewing version 1.7 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions).

<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">Version 1.7 (unsupported)</button>

- Supported versions:
- [v1.17 (latest)](https://docs.cloud.google.com/apigee/docs/hybrid/v1.17/udca-logs.html)
- [v1.16](https://docs.cloud.google.com/apigee/docs/hybrid/v1.16/udca-logs.html)
- [v1.15](https://docs.cloud.google.com/apigee/docs/hybrid/v1.15/udca-logs.md.txt)
- [v1.14](https://docs.cloud.google.com/apigee/docs/hybrid/v1.14/udca-logs.md.txt)
- [List of supported versions](https://docs.cloud.google.com/apigee/docs/hybrid/supported-platforms.md.txt#supported-versions)
- Unsupported versions:
- [v1.13](https://docs.cloud.google.com/apigee/docs/hybrid/v1.13/udca-logs.md.txt)
- [v1.12](https://docs.cloud.google.com/apigee/docs/hybrid/v1.12/udca-logs.md.txt)
- [v1.11](https://docs.cloud.google.com/apigee/docs/hybrid/v1.11/udca-logs.md.txt)
- [v1.10](https://docs.cloud.google.com/apigee/docs/hybrid/v1.10/udca-logs.md.txt)
- [v1.9](https://docs.cloud.google.com/apigee/docs/hybrid/v1.9/udca-logs.md.txt)
- [v1.8](https://docs.cloud.google.com/apigee/docs/hybrid/v1.8/udca-logs.md.txt)
- [v1.7](https://docs.cloud.google.com/apigee/docs/hybrid/v1.7/udca-logs.md.txt)
- [v1.6](https://docs.cloud.google.com/apigee/docs/hybrid/v1.6/udca-logs.md.txt)
- [v1.5](https://docs.cloud.google.com/apigee/docs/hybrid/v1.5/udca-logs.md.txt)
- [v1.4](https://docs.cloud.google.com/apigee/docs/hybrid/v1.4/udca-logs.md.txt)
- [v1.3](https://docs.cloud.google.com/apigee/docs/hybrid/v1.3/udca-logs.md.txt)
- [v1.2](https://docs.cloud.google.com/apigee/docs/hybrid/v1.2/udca-logs.md.txt)
- [v1.1](https://docs.cloud.google.com/apigee/docs/hybrid/v1.1/udca-logs.md.txt)

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`](https://kubernetes.io/docs/reference/kubectl/overview/) `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 `/failed` subdirectory. |
| 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. |