Supervisar scripts de Python o R con eventos extendidos en SQL Server Machine Learning Services
Se aplica a: 
SQL Server 2016 (13.x) y versiones posteriores Azure SQL Managed Instance
Obtenga información sobre cómo usar eventos extendidos para supervisar y solucionar problemas de operaciones relacionadas con los scripts externos de trabajos de Python o R, SQL Server Machine Learning Services y SQL Server Launchpad.
Eventos extendidos para SQL Server Machine Learning Services
Para ver una lista de los eventos relacionados con SQL Server Machine Learning Services, ejecute la siguiente consulta desde Azure Data Studio o SQL Server Management Studio.
SELECT o.name AS event_name, o.description
FROM sys.dm_xe_objects o
JOIN sys.dm_xe_packages p
ON o.package_guid = p.guid
WHERE o.object_type = 'event'
AND p.name = 'SQLSatellite';
Para obtener más información sobre cómo usar eventos extendidos, vea Herramientas de eventos extendidos.
Eventos adicionales específicos de Machine Learning Services
Hay eventos extendidos adicionales disponibles para los componentes que están relacionados y que se usan en SQL Server Machine Learning Services, como SQL Server Launchpad y BXLServer, y el proceso satélite que inicia el entorno de ejecución de R o Python. Estos eventos extendidos adicionales se desencadenan desde los procesos externos; por lo tanto, se deben capturar con una utilidad externa.
Para obtener más información sobre cómo hacerlo, vea la sección Recopilar eventos de procesos externos.
Tabla de eventos extendidos
| Evento | Descripción | Notas |
|---|---|---|
| connection_accept | Se produce cuando se acepta una conexión nueva. Este evento sirve para registrar todos los intentos de conexión. | |
| failed_launching | Error de inicio. | Indica un error. |
| satellite_abort_connection | Anula el registro de conexión. | |
| satellite_abort_received | Se activa cuando se recibe un mensaje de anulación por una conexión subsidiaria. | |
| satellite_abort_sent | Se activa cuando se envía un mensaje de anulación a través de una conexión subsidiaria. | |
| satellite_authentication_completion | Se activa cuando se completa la autenticación para una conexión a través de TCP o una canalización con nombre. | |
| satellite_authorization_completion | Se activa cuando se completa la autorización para una conexión a través de TCP o una canalización con nombre. | |
| satellite_cleanup | Se activa cuando la instancia subsidiaria llama a la instrucción de limpieza. | Se activa solo desde procesos externos. Consulte las instrucciones sobre la colección de eventos desde procesos externos. |
| satellite_data_chunk_sent | Se activa cuando la conexión subsidiaria termina de enviar un único fragmento de datos. | El evento notifica el número de filas enviadas, el número de columnas, el número de paquetes SNI usados y el tiempo transcurrido en milisegundos al enviar el fragmento. La información puede ayudarle a comprender cuánto tiempo se dedicó a pasar distintos tipos de datos, y cuántos paquetes se usaron. |
| satellite_data_receive_completion | Se activa cuando se reciben todos los datos que necesita una consulta a través de una conexión subsidiaria. | Se activa solo desde procesos externos. Consulte las instrucciones sobre la colección de eventos desde procesos externos. |
| satellite_data_send_completion | Se activa cuando se envían todos los datos necesarios para una sesión a través de la conexión subsidiaria. | |
| satellite_data_send_start | Se desencadena cuando se inicia la transmisión de datos. | La transmisión de datos se inicia justo antes de enviarse el primer fragmento de datos. |
| satellite_error | Se utiliza para realizar un seguimiento de un error en una instancia subsidiaria de SQL. | |
| satellite_invalid_sized_message | El tamaño del mensaje no es válido. | |
| satellite_message_coalesced | Se utiliza para realizar un seguimiento de la fusión de mensajes en la capa de red. | |
| satellite_message_ring_buffer_record | Registro de búfer en anillo del mensaje. | |
| satellite_message_summary | Información de resumen sobre la mensajería. | |
| satellite_message_version_mismatch | El campo de la versión del mensaje no coincide. | |
| satellite_messaging | Se usa para realizar un seguimiento de eventos de mensajería (vincular, desvincular, etc.). | |
| satellite_partial_message | Se utiliza para realizar un seguimiento de los mensajes parciales en la capa de red. | |
| satellite_schema_received | Se activa cuando SQL recibe y lee un mensaje de esquema. | |
| satellite_schema_sent | Se activa cuando se envía un mensaje de esquema a través de la conexión subsidiaria. | Se activa solo desde procesos externos. Consulte las instrucciones sobre la colección de eventos desde procesos externos. |
| satellite_service_start_posted | Se activa cuando se publica en Launchpad un mensaje de inicio de servicio. | Así se indica a Launchpad que inicie el proceso externo y contiene un id. para la nueva sesión. |
| satellite_unexpected_message_received | Se activa cuando se recibe un mensaje inesperado. | Indica un error. |
| stack_trace | Se produce cuando se solicita un volcado de memoria del proceso. | Indica un error. |
| trace_event | Se utiliza para realizar el seguimiento. | Estos eventos pueden contener mensajes de seguimiento de procesos externos, de Launchpad y de SQL Server. Se incluyen las salidas a stdout y stderr de R. |
| launchpad_launch_start | Se activa cuando Launchpad empieza a iniciar una instancia subsidiaria. | Solo se activa desde Launchpad. Consulte las instrucciones sobre la recopilación de eventos desde launchpad.exe. |
| launchpad_resume_sent | Se activa cuando Launchpad ha iniciado la instancia subsidiaria y enviado un mensaje de reanudación a SQL Server. | Solo se activa desde Launchpad. Consulte las instrucciones sobre la recopilación de eventos desde launchpad.exe. |
| satellite_data_chunk_sent | Se activa cuando la conexión subsidiaria termina de enviar un único fragmento de datos. | Contiene información sobre el número de columnas, de filas y de paquetes, así como del tiempo necesitado para enviar el fragmento. |
| satellite_sessionId_mismatch | No se esperaba el identificador de sesión del mensaje |
Recopilación de eventos de procesos externos
SQL Server Machine Learning Services inicia algunos servicios que se ejecutan fuera del proceso de SQL Server. Para capturar los eventos relacionados con estos procesos externos, debe crear un archivo de configuración de seguimiento de ingresos y colocarlo en el mismo directorio que el ejecutable del proceso.
Importante
A partir de SQL Server 2019, el mecanismo de aislamiento ha cambiado. Por lo tanto, debe conceder los permisos adecuados al directorio donde se almacena el archivo de configuración de seguimiento de eventos. Para más información sobre cómo establecer estos permisos, consulte la sección sobre los permisos de archivo en SQL Server 2019 en Windows: Cambios de aislamiento para Machine Learning Services.
SQL Server Launchpad
Para capturar los eventos relacionados con Launchpad, coloque el archivo .xml en el directorio Binn de la instancia de SQL Server. En una instalación predeterminada, este sería:
C:\Program Files\Microsoft SQL Server\MSSQL_version_number.MSSQLSERVER\MSSQL\Binn.BXLServer es el proceso satélite que admite la extensibilidad de SQL con lenguajes de script externos, como R o Python. Se inicia una instancia independiente de BxlServer para cada instancia de lenguaje externo.
Para capturar los eventos relacionados con BXLServer, coloque el archivo .xml en el directorio de instalación de R o Python. En una instalación predeterminada, este sería:
R:
C:\Program Files\Microsoft SQL Server\MSSQL_version_number.MSSQLSERVER\R_SERVICES\library\RevoScaleR\rxLibs\x64.Python:
C:\Program Files\Microsoft SQL Server\MSSQL_version_number.MSSQLSERVER\PYTHON_SERVICES\Lib\site-packages\revoscalepy\rxLibs.
El archivo de configuración se debe llamar igual que el ejecutable, con el formato "[nombre].xevents.xml". Dicho de otro modo, los archivos deben tener el siguiente nombre:
Launchpad.xevents.xmlbxlserver.xevents.xml
El propio archivo de configuración presenta el siguiente formato:
<?xml version="1.0" encoding="utf-8"?>
<event_sessions>
<event_session name="[session name]" maxMemory="1" dispatchLatency="1" MaxDispatchLatency="2 SECONDS">
<description owner="you">Xevent for launchpad or bxl server.</description>
<event package="SQLSatellite" name="[XEvent Name 1]" />
<event package="SQLSatellite" name="[XEvent Name 2]" />
<target package="package0" name="event_file">
<parameter name="filename" value="[SessionName].xel" />
<parameter name="max_file_size" value="10" />
<parameter name="max_rollover_files" value="10" />
</target>
</event_session>
</event_sessions>
- Para configurar el seguimiento, edite el marcador de posición nombre sesión, el marcador de posición del nombre de archivo (
[SessionName].xel) y los nombres de los eventos que quiere capturar (por ejemplo,[XEvent Name 1],[XEvent Name 1]). - Es posible que aparezca cualquier número de etiquetas de paquete de eventos y se recopilarán siempre que el atributo de nombre sea correcto.
Ejemplo: Capturar eventos de Launchpad
En el siguiente ejemplo se muestra la definición de un seguimiento de eventos para el servicio Launchpad:
<?xml version="1.0" encoding="utf-8"?>
<event_sessions>
<event_session name="sqlsatelliteut" maxMemory="1" dispatchLatency="1" MaxDispatchLatency="2 SECONDS">
<description owner="hay">Xevent for sql tdd runner.</description>
<event package="SQLSatellite" name="launchpad_launch_start" />
<event package="SQLSatellite" name="launchpad_resume_sent" />
<target package="package0" name="event_file">
<parameter name="filename" value="launchpad_session.xel" />
<parameter name="max_file_size" value="10" />
<parameter name="max_rollover_files" value="10" />
</target>
</event_session>
</event_sessions>
- Coloque el archivo .xml en el directorio Binn de la instancia de SQL Server.
- Este archivo debe tener el nombre
Launchpad.xevents.xml.
Ejemplo: Capturar eventos de BXLServer
En el siguiente ejemplo se muestra la definición de un seguimiento de eventos para el ejecutable BXLServer.
<?xml version="1.0" encoding="utf-8"?>
<event_sessions>
<event_session name="sqlsatelliteut" maxMemory="1" dispatchLatency="1" MaxDispatchLatency="2 SECONDS">
<description owner="hay">Xevent for sql tdd runner.</description>
<event package="SQLSatellite" name="satellite_abort_received" />
<event package="SQLSatellite" name="satellite_authentication_completion" />
<event package="SQLSatellite" name="satellite_cleanup" />
<event package="SQLSatellite" name="satellite_data_receive_completion" />
<event package="SQLSatellite" name="satellite_data_send_completion" />
<event package="SQLSatellite" name="satellite_data_send_start" />
<event package="SQLSatellite" name="satellite_schema_sent" />
<event package="SQLSatellite" name="satellite_unexpected_message_received" />
<event package="SQLSatellite" name="satellite_data_chunk_sent" />
<target package="package0" name="event_file">
<parameter name="filename" value="satellite_session.xel" />
<parameter name="max_file_size" value="10" />
<parameter name="max_rollover_files" value="10" />
</target>
</event_session>
</event_sessions>
- Coloque el archivo .xml en el mismo directorio que el ejecutable BXLServer.
- Este archivo debe tener el nombre
bxlserver.xevents.xml.