如需排查 Apigee Hybrid 中的 UDCA 问题，请查看日志文件。UDCA 日志会写入 stdout/stderr，您可以使用 kubectl logs 命令查看。
在 Kubernetes 管理机器上执行以下命令：
kubectl logs pod_name apigee-udca -n namespace
下表列出了 UDCA 日志文件中可能出现的常见错误消息及其含义。日志消息将包含时间戳，通常还包含堆栈跟踪或其他信息，可帮助您诊断和解决问题。
| 条目类型 | 日志消息 | 含义 |
|---|---|---|
| 错误 | Failed to create directory for dataset
dataset_name |
为给定数据集配置的目录不存在，并且 UDCA 无法创建该目录。这可能是设置中的权限问题。
此问题会阻止 UDCA 启动。 |
| 错误 | Shutdown action was interrupted. It is possible that some
data will be lost |
在关停过程中，UDCA 会尝试上传磁盘上的所有文件。 此消息表明关停使用的时间超过了预期，部分数据可能无法上传，从而导致丢失。 |
| 错误 | Scheduled DatasetHandler for dataset
dataset_name encountered an exception. |
在轮询已配置的目录或上传文件时，尝试对给定数据集执行操作出现意外异常。 |
| 错误 | Upload failed for file filename. Max Retries
exceeded! Moving dir to failed folder. |
UDCA 无法上传给定文件并将该文件移至数据集的 /failed 子目录。 |
| 错误 | Re-queuing files from failed directory encountered an exception. |
在成功上传后，UDCA 会将 /failed 目录中的文件重新排队。这可确保网络/上游问题得到解决后，UDCA 重新尝试上传文件。该消息表明 UDCA 在尝试将文件重新排队时遇到错误。 |
| 错误 | Shutting down datasetHandler encountered an exception. |
UDCA 尝试关闭时出现异常。 |
| 错误 | Failed to move file from directory_name to
directory_name. |
在子目录之间移动文件以进行内部生命周期管理时，UDCA 出现异常。 |
| 错误 | Failed to delete file filename. |
在成功上传后，UDCA 删除文件时发生异常。 |
| 错误 | Failed to rename file from file_name to file_name. |
在将 UUID 附加到正在重命名的文件时，UDCA 发生异常。 |
| 警告 | Received 429 - Too many Requests from upstream service.
Skipping remaining files in this iteration and will retry
again |
UDCA 收到上游服务导致其超出配额的错误。因此，UDCA 跳过了此迭代中的剩余文件，并将在下一个时间间隔重试。 |
| 警告 | File upload failed for filename.
error_message |
由于返回的错误，UDCA 无法上传给定的文件。 在将文件移动到数据集的 |
| 警告 | Request request_URI timed out. Aborting request |
用于上传文件的指定异步请求超时并取消。 |
| 警告 | Request request_URI failed. Exception
exception |
指定的异步请求失败，并引发异常。 |
| 警告 | Metrics Computation Failed:
error_message |
对 UDCA 文件系统指标的定期计算出现异常。 |
| 警告 | Will attempt to upload api file file_name uncompressed |
在上传之前，UDCA 尝试压缩文件时出现问题。在这种情况下，系统将上传未压缩的文件。 |