Uso de la interfaz de usuario de canalización para depurar errores de canalización de Azure Machine Learning
Después de enviar una canalización, verá un vínculo al trabajo de canalización en el área de trabajo de Azure Machine Learning. El vínculo le lleva a la página del trabajo de canalización en el Estudio de Azure Machine Learning, en el que puede comprobar el resultado y depurar el trabajo de canalización.
En este artículo se presenta cómo usar la página de trabajo de canalización para depurar errores de canalización de Machine Learning.
Importante
Los elementos marcados (versión preliminar) en este artículo se encuentran actualmente en versión preliminar pública. Se ofrece la versión preliminar sin Acuerdo de Nivel de Servicio y no se recomienda para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.
Uso del esquema para encontrar rápidamente un nodo
En la página de detalles del trabajo de canalización aparece un esquema a la izquierda del lienzo que muestra la estructura global del trabajo de canalización. Al mantener el puntero sobre cualquier fila, puede seleccionar el botón "Buscar" para buscar el nodo correspondiente en el lienzo.
Puede filtrar los nodos con errores o completados y filtrar solo por componentes o conjuntos de datos para realizar una búsqueda más exhaustiva. El panel izquierdo muestra los nodos coincidentes con más información, incluidos el estado, la duración y la hora de creación.
También puede ordenar los nodos filtrados.
Comprobación de registros y salidas del componente
Si se produce un error en la canalización o se bloquea en un nodo, vea primero los registros.
Puede seleccionar el nodo específico y abrir el panel derecho.
Seleccione la pestaña Resultados y registros, donde puede explorar todas las salidas y registros de este nodo.
La carpeta user_logs contiene información sobre los registros generados por el código del usuario. Esta carpeta está abierta de forma predeterminada y el registro std_log.txt está seleccionado. El archivo std_log.txt es donde se muestran los registros del código (por ejemplo, instrucciones print).
La carpeta system_logs contiene los registros generados por Azure Machine Learning. Obtenga más información sobre Visualización y descarga de registros de diagnóstico.
Si las carpetas no aparecen, se debe a que la actualización en tiempo de ejecución del proceso no se ha publicado todavía en el clúster de proceso y puede ver primero 70_driver_log.txt en la carpeta azureml-logs.
Comparación de diferentes canalizaciones para depurar errores u otros problemas inesperados (en versión preliminar)
La comparación de canalizaciones identifica las diferencias (incluidas la topología, las propiedades de componentes y las propiedades del trabajo) entre varios trabajos. Por ejemplo, puede comparar una canalización que funciona bien y una canalización con errores para saber qué modificaciones hacen que se produzcan esos errores en la canalización.
Los siguientes son dos escenarios principales en los que puede usar la comparación de canalizaciones para facilitar la depuración:
- Depurar el trabajo de una canalización con errores comparándolo con uno que sí se ha completado.
- Depurar un nodo con errores en una canalización comparándolo con uno similar completado.
Para habilitar esta característica, haz lo siguiente:
- Vaya a la interfaz de usuario de Estudio de Azure Machine Learning.
- Seleccione Administrar características en vista previa (gb) (icono de megáfono) entre los iconos del lado superior derecho de la pantalla.
- En el panel Administrar características en vista previa, active la opción Comparación de trabajos de canalización con errores de depuración o problemas inesperados.
Depuración de un trabajo de canalización con errores comparándolo con uno completado
Durante el desarrollo de modelos iterativos, es posible que utilice una canalización de línea base y realice algunas modificaciones, como cambiar un parámetro, un conjunto de datos, un recurso de proceso, etc. Si se produce un error en una nueva canalización, puede usar la comparación de canalizaciones para identificar lo que ha cambiado. Compararla con la canalización de línea base puede ayudar a averiguar por qué se ha producido un error.
Comparación de una canalización con su canalización primaria
Lo primero que debe hacer durante una depuración es buscar el nodo con errores y comprobar los registros.
Por ejemplo, puede obtener un mensaje de error que muestra que la canalización ha dado error debido a un problema de memoria insuficiente. Si la canalización se había clonado de una canalización primaria completada, puede usar la comparación de canalizaciones para ver lo que ha cambiado.
Seleccione Mostrar linaje.
Seleccione el vínculo que aparece debajo de "Clonada de". Se abrirá una nueva pestaña del explorador con la canalización primaria.
Seleccione Agregar para comparar en la canalización con errores y la canalización primaria. Esto las agrega a la lista de candidatos de comparación.
Comparación de la topología
Una vez agregadas las dos canalizaciones a la lista de comparación, tiene dos opciones: Comparar detalle y Comparar gráfico. Comparar gráfico permite comparar la topología de las canalizaciones.
Comparar gráfico muestra los cambios en la topología del grafo entre las canalizaciones A y B. Los nodos especiales de la canalización A se resaltan en rojo y se marcan con "solo A". Los nodos especiales de la canalización B aparecen en verde y marcados con "solo B". Los nodos compartidos aparecen en gris. Si hay diferencias en los nodos compartidos, se muestra lo que ha cambiado en la parte superior del nodo.
Hay tres categorías de cambios con resúmenes visibles en la página de detalles: cambio de parámetro, origen de la entrada, componente de la canalización. Cuando varía un componente de la canalización, significa que hay un cambio de topología interno o un cambio de parámetro de nodo interno. Puede seleccionar el icono de carpeta en el nodo del componente de la canalización para profundizar en los detalles. Se pueden detectar otros cambios viendo los nodos coloreados en el grafo comparativo.
Comparación de la metainformación y las propiedades de las canalizaciones
Si investiga las diferencias en el conjunto de datos y detecta que los datos o la topología no parecen ser la causa principal del error, también puede comprobar los detalles de las canalizaciones, como los parámetros, la salida o la configuración de ejecución.
Comparar gráfico se usa para comparar la topología de las canalizaciones. Comparar detalles se usa para comparar la metainformación o la configuración de las propiedades de las canalizaciones.
Para acceder a la comparación de los detalles, vaya a la lista de comparación, seleccione Comparar detalles o Mostrar detalles de la comparación en la página de comparación de las canalizaciones.
Verá Propiedades de canalización y Propiedades de ejecución.
- Las propiedades de las canalizaciones incluyen parámetros de canalización, configuración de ejecución y de salida, etc.
- Las propiedades de ejecución incluyen el estado del trabajo, el tiempo de envío, la duración, etc.
En la captura de pantalla siguiente se muestra un ejemplo del uso de la comparación de detalles, donde la configuración de proceso predeterminada podría haber sido el motivo del error.
Para comprobar rápidamente la comparación de topologías, seleccione el nombre de la canalización y elija Comparar gráfico.
Depuración de un nodo con errores en una canalización comparándolo con un nodo similar completado
Si solo ha actualizado las propiedades del nodo y no ha cambiado nada en la canalización, puede depurar el nodo comparándolo con los trabajos enviados desde el mismo componente.
Búsqueda del trabajo con el que se va a comparar
- Busque un trabajo que se haya ejecutado correctamente para compararlo viendo todas las ejecuciones enviadas desde el mismo componente.
Seleccione el nodo con errores, haga clic con el botón derecho y elija Ver trabajos. Esto le proporciona una lista de todos los trabajos.
Elija un trabajo completado como destino para la comparación.
- Después de encontrar un trabajo con errores y uno completado para compararlos, agregue los dos trabajos a la lista de candidatos de comparación.
- Para el nodo con errores, haga clic con el botón derecho y seleccione Agregar para comparar.
- Para el trabajo completado, vaya a su canalización primaria y busque el trabajo completado. A continuación, seleccione Agregar para comparar.
- Cuando los dos trabajos estén en la lista de comparación, seleccione Comparar detalles para mostrar las diferencias.
Uso compartido de los resultados de la comparación
Para compartir los resultados de la comparación, seleccione Compartir y copie el vínculo. Por ejemplo, es posible que descubra que la diferencia en el conjunto de datos podría ser la causa del error, pero no es especialista en conjuntos de datos. Puede compartir el resultado de la comparación con un ingeniero de datos de su equipo.
Pasos siguientes
En este artículo, ha aprendido a depurar errores de canalización. Para obtener más información sobre cómo puede usar la canalización, consulte los artículos siguientes: