Usar o Estúdio do Azure Machine Learning para depurar falhas de pipeline
Depois de enviar um trabalho de pipeline, você pode selecionar um link para o trabalho em seu workspace no Estúdio do Azure Machine Learning. O link abre a página de detalhes do trabalho de pipeline, na qual você pode verificar os resultados e depurar trabalhos de pipeline com falha. Este artigo explica como usar a página de detalhes do trabalho de pipeline e a comparação de pipeline (versão prévia) para depurar falhas de pipeline de machine learning.
Importante
Os itens marcados (versão prévia) neste artigo estão atualmente em versão prévia pública. A versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.
Usar a estrutura de tópicos para localizar rapidamente um nó
Na página de detalhes do trabalho de pipeline, o painel Estrutura de Tópicos à esquerda mostra a estrutura geral do trabalho de pipeline. Focalize qualquer linha e selecione o ícone Localizar na tela para realçar esse nó na tela e abrir um painel de informações para o nó à direita.
No painel Estrutura do Código, você pode selecionar o ícone Filtrar para filtrar rapidamente o modo de exibição para Somente nós concluídos, Somente componenteou Somente dados. Você também pode filtrar a lista inserindo nomes de nó ou nomes de componente na caixa Pesquisar ou selecionando Adicionar filtro e escolhendo entre uma lista de filtros.
O painel esquerdo mostra os nós correspondentes com mais informações, incluindo status, duração, tempo de execução e data. Você pode classificar os nós filtrados.
Verificar logs e saídas do componente
Se o pipeline falhar ou ficar preso em um nó, primeiro exiba os logs.
Selecione o nó para abrir o painel de informações à direita.
Selecione a guia Saídas + logs para exibir todas as saídas e logs desse nó.
A pasta user_logs contém informações sobre logs gerados pelo código do usuário. Essa pasta é aberta por padrão e o std_log.txt log está selecionado. Os logs do código, como instruções de impressão, aparecem no std_log.txt.
A pasta system_logs contém logs gerados pelo Azure Machine Learning. Para saber mais, confira Como exibir e baixar logs de diagnóstico.
Observação
Se não vir essas pastas, a atualização do tempo de execução de cálculo pode não ter sido lançada para o cluster de cálculo ainda. Você pode examinar 70_driver_log.txt na pasta azureml-logs primeiro.
Comparar trabalhos de pipeline (versão prévia)
Você pode comparar trabalhos de pipelines diferentes com falha de depuração ou outros problemas inesperados (versão prévia). A comparação de pipeline identifica as diferenças, como topologia, propriedades de componente e propriedades de trabalho, entre trabalhos de pipeline.
Você pode comparar trabalhos de pipeline bem-sucedidos e com falha para encontrar diferenças que podem fazer com que um trabalho de pipeline falhe. Você pode depurar um trabalho de pipeline com falha comparando-o com um trabalho concluído ou depurando um nó com falha em um pipeline comparando-o a um nó concluído semelhante.
Para habilitar esse recurso no Estúdio do Azure Machine Learning, selecione o ícone de megafone na parte superior direita para gerenciar a versão prévia do recurso. No painel de Gerenciamento de versão prévia do recurso, verifique se Comparar trabalhos de pipeline com falhas de depuração ou problemas inesperados está Habilitado.
Comparar um trabalho de pipeline com falha com um trabalho bem-sucedido
Durante o desenvolvimento de modelo iterativo, você pode clonar e modificar um pipeline de linha de base bem-sucedido alterando um parâmetro, um conjunto de dados, um recurso de computação ou outra configuração. Se o novo pipeline falhar, você poderá usar a comparação de pipeline para ajudar a descobrir a falha identificando as alterações do pipeline pai.
Por exemplo, se o novo pipeline falhou devido a um problema de memória insuficiente, você pode usar a comparação de pipeline para ver quais alterações do pipeline pai podem causar problemas de memória.
Comparar o pipeline com seu pai
Na página de trabalho de pipeline com falha, selecione Mostrar linhagem.
Selecione o link no pop-up Clonado de para abrir a página de trabalho do pipeline pai em uma nova guia do navegador.
Em ambas as páginas, selecione Adicionar para comparar na barra de menus superior para adicionar ambos os trabalhos à lista Comparar.
Depois de adicionar ambos os pipelines à lista de comparação, você pode selecionar Comparar detalhes ou Comparar grafo.
Comparar gráfico
Comparar grafo mostra as alterações de topologia de grafo entre pipelines A e B. Na tela, os nós específicos do pipeline A são marcados com A e realçados em vermelho e os nós específicos do pipeline B são marcados com B e realçados em verde. Uma descrição das alterações aparece na parte superior dos nós que têm diferenças.
Você pode selecionar qualquer nó para abrir um painel de Informações do componente, no qual você pode ver as Propriedades do conjunto de dados ou Propriedades do componente como parâmetros, runSettingse outputSettings. Você pode optar por Mostrar apenas as diferenças e Mostrar diferenças embutidas.
Nesse modo de exibição, você pode selecionar Mostrar detalhes de comparação no canto superior direito para abrir o pipeline Visão geral de comparação, que mostra as mesmas informações da página Comparação de detalhes.
Comparar detalhes
Para ver os metadados gerais de pipeline e trabalho, propriedades e diferenças, selecione Comparar detalhes na lista de comparação. A página Comparação de detalhes mostra as Propriedades do pipeline e as Propriedades do trabalho para ambos os trabalhos de pipeline.
- As propriedades do pipeline incluem parâmetros de pipeline, configurações de execução e configurações de saída.
- As propriedades de execução incluem status de execução, tempo e duração do envio e outras configurações de execução.
Você pode optar por Mostrar apenas diferenças e Ver diferenças embutidas ou selecionar Comparar grafo no canto superior direito para abrir a comparação de topologia de grafo.
A captura de tela a seguir mostra um exemplo de como usar a comparação de detalhes, em que a configuração defaultCompute pode ser o motivo da falha.
Comparar um nó de pipeline com falha com um nó concluído semelhante
Se você atualizou apenas as propriedades do nó, poderá depurar o nó comparando-o com o mesmo nó em outros trabalhos.
Selecione com o botão direito do mouse um nó com falha e selecione Exibir trabalhos para obter uma lista de trabalhos.
Escolha um trabalho concluído como um destino de comparação e abra-o.
Em ambas as páginas de trabalho, selecione Adicionar para comparar na barra de menus superior para adicionar ambos os trabalhos à lista Comparar.
Depois que os dois trabalhos estiverem na lista de comparação, selecione Comparar detalhes para mostrar as diferenças.
Compartilhar resultados da depuração
Para compartilhar os resultados da depuração com seus colegas de equipe ou outros stakeholders, selecione Compartilhar na barra de menus superior. Você pode optar por Copiar link compartilhável para grafo ou Copiar ID de trabalho do pipeline para compartilhar com outras pessoas.
