在 GitHub 上编辑

queue logs

显示 DVC 实验 任务的控制台输出日志(参见 dvc queue start)。

概要

usage: dvc queue logs [-h] [-q | -v] [-e <encoding>] [-f] <task>

positional arguments:
  <task>                Task to show.

描述

显示指定的正在运行或已完成的实验 task 的控制台输出日志。

默认情况下,此命令将显示所有现有日志,然后退出。对于正在运行的任务,可以使用 --follow 选项附加到任务并实时查看日志(直到任务完成)。

通过 Ctrl+C(或 SIGINT)中断 --follow 进程是安全的。这只会导致 dvc queue logs 命令退出,而实验任务仍会在后台继续运行。

选项

  • -e <encoding>, --encoding <encoding> - 日志输出的文本编码。默认使用系统区域设置编码。

    请注意,此选项用于指定实验任务输出的编码(即管道阶段命令的输出),该编码可能并不总是与系统终端的编码匹配。

  • -f, --follow - 附加到任务并持续跟踪最新的实时输出。仅适用于仍在运行的任务。

  • -h, --help - 打印使用说明/帮助信息,然后退出。

  • -q, --quiet - 不向标准输出写入任何内容。

  • -v, --verbose - 显示详细的跟踪信息。

示例:查看已完成实验任务的日志

假设我们之前已运行了一些排队的实验任务:

$ dvc queue status
Task     Name    Created    Status
192a13c          04:15 PM   Failed
753b005          04:01 PM   Success
0bbb118          04:01 PM   Success
1ae8b65          04:01 PM   Success

Worker status: 0 active, 0 idle

我们可以查看失败和成功完成的实验任务的输出:

$ dvc queue logs 192a13c
'data/data.xml.dvc' didn't change, skipping
Running stage 'prepare':
> python src/prepare.py data/data.xml
Traceback (most recent call last):
  File "/Users/pmrowla/git/example-get-started/.dvc/tmp/exps/tmp217n0tjv/src/prepare.py", line 10, in <module>
    raise AssertionError
AssertionError
ERROR: failed to reproduce 'prepare': failed to run: python src/prepare.py data/data.xml, exited with 1
$ dvc queue logs 0bbb118
'data/data.xml.dvc' didn't change, skipping
Stage 'prepare' is cached - skipping run, checking out outputs
Updating lock file 'dvc.lock'

Stage 'featurize' is cached - skipping run, checking out outputs
Updating lock file 'dvc.lock'

Stage 'train' is cached - skipping run, checking out outputs
Updating lock file 'dvc.lock'

Stage 'evaluate' is cached - skipping run, checking out outputs
Updating lock file 'dvc.lock'

To track the changes with git, run:

    git add dvc.yaml scores.json roc.json params.yaml data/prepared data/data.xml prc.json src/featurization.py data/features src/evaluate.py model.pkl dvc.lock src/train.py src/prepare.py

To enable auto staging, run:

        dvc config core.autostage true

示例:查看正在运行的实验任务的日志

让我们排队一个新的实验并在其运行时查看输出:

$ dvc exp run --queue -S prepare.split=0.40 -S featurize.max_features=4000
Queued experiment '93cfa70' for future execution.
$ dvc queue start
Started '1' new experiments task queue worker.
$ dvc queue logs 93cfa70
'data/data.xml.dvc' didn't change, skipping
Running stage 'prepare':
> python src/prepare.py data/data.xml
Updating lock file 'dvc.lock'

Running stage 'featurize':
> python src/featurization.py data/prepared data/features

我们可以看到,默认情况下,dvc queue logs 会显示任何可用的输出,然后退出。在这种情况下,我们的 featurize 阶段仍在运行,因此此时没有更多输出可用。

如果我们希望持续查看正在运行的任务的实时输出(直到其完成),也可以使用 --follow 选项。

内容

🐛 发现问题?告诉我们!或者修复它:

在 GitHub 上编辑

有疑问?加入我们的聊天,我们会为您提供帮助:

Discord 聊天