Compartir a través de

Registro de script de inicialización

  • Artículo

Los eventos de inicio y finalización de scripts de inicialización se capturan en registros de eventos de clúster. Los detalles se capturan en registros de clúster. Los eventos de creación, edición y eliminación de scripts de inicialización globales también se capturan en registros de diagnóstico a nivel de cuenta.

Eventos de scripts de inicialización

Los registros de eventos de clúster capturan dos eventos de scripts de inicialización: INIT_SCRIPTS_STARTED y INIT_SCRIPTS_FINISHED, que indican qué scripts están programados para su ejecución y cuáles se han completado correctamente. INIT_SCRIPTS_FINISHED también captura la duración de la ejecución.

Los scripts de inicialización globales se indican en los detalles de los eventos en los registros con la clave "global", y los scripts de inicialización de ámbito de clúster se indican con la clave "cluster".

Nota:

Los registros de eventos de clúster no recogen eventos de scripts de inicialización de cada nodo del clúster; se selecciona un único nodo para representarlos a todos.

¿Dónde se escriben los registros del script de inicialización?

Si se configura la entrega de registros de clúster para un clúster, los registros de scripts de inicialización se escriben en /<cluster-log-path>/<cluster-id>/init_scripts.

Los registros de cada contenedor del clúster se escriben en un subdirectorio denominado init_scripts/<cluster-id>_<container-ip>.

Por ejemplo, si cluster-log-path se establece en cluster-logs, la ruta de acceso a los registros de un contenedor específico sería: dbfs:/cluster-logs/<cluster-id>/init_scripts/<cluster-id>_<container-ip>.

Si el clúster está configurado para escribir los registros en DBFS, puede verlos con la utilidad del sistema de archivos (dbutils.fs) o con la CLI de DBFS (heredada). Por ejemplo, si el id. del clúster es 1001-234039-abcde739:

dbfs ls dbfs:/cluster-logs/1001-234039-abcde739/init_scripts

1001-234039-abcde739_10_97_225_166
1001-234039-abcde739_10_97_231_88
1001-234039-abcde739_10_97_244_199

dbfs ls dbfs:/cluster-logs/1001-234039-abcde739/init_scripts/1001-234039-abcde739_10_97_225_166

<timestamp>_<log-id>_<init-script-name>.sh.stderr.log
<timestamp>_<log-id>_<init-script-name>.sh.stdout.log

Cuando no se configura la entrega de registros de clúster, los registros se escriben en /databricks/init_scripts. Puede usar comandos de shell estándar en un cuaderno para enumerar y ver los registros:

%sh
ls /databricks/init_scripts/
cat /databricks/init_scripts/<timestamp>_<log-id>_<init-script-name>.sh.stdout.log

Cada vez que se inicia un clúster, escribe un registro en la carpeta de registros del script de inicialización.

Importante

Cualquier usuario que cree un clúster y habilite la entrega de registros del clúster puede ver la salida de stderr y stdout de los scripts de inicialización globales. Debe asegurarse de que los scripts de inicialización globales no devuelvan ninguna información confidencial.

Eventos de script de inicialización en registros de diagnóstico

Los registros de diagnóstico de Azure Databricks capturan los eventos de creación, edición y eliminación de scripts de inicialización globales en el tipo de evento globalInitScripts. Consulte Eventos de scripts de inicialización globales.