{"meta":{"title":"使用工作流运行日志","intro":"您可以查看、搜索和下载工作流程运行中每个作业的日志。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/how-tos","title":"操作方法"},{"href":"/zh/actions/how-tos/monitor-workflows","title":"监视工作流"},{"href":"/zh/actions/how-tos/monitor-workflows/use-workflow-run-logs","title":"使用工作流运行日志"}],"documentType":"article"},"body":"# 使用工作流运行日志\n\n您可以查看、搜索和下载工作流程运行中每个作业的日志。\n\n您可以从工作流程运行页面查看工作流程运行是在进行中，还是已完成。 必须登录到 GitHub 帐户才能查看工作流运行信息，包括公共存储库。 有关详细信息，请参阅“[对GitHub的访问权限](/zh/get-started/learning-about-github/access-permissions-on-github)”。\n\n如果运行已完成，则可查看运行结果是成功、失败、已取消还是中性。 如果运行失败，您可以查看并搜索构建日志，来诊断失败原因并重新运行工作流程。 您也可以查看可计费作业执行分钟数，或下载日志和创建构件。\n\nGitHub Actions 使用检查 API 输出工作流的状态、结果和日志。\nGitHub 为每个工作流运行创建新的检查套件。 检查套件包含检查工作流程中每项作业的运行，而每项作业包含步骤。\nGitHub Actions 作为工作流中的一个步骤运行。 有关检查 API 的详细信息，请参阅“[检验的 REST API 端点](/zh/rest/checks)”。\n\n> \\[!NOTE]\n> 确保只将有效的工作流文件提交到存储库。 如果 `.github/workflows` 含有无效的工作流文件，则 GitHub Actions 将为每次新提交生成失败的工作流运行。\n\n## 查看日志以诊断故障\n\n如果工作流程运行失败，您可以查看是哪个步骤导致了失败，然后审查失败步骤的创建日志进行故障排除。 您可以查看每个步骤运行的时长。 也可以将永久链接复制到日志文件中的特定行，与您的团队分享。 执行这些步骤需要对仓库的读取访问权限。\n\n除了工作流文件中配置的步骤外， GitHub 还向每个作业添加两个附加步骤以设置和完成作业的执行。 这些步骤以名称\"设置作业\"和\"完成作业\"记录在工作流程运行中。\n\n对于在 GitHub 托管的运行器上运行的作业，“设置作业”会记录运行器映像的详细信息，它还包含一个链接，指向运行器机器上的预安装工具列表。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n2. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n \n3. 在左侧边栏中，单击您想要查看的工作流程。\n\n \n4. 在工作流运行列表中，单击运行的名称以查看工作流运行摘要。\n5. 在“作业”或可视化图中，选择要查看的作业。\n6. 任何失败的步骤都会自动展开以显示结果。\n7. （可选）要获取指向日志中特定行的链接，请单击该步骤的行号。 然后，您可以从 web 浏览器的地址栏中复制链接。\n\n \n\n## 搜索日志\n\n您可以搜索特定步骤的创建日志。 在搜索日志时，只有已展开的步骤会包含在结果中。 执行这些步骤需要对仓库的读取访问权限。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n2. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n \n3. 在左侧边栏中，单击您想要查看的工作流程。\n\n \n4. 在工作流运行列表中，单击运行的名称以查看工作流运行摘要。\n5. 在“作业”或可视化图中，选择要查看的作业。\n6. 在日志输出右上角的“搜索日志”搜索框中，输入搜索查询。\n\n## 下载日志\n\n您可以从工作流程运行中下载日志文件。 您也可以下载工作流程的构件。 有关详细信息，请参阅“[使用工作流工件存储和共享数据](/zh/actions/tutorials/store-and-share-data)”。 执行这些步骤需要对仓库的读取访问权限。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n2. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n \n3. 在左侧边栏中，单击您想要查看的工作流程。\n\n \n4. 在工作流运行列表中，单击运行的名称以查看工作流运行摘要。\n5. 在“作业”或可视化图中，选择要查看的作业。\n6. 在日志右上角，选择 下拉菜单，然后单击“ **下载日志存档**”。\n\n \n\n> \\[!NOTE]\n> 下载部分重新运行的工作流的日志存档时，存档仅包括已重新运行的作业。 若要获取从工作流程运行的作业的完整日志集，必须下载运行其他作业的上一次运行尝试的日志存档。\n\n## 删除日志\n\n您可以通过 GitHub Web 界面或以编程方式删除工作流运行中的日志文件。 执行这些步骤需要对仓库的写入访问权限。\n\n### 通过 GitHub Web 界面删除日志\n\n1. 在 GitHub 上，导航到存储库的主页面。\n\n2. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n \n\n3. 在左侧边栏中，单击您想要查看的工作流程。\n\n \n\n4. 在工作流运行列表中，单击运行的名称以查看工作流运行摘要。\n\n5. 在右上角，选择 下拉菜单，然后单击“ **删除所有日志**”。\n\n \n\n6. 查看确认提示。\n\n删除日志后，“删除所有日志”按钮将会移除，以表示在工作流运行中没有日志文件。\n\n### 以编程方式删除日志\n\n可以使用以下脚本自动删除工作流的所有日志。 通过该方法可有效清理多个工作流运行的日志。\n\n要运行下列脚本示例，请执行以下操作：\n\n1. 复制代码示例并将其保存到名为 `delete-logs.sh` 的文件中。\n2. 通过 `chmod +x delete-logs.sh` 授予执行权限。\n3. 运行以下命令，其中 `REPOSITORY_NAME` 为存储库的名称，`WORKFLOW_NAME` 为工作流的文件名。\n\n ```shell copy\n ./delete-logs.sh REPOSITORY_NAME WORKFLOW_NAME\n ```\n\n 例如，要删除 `monalisa/octocat` 工作流 `.github/workflows/ci.yaml` 存储库中的所有日志，须运行 `./delete-logs.sh monalisa/octocat ci.yaml`。\n\n#### 示例脚本\n\n```bash copy\n#!/usr/bin/env bash\n\n# Delete all logs for a given workflow\n# Usage: delete-logs.sh \n\nset -oe pipefail\n\nREPOSITORY=$1\nWORKFLOW_NAME=$2\n\n# Validate arguments\nif [[ -z \"$REPOSITORY\" ]]; then\n echo \"Repository is required\"\n exit 1\nfi\n\nif [[ -z \"$WORKFLOW_NAME\" ]]; then\n echo \"Workflow name is required\"\n exit 1\nfi\n\necho \"Getting all completed runs for workflow $WORKFLOW_NAME in $REPOSITORY\"\n\nRUNS=$(\n gh api \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/workflows/$WORKFLOW_NAME/runs\" \\\n --paginate \\\n --jq '.workflow_runs[] | select(.conclusion != \"\") | .id'\n)\n\necho \"Found $(echo \"$RUNS\" | wc -l) completed runs for workflow $WORKFLOW_NAME\"\n\n# Delete logs for each run\nfor RUN in $RUNS; do\n echo \"Deleting logs for run $RUN\"\n gh api \\\n --silent \\\n --method DELETE \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/runs/$RUN/logs\" || echo \"Failed to delete logs for run $RUN\"\n\n # Sleep for 100ms to avoid rate limiting\n sleep 0.1\ndone\n```\n\n## 使用 GitHub CLI 查看日志\n\n> \\[!NOTE]\n> 若要详细了解 GitHub CLI，请参阅“[关于 GitHub CLI](/zh/github-cli/github-cli/about-github-cli)”。\n\n若要查看特定作业的日志，请使用 `run view` 子命令。 将 `run-id` 替换为想要查看其日志的运行的 ID。\nGitHub CLI 将返回一个交互式菜单，供您从运行中选择作业。 如果未指定 `run-id`， GitHub CLI 则返回交互式菜单供你选择最近的运行，然后返回另一个交互式菜单供你从运行中选择作业。\n\n```shell\ngh run view RUN_ID --log\n```\n\n还可以使用 `--job` 标记来指定作业 ID。 将 `job-id` 替换为想要查看其日志的作业的 ID。\n\n```shell\ngh run view --job JOB_ID --log\n```\n\n可使用 `grep` 搜索日志。 例如，此命令将返回包含 `error` 一词的所有日志条目。\n\n```shell\ngh run view --job JOB_ID --log | grep error\n```\n\n若要筛选任何失败步骤的日志，请使用 `--log-failed` 而不是 `--log`。\n\n```shell\ngh run view --job JOB_ID --log-failed\n```"}