Usar o estúdio de Aprendizado de Máquina do Azure para depurar falhas de pipeline
Depois de enviar um trabalho de pipeline, você pode selecionar um link para o trabalho em seu espaço de trabalho no estúdio de Aprendizado de Máquina do Azure. O link abre a página de detalhes do trabalho de pipeline, onde 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 (visualização) para depurar falhas de pipeline de aprendizado de máquina.
Importante
Os itens marcados (visualização) neste artigo estão atualmente em visualização pública. A versão de visualização é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
Use 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 seu trabalho de pipeline. Passe o cursor sobre 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 de tópicos , você pode selecionar o ícone Filtro para filtrar rapidamente a exibição para Somente nós concluídos, Somente componente ou Somente dados. Você também pode filtrar a lista inserindo nomes de nós ou nomes de componentes na caixa Pesquisar ou selecionando Adicionar filtro e escolhendo em uma lista de filtros.
O painel esquerdo mostra os nós correspondentes com mais informações, incluindo status, duração e hora e data de execução. Você pode classificar os nós filtrados.
Verificar logs e saídas de componentes
Se o pipeline falhar ou ficar preso em um nó, primeiro visualize os logs.
Selecione o nó para abrir o painel de informações à direita.
Selecione a guia Saídas + logs para visualizar todas as saídas e logs desse nó.
A pasta user_logs contém informações sobre logs gerados por código de usuário. Essa pasta é aberta por padrão e o log de std_log.txt é 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 Aprendizado de Máquina do Azure. Para saber mais, consulte Exibir e baixar logs de diagnóstico.
Nota
Se você não vir essas pastas, a atualização de tempo de execução de computação pode ainda não ter sido liberada para o cluster de computação. Você pode examinar 70_driver_log.txt na pasta azureml-logs primeiro.
Comparar trabalhos de pipeline (visualização)
Você pode comparar diferentes trabalhos de pipeline com falha de depuração ou outros problemas inesperados (visualização). A comparação de pipeline identifica as diferenças, como topologia, propriedades de componentes 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 a um trabalho concluído ou depurar 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 do megafone no canto superior direito para gerenciar os recursos de visualização. No painel do recurso Visualização gerenciada, verifique se Comparar trabalhos de pipeline para depurar falhas ou problemas inesperados está definido como Habilitado.
Comparar um trabalho de pipeline com falha com um trabalho bem-sucedido
Durante o desenvolvimento do modelo iterativo, você pode clonar e modificar um pipeline de linha de base bem-sucedido alterando um parâmetro, conjunto de dados, 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 falta de memória, você pode usar a comparação de pipeline para ver quais alterações do pipeline pai podem causar problemas de memória.
Compare 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 de pipeline pai em uma nova guia do navegador.
Em ambas as páginas, selecione Adicionar para comparar na barra de menu 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 gráfico.
Comparar gráfico
O gráfico de comparação mostra as alterações da topologia do gráfico entre os pipelines A e B. Na tela, os nós específicos do pipeline A são marcados como A e destacados em vermelho, e os nós específicos do pipeline B são marcados como 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, onde você pode ver as propriedades do conjunto de dados ou do componente, como parâmetros, runSettings e outputSettings. Você pode optar por Mostrar apenas diferenças e Mostrar diferenças embutidas.
Nessa exibição, você pode selecionar Mostrar detalhes de comparação no canto superior direito para abrir a visão geral da comparação do pipeline, que mostra as mesmas informações da página de comparação de detalhes.
Comparar detalhes
Para ver metadados, propriedades e diferenças gerais do pipeline e do trabalho, selecione Comparar detalhes na lista de comparação. A página de comparação Detalhes mostra as propriedades Pipeline e Job para ambos os trabalhos de pipeline.
- As propriedades do pipeline incluem parâmetros do pipeline, configurações de computação e configurações de saída.
- As propriedades de execução incluem status de execução, tempo e duração de envio e outras configurações de execução.
Você pode optar por Mostrar apenas diferenças e Ver diferenças embutidas ou selecionar Comparar gráfico no canto superior direito para abrir a comparação de topologia do gráfico.
A captura de tela a seguir mostra um exemplo de uso da 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ó, pode 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 destino de comparação e abra-o.
Em ambas as páginas de trabalho, selecione Adicionar para comparar na barra de menu superior para adicionar ambos os trabalhos à lista Comparar .
Quando os dois trabalhos estiverem na lista de comparação, selecione Comparar detalhes para mostrar as diferenças.
Compartilhar resultados de depuração
Para compartilhar os resultados da depuração com seus colegas de equipe ou outras partes interessadas, selecione Compartilhar na barra de menu superior. Você pode optar por Copiar link compartilhável para gráfico ou Copiar ID de trabalho de pipeline para compartilhar com outras pessoas.
