本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
故障排除
以下主题可以帮助您解决在使用 HealthOmics 工作流程和数据存储时遇到的问题。
排查工作流
如何对失败的运行进行故障排除？
使用 GetRunAPI 操作检索失败原因。有关更多信息，请参阅 运行失败原因。
如何对失败的任务进行故障排除？
查看任务失败消息中的错误代码以了解失败原因。查看任务登录 CloudWatch 以查看该任务的详细日志消息。如果您没有收到详细的日志消息，则可以修改工作流程以输出其他日志语句。有关更多信息，请参阅 HealthOmics 使用 CloudWatch 日志进行监控。
在哪里可以找到成功完成运行的引擎日志？
HealthOmics 仅向发布失败运行 CloudWatch 的日志。如果运行成功完成，则会将引擎日志 HealthOmics 传送到您的 Amazon S3 存储桶。有关更多信息，请参阅 登录亚马逊 S3。
如何减小工作流程的输入参数大小？
您最多可以为工作流程指定 50 KB 的输入参数。您可以使用目录导入或样本表来保持在此大小限制范围内。有关更多信息，请参阅 管理运行参数大小。
为什么我的跑步没有完成？
如果您的代码存在问题并且进程未正确退出，则您的运行可能会变得无响应或 “卡住”。有关如何防止和 catch 无响应运行的更多信息，请参阅无响应跑步指南。
解决呼叫缓存问题
以下主题可以帮助您解决在呼叫缓存中遇到的问题。
为什么我的跑步没有保存到缓存中？
-
通过检查 GetRun API 操作响应中的 cacheId 字段，验证运行是否配置为使用缓存。使用 CLI 运行以下命令：
aws omics get-run —id <run_id>。 -
如果运行成功，请验证 GetRun 响应中返回的缓存行为是否为 CACHE_ALWAYS。如果将缓存行为设置为 CACHE_ON_FAILURE，则只有在运行失败时才会保存到缓存中。
为什么任务不使用缓存条目？
<cache_id><cache_uuid>在/aws/omics/WorkflowLog CloudWatch 日志组中，打开运行缓存的日志流：r unCache//。
-
验证之前的运行是否为预期要缓存的任务创建了缓存条目。已保存到缓存中的运行将记录在 CACHE_ENTRY_CREATED 的日志消息中。
-
找到任务的 CACHE_MISS 日志，然后运行已完成的任务。如果没有日志条目，请检查运行是否已配置为使用缓存。
-
如果创建了缓存条目，请验证这两个任务的 CPUs、内存 GPUs 和容器摘要是否相同。创建缓存条目的任务的任务 ARN 在日志消息中。
-
如果两个任务的计算要求匹配，请验证两个任务之间的输入是否没有变化。为此，请打开引擎日志。如果运行的状态为 “失败”，则日志将位于 Cloudwatch 日志组/ aws/omics/WorkflowLog 中。否则，可以在运行的输出目录中找到引擎日志。
对数据存储进行故障排除
为什么 S3 在我的读取集上 GetObject 失败？
最常见的是，失败是由于缺少权限造成的。序列存储 S3 读取权限是一种双向配置，要求序列存储 S3 访问策略允许访问，并要求 IAM 委托人附加允许访问的策略。有关政策要求的更多详细信息，请参阅使用 Amazon S3 访问数据的权限 URIs。检查以下配置是否已准备就绪：
-
序列存储 S3 访问策略已明确允许访问 IAM 委托人或委托人账户的根目录。
-
检查 IAM 委托人是否有明确为正在访问的资源提供权限的策略。请注意，在定义权限时，IAM 委托人策略必须使用接入点 ARN，而不是基于接入点别名的路径，并且 ARN 处于条件中，不用于指定资源。
-
如果您的商店使用客户托管密钥 (CMK-KMS)，请确保 IAM 委托人对该密钥具有 kms:解密权限。有关配置跨账户使用情况的信息，请参阅 KMS 跨账户访问指南。
如果您的策略使用基于标签的访问控制，请确保以下几点：
-
确保序列存储已完成对标签的同步。为此，商店的状态必须是active，而不是updating。
-
确保读取集和策略上的标签键或键值中没有拼写错误。
为什么我在 Athena 中看不到我的注释库或变体存储库？
在 Lake Formation 中，请务必根据与你共享的商店创建资源链接。创建您有权访问的资源链接后，该商店应在 Athena 中可见。有关更多信息，请参阅 配置 Lake Formation 以供使用 HealthOmics。
为什么我无法访问我在 Athena 中的数据存储？
如果您的注释或变体存储可见，但您收到一条错误消息，提示访问被拒绝，请检查您使用的查询引擎版本。仅支持使用引擎版本 3 运行的查询。要了解有关 Athena 查询引擎版本的更多信息，请参阅亚马逊 A thena 文档。
