Sdílet prostřednictvím


az ml job

Poznámka:

Tento odkaz je součástí rozšíření ml pro Azure CLI (verze 2.15.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az ml job . Přečtěte si další informace o rozšířeních.

Správa úloh Azure ML

Úloha Azure ML provede úlohu vůči zadanému cílovému výpočetnímu objektu. Úlohy můžete nakonfigurovat pro horizontální navýšení kapacity trénování modelu v Azure. Azure ML podporuje různé typy úloh s různými možnostmi. Například nejzákladnější úloha, úloha příkazu, spustí příkaz v kontejneru Dockeru a dá se využít pro jednouzlu a distribuované trénování. Úloha úklidu provede úklid hyperparametrů přes zadaný vyhledávací prostor pro ladění hyperparametrů modelu.

Úlohy také umožňují systematický sledování experimentování a pracovních postupů STROJOVÉho učení. Po vytvoření úlohy azure ML udržuje záznam spuštění pro úlohu, která zahrnuje metadata, všechny metriky, protokoly a artefakty vygenerované během úlohy, kód, který se spustil, a použité prostředí Azure ML. Všechny záznamy o spuštění úloh se dají zobrazit v nástroji Azure ML Studio.

Příkazy

Name Description Typ Stav
az ml job archive

Archivace úlohy

Rozšíření GA
az ml job cancel

Zrušte úlohu.

Rozšíření GA
az ml job connect-ssh

Nastavte připojení ssh a odešle požadavek službě SSH spuštěné uvnitř kontejneru uživatele prostřednictvím Tundra.

Rozšíření GA
az ml job create

Vytvořte úlohu.

Rozšíření GA
az ml job download

Stáhněte všechny soubory související s úlohou.

Rozšíření GA
az ml job list

Zobrazení seznamu úloh v pracovním prostoru

Rozšíření GA
az ml job restore

Obnovení archivované úlohy

Rozšíření GA
az ml job show

Zobrazení podrobností pro úlohu

Rozšíření GA
az ml job show-services

Zobrazení služeb úlohy na uzel

Rozšíření GA
az ml job stream

Streamování protokolů úloh do konzoly

Rozšíření GA
az ml job update

Aktualizujte úlohu.

Rozšíření GA
az ml job validate

Ověřte úlohu. Tento příkaz funguje jenom pro úlohy kanálu.

Rozšíření GA

az ml job archive

Archivace úlohy

Archivace úlohy ji ve výchozím nastavení skryje v dotazech seznamu (az ml job list). V pracovních postupech můžete i nadále odkazovat a používat archivovanou úlohu. Archivovat lze pouze dokončené úlohy.

az ml job archive --name
                  --resource-group
                  --workspace-name

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job cancel

Zrušte úlohu.

az ml job cancel --name
                 --resource-group
                 --workspace-name

Příklady

Zrušení úlohy podle názvu

az ml job cancel --name my-job-id --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job connect-ssh

Nastavte připojení ssh a odešle požadavek službě SSH spuštěné uvnitř kontejneru uživatele prostřednictvím Tundra.

az ml job connect-ssh --name
                      --resource-group
                      --workspace-name
                      [--node-index]
                      [--private-key-file-path]

Příklady

Nastavte připojení ssh a odešlete požadavek službě SSH.

az ml job connect-ssh --name my-job-id --node-index 0 --private-key-file-path "C:/Temp/.ssh/id_rsa" --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--node-index -i

Index uzlu, který se má připojit přes ssh.

Default value: 0
--private-key-file-path -f

Cesta k souboru souboru privátního klíče.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job create

Vytvořte úlohu.

Pokud chcete vytvořit úlohu, budete obvykle muset nakonfigurovat jakýkoli kód, který se má spustit, prostředí zapouzdří závislosti, cílový výpočetní objekt pro spuštění úlohy a všechna další nastavení specifická pro úlohu. Při vytvoření úlohy se odešle ke spuštění se zadaným výpočetním prostředkem.

az ml job create --file
                 --resource-group
                 --workspace-name
                 [--name]
                 [--save-as]
                 [--set]
                 [--skip-validation]
                 [--stream]
                 [--web]

Příklady

Vytvoření úlohy ze souboru specifikace YAML

az ml job create --file job.yml --resource-group my-resource-group --workspace-name my-workspace

Vytvoření úlohy ze souboru specifikace YAML a otevření podrobností o spuštění úlohy na portálu Azure ML Studio

az ml job create --file job.yml --web --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--file -f

Místní cesta k souboru YAML obsahujícímu specifikaci úlohy Azure ML. Referenční dokumenty YAML pro úlohu najdete na adrese: https://aka.ms/ml-cli-v2-job-command-yaml-reference, https://aka.ms/ml-cli-v2-job-sweep-yaml-reference, https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--name -n

Název úlohy.

--save-as -a

Soubor, do kterého se zapíše stav vytvořené úlohy ve formátu YAML.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=.

--skip-validation

Přeskočte ověření při vytváření prostředku. Všimněte si, že závislé prostředky při vytváření nepřeskočí jejich ověření.

Default value: False
--stream -s

Určuje, jestli se mají protokoly úlohy streamovat do konzoly.

Default value: False
--web -e

Zobrazení podrobností o spuštění úlohy ve službě Azure ML Studio ve webovém prohlížeči

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job download

Stáhněte všechny soubory související s úlohou.

Soubory se stáhnou do složky s názvem úlohy.

az ml job download --name
                   --resource-group
                   --workspace-name
                   [--all]
                   [--download-path]
                   [--output-name]

Příklady

Stažení protokolů a výstupů úlohy do aktuálního pracovního adresáře

az ml job download --name my-job --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--all

Stáhněte všechny výstupy úlohy.

Default value: False
--download-path -p

Cesta ke stažení souborů úloh do. Pokud tento parametr vynecháte, soubory úloh se stáhnou do aktuálního adresáře.

--output-name

Název výstupu definovaného uživatelem, který se má stáhnout. To by mělo odpovídat klíči ve výstupním slovníku úlohy. Pokud tento parametr vynecháte, stáhne se výchozí výstupní soubory artefaktů úlohy.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job list

Zobrazení seznamu úloh v pracovním prostoru

az ml job list --resource-group
               --workspace-name
               [--all-results {false, true}]
               [--archived-only]
               [--include-archived]
               [--max-results]
               [--parent-job-name]

Příklady

Vypište všechny úlohy v pracovním prostoru pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

az ml job list --query "[].{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--all-results

Vrátí všechny výsledky.

Přípustné hodnoty: false, true
Default value: False
--archived-only

Výpis pouze archivovaných úloh

Default value: False
--include-archived

Výpis archivovaných úloh a aktivních úloh

Default value: False
--max-results -r

Maximální počet výsledků, které se mají vrátit. Výchozí hodnota je 50.

Default value: 50
--parent-job-name -p

Název nadřazené úlohy Zobrazí seznam všech úloh, jejichž parent_job_name odpovídá zadanému názvu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job restore

Obnovení archivované úlohy

Když se archivovaná úloha obnoví, už nebude skrytá v dotazech seznamu (az ml job list).

az ml job restore --name
                  --resource-group
                  --workspace-name

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job show

Zobrazení podrobností pro úlohu

az ml job show --name
               --resource-group
               --workspace-name
               [--web]

Příklady

Umožňuje zobrazit stav úlohy pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

az ml job show --name my-job-id --query "{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--web -e

Zobrazení podrobností o spuštění úlohy ve službě Azure ML Studio ve webovém prohlížeči

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job show-services

Zobrazení služeb úlohy na uzel

az ml job show-services --name
                        --resource-group
                        --workspace-name
                        [--node-index]

Příklady

Zobrazte služby úlohy na uzel pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

az ml job show-services --name my-job-id --node-index 0 --query "{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--node-index -i

Index uzlu, pro který se musí zobrazit služby.

Default value: 0
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job stream

Streamování protokolů úloh do konzoly

az ml job stream --name
                 --resource-group
                 --workspace-name

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job update

Aktualizujte úlohu.

Aktualizovat lze pouze vlastnosti "tags" a "properties".

az ml job update --name
                 --resource-group
                 --workspace-name
                 [--add]
                 [--force-string]
                 [--remove]
                 [--set]
                 [--web]

Povinné parametry

--name -n

Název úlohy.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Default value: False
--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Default value: []
--web -e

Zobrazení podrobností o spuštění úlohy ve službě Azure ML Studio ve webovém prohlížeči

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml job validate

Ověřte úlohu. Tento příkaz funguje jenom pro úlohy kanálu.

Tento příkaz ověří soubor specifikace YAML, aby zkontroloval, jestli je platný pro vytvoření úlohy, a vrátí všechny nalezené problémy. Ověřování zahrnuje zejména místní kontrolu schématu, jako jsou chybějící pole, prostředí bez zadané verze, kód odkazovaný na neexistující místní cestu; Také zkontroluje existenci odkazovaných výpočetních cílů v cílovém pracovním prostoru. Výsledek ověření se vytiskne do konzoly, včetně chyb i upozornění. Selhání ověření způsobí pouze chyby. Úspěšné ověření úlohy bude možné odeslat. Tento příkaz funguje jenom pro úlohy kanálu.

az ml job validate --file
                   --resource-group
                   --workspace-name
                   [--set]

Příklady

Ověřte soubor specifikace YAML a zkontrolujte, jestli je platný pro vytvoření úlohy.

az ml job validate --file job.yml --resource-group my-resource-group --workspace-name my-workspace

Povinné parametry

--file -f

Místní cesta k souboru YAML obsahujícímu specifikaci úlohy Azure ML. Referenční dokumenty YAML pro úlohu najdete tady: https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.