Use o Estúdio do Azure Machine Learning para depurar falhas em pipelines

Depois de enviar um trabalho de pipeline, você pode selecionar um link para esse trabalho em seu espaço de trabalho no Azure Machine Learning Studio. 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.

Captura de tela mostrando o contorno e a localização na tela.

No painel Estrutura, você pode selecionar o ícone Filtro para filtrar rapidamente a exibição para mostrar apenas somente nós concluídos, somente componentes ou 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.

Captura de tela mostrando o filtro rápido e a busca no painel Estrutura.

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.

Captura de tela da ordenação dos resultados da pesquisa no painel Estrutura.

Verificar logs e saídas do componente

Se o pipeline falhar ou ficar preso em um nó, primeiro exiba os logs.

Captura de tela animada mostrando como verificar os logs dos nós.

  1. Selecione o nó para abrir o painel de informações à direita.

  2. Selecione a guia Saídas + logs para exibir todas as saídas e logs desse nó.

    Captura de tela do user_logs no painel de informações do 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 você não vir essas pastas, a atualização do runtime 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 (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.

Captura de tela da versão prévia do recurso ativada.

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, use a comparação de pipelines para ajudar a identificar a falha, analisando as alterações em relação ao pipeline pai.

Por exemplo, se o seu novo pipeline falhou devido a um problema de falta de memória, use a comparação de pipelines para ver quais alterações em relação ao pipeline pai podem estar causando problemas de memória.

Comparar o pipeline com seu pai

  1. Na página de trabalho de pipeline com falha, selecione Mostrar linhagem.

  2. Selecione o link no pop-up Clonado de para abrir a página de trabalho do pipeline pai em uma nova guia do navegador.

    Captura de tela mostrando o link clonado, com a etapa anterior, o botão de linhagem realçado.

  3. Em ambas as páginas, selecione Adicionar para comparar na barra de menus superior para adicionar ambos os trabalhos à lista Comparar.

    Captura de tela mostrando a lista de comparação com um pipeline pai e filho adicionado.

Depois de adicionar ambos os pipelines à lista de comparação, selecione Comparar detalhes ou Comparar grafo.

Comparar o 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.

Selecione qualquer nó para abrir um painel de informações de componente , em que você pode ver propriedades do conjunto de dados ou propriedades de componente , como parâmetros, runSettings e outputSettings. Você pode optar por Mostrar apenas as diferenças e Mostrar diferenças embutidas.

Captura de tela mostrando o parâmetro alterado e a guia informações do componente.

Nesta visualização, selecione Mostrar detalhes da 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 Comparação de detalhes.

Comparar detalhes

Para ver os metadados gerais do pipeline e do trabalho, as propriedades e as 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.

Captura de tela da comparação de detalhes com o grafo de comparação realçado.

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.

Captura de tela mostrando a visão geral da comparação da computação padrão.

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.

  1. Selecione com o botão direito do mouse um nó com falha e selecione Exibir trabalhos para obter uma lista de trabalhos.

    Captura de tela que mostra um nó com falha com Exibir trabalhos realçado.

  2. Escolha uma tarefa concluída como alvo de comparação e abra-a.

  3. Em ambas as páginas de trabalho, selecione Adicionar para comparar na barra de menus superior para adicionar ambos os trabalhos à lista Comparar.

  4. 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.

Captura de tela mostrando o botão compartilhar e o link que você deve copiar.

Conteúdo relacionado

  • Last updated on