在 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
选项。