Condividi tramite


Usare studio di Azure Machine Learning per eseguire il debug degli errori della pipeline

Dopo aver inviato un processo della pipeline, è possibile selezionare un collegamento al processo nell'area di lavoro in studio di Azure Machine Learning. Il collegamento apre la pagina dei dettagli del processo della pipeline, in cui è possibile controllare i risultati e eseguire il debug dei processi della pipeline non riusciti. Questo articolo illustra come usare la pagina dei dettagli del processo della pipeline e il confronto delle pipeline (anteprima) per eseguire il debug degli errori della pipeline di Machine Learning.

Importante

Gli elementi contrassegnati (anteprima) in questo articolo sono attualmente disponibili in anteprima pubblica. La versione di anteprima viene messa a disposizione senza contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Usare la struttura per trovare rapidamente un nodo

Nella pagina dei dettagli del processo della pipeline il riquadro Struttura a sinistra mostra la struttura complessiva del processo della pipeline. Passare il puntatore del mouse su qualsiasi riga e selezionare l'icona Individua nell'area di disegno per evidenziare il nodo nell'area di disegno e aprire un riquadro informazioni per il nodo a destra.

Screenshot che mostra la struttura e individua nell'area di disegno.

Nel riquadro Struttura è possibile selezionare l'icona Filtro per filtrare rapidamente la visualizzazione in Solo nodi completati, Solo componente o Solo dati. È anche possibile filtrare l'elenco immettendo i nomi dei nodi o i nomi dei componenti nella casella Di ricerca oppure selezionando Aggiungi filtro e scegliendo da un elenco di filtri.

Screenshot che mostra il filtro rapido e la ricerca nel riquadro Struttura.

Il riquadro sinistro mostra i nodi corrispondenti con altre informazioni, tra cui stato, durata e data di esecuzione. È possibile ordinare i nodi filtrati.

Screenshot dell'ordinamento dei risultati della ricerca nel riquadro Struttura.

Controllare i log e gli output dei componenti

Se la pipeline ha esito negativo o si blocca su un nodo, visualizzare prima i log.

Screenshot animato che mostra come controllare i log dei nodi.

  1. Selezionare il nodo per aprire il riquadro informazioni a destra.

  2. Selezionare la scheda Output e log per visualizzare tutti gli output e i log da questo nodo.

    Screenshot del user_logs nel riquadro informazioni sul nodo.

    • La cartella user_logs contiene informazioni sui log generati dal codice utente. Questa cartella è aperta per impostazione predefinita e viene selezionato il log std_log.txt. I log del codice, ad esempio le istruzioni di stampa, vengono visualizzati nella std_log.txt.

    • La cartella system_logs contiene i log generati da Azure Machine Learning. Per altre informazioni, vedere Visualizzare e scaricare i log di diagnostica.

    Nota

    Se tali cartelle non vengono visualizzate, l'aggiornamento della fase di esecuzione del calcolo potrebbe non essere ancora rilasciato al cluster di calcolo. È possibile esaminare prima 70_driver_log.txt nella cartella azureml-logs .

Confrontare i processi della pipeline (anteprima)

È possibile confrontare processi della pipeline diversi con errori di debug o altri problemi imprevisti (anteprima). Il confronto tra pipeline identifica le differenze, ad esempio topologia, proprietà del componente e proprietà del processo, tra processi della pipeline.

È possibile confrontare i processi della pipeline riusciti e non riusciti per individuare le differenze che potrebbero causare un errore di un processo della pipeline. È possibile eseguire il debug di un processo della pipeline non riuscito confrontandolo con un processo completato oppure eseguendo il debug di un nodo non riuscito in una pipeline confrontandolo con un nodo completato simile.

Per abilitare questa funzionalità in studio di Azure Machine Learning, selezionare l'icona megafono in alto a destra per gestire le funzionalità di anteprima. Nel pannello delle funzionalità anteprima gestita assicurarsi che Confrontare i processi della pipeline con errori di debug o problemi imprevisti sia impostato su Abilitato.

Screenshot della funzionalità di anteprima attivata o disattivata.

Confrontare un processo della pipeline non riuscito con un processo riuscito

Durante lo sviluppo di modelli iterativi, è possibile clonare e modificare una pipeline di base corretta modificando un parametro, un set di dati, una risorsa di calcolo o un'altra impostazione. Se la nuova pipeline ha esito negativo, è possibile usare il confronto tra pipeline per individuare l'errore identificando le modifiche dalla pipeline padre.

Ad esempio, se la nuova pipeline non è riuscita a causa di un problema di memoria insufficiente, è possibile usare il confronto tra pipeline per verificare quali modifiche dalla pipeline padre potrebbero causare problemi di memoria.

Confrontare la pipeline con il relativo padre

  1. Nella pagina del processo della pipeline non riuscita selezionare Mostra derivazione.

  2. Selezionare il collegamento nella finestra popup Clonato da per aprire la pagina del processo della pipeline padre in una nuova scheda del browser.

    Screenshot che mostra il collegamento clonato, con il passaggio precedente, il pulsante di derivazione evidenziato.

  3. In entrambe le pagine selezionare Aggiungi per confrontare nella barra dei menu in alto per aggiungere entrambi i processi all'elenco Confronta .

    Screenshot che mostra l'elenco di confronto con una pipeline padre e figlio aggiunta.

Dopo aver aggiunto entrambe le pipeline all'elenco di confronto, è possibile selezionare Confronta dettagli o Confronta grafico.

Confrontare il grafico

Il grafico a confronto mostra le modifiche della topologia del grafo tra le pipeline A e B. Nell'area di disegno i nodi specifici della pipeline A sono contrassegnati come A e evidenziati in rosso e i nodi specifici della pipeline B sono contrassegnati come B e evidenziati in verde. Una descrizione delle modifiche viene visualizzata all'inizio dei nodi con differenze.

È possibile selezionare qualsiasi nodo per aprire un riquadro Informazioni componente, in cui è possibile visualizzare proprietà del set di dati o proprietà del componente, ad esempio parametri, esecuzione Impostazioni e output Impostazioni. È possibile scegliere Mostra solo le differenze e visualizzare le differenze inline.

Screenshot che mostra il parametro modificato e la scheda informazioni sul componente.

In questa visualizzazione è possibile selezionare Mostra dettagli confronto in alto a destra per aprire la panoramica del confronto della pipeline, che mostra le stesse informazioni della pagina di confronto Dettagli.

Confrontare i dettagli

Per visualizzare i metadati complessivi della pipeline e del processo, le proprietà e le differenze, selezionare Confronta dettagli nell'elenco di confronto. La pagina di confronto Dettagli mostra le proprietà della pipeline e le proprietà del processo per entrambi i processi della pipeline.

  • Le proprietà della pipeline includono parametri della pipeline, impostazioni di calcolo e impostazioni di output.
  • Le proprietà di esecuzione includono lo stato di esecuzione, l'ora di invio e la durata e altre impostazioni di esecuzione.

È possibile scegliere Mostra solo differenze e Visualizzare le differenze inline oppure selezionare Confronta grafico in alto a destra per aprire il confronto tra topologie del grafo.

Screenshot del confronto dei dettagli con il grafico di confronto evidenziato.

Lo screenshot seguente mostra un esempio di utilizzo del confronto dei dettagli in cui l'impostazione defaultCompute potrebbe essere il motivo dell'errore.

Screenshot che mostra la panoramica del confronto del calcolo predefinito.

Confrontare un nodo della pipeline non riuscito con un nodo completato simile

Se sono state aggiornate solo le proprietà del nodo, è possibile eseguire il debug del nodo confrontandolo con lo stesso nodo in altri processi.

  1. Selezionare un nodo con errori e selezionare Visualizza processi per ottenere un elenco di processi.

    Screenshot che mostra un nodo non riuscito con i processi di visualizzazione evidenziati.

  2. Scegliere un processo completato come destinazione di confronto e aprirlo.

  3. In entrambe le pagine del processo selezionare Aggiungi per confrontare nella barra dei menu in alto per aggiungere entrambi i processi all'elenco Confronta .

  4. Quando i due processi sono presenti nell'elenco di confronto, selezionare Confronta dettagli per visualizzare le differenze.

Condividere i risultati del debug

Per condividere i risultati di debug con i colleghi o altri stakeholder, selezionare Condividi nella barra dei menu in alto. È possibile scegliere Copia collegamento condivisibile a grafo o Copia ID processo della pipeline da condividere con altri utenti.

Screenshot che mostra il pulsante condividi e il collegamento da copiare.