Memantau skrip Python dan R dengan peristiwa yang diperluas di SQL Server Machine Learning Services
Berlaku untuk:
SQL Server 2016 (13.x) dan yang lebih baru Azure SQL Managed Instance
Pelajari cara menggunakan peristiwa yang diperluas untuk memantau dan memecahkan masalah operasi yang terkait dengan SQL Server Machine Learning Services, SQL Server Launchpad, dan skrip eksternal pekerjaan Python atau R.
Acara yang diperluas untuk SQL Server Machine Learning Services
Untuk menampilkan daftar peristiwa yang terkait dengan SQL Server Machine Learning Services, jalankan kueri berikut dari Azure Data Studio atau 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';
Untuk informasi selengkapnya tentang cara menggunakan peristiwa yang diperluas, lihat Alat Peristiwa yang Diperluas.
Peristiwa tambahan khusus untuk Layanan Pembelajaran Mesin
Peristiwa tambahan yang diperluas tersedia untuk komponen yang terkait dengan dan digunakan oleh SQL Server Machine Learning Services, seperti SQL Server Launchpad, dan BXLServer, dan proses satelit yang memulai runtime Python atau R. Peristiwa tambahan yang diperluas ini diaktifkan dari proses eksternal; oleh karena itu, mereka harus ditangkap menggunakan utilitas eksternal.
Untuk informasi selengkapnya tentang cara melakukannya, lihat bagian Mengumpulkan peristiwa dari proses eksternal.
Tabel peristiwa yang diperluas
| Kejadian | Deskripsi | Catatan |
|---|---|---|
| connection_accept | Terjadi ketika koneksi baru diterima. Kejadian ini berfungsi untuk mencatat semua upaya koneksi. | |
| failed_launching | Peluncuran gagal. | Menunjukkan kesalahan. |
| satellite_abort_connection | Membatalkan rekaman koneksi | |
| satellite_abort_received | Kebakaran ketika pesan pembatatan diterima melalui koneksi satelit. | |
| satellite_abort_sent | Menembak ketika pesan pembatakan dikirim melalui koneksi satelit. | |
| satellite_authentication_completion | Diaktifkan saat autentikasi selesai untuk koneksi melalui TCP atau pipa Bernama. | |
| satellite_authorization_completion | Diaktifkan saat otorisasi selesai untuk koneksi melalui TCP atau pipa Bernama. | |
| satellite_cleanup | Kebakaran ketika satelit memanggil pembersihan. | Diaktifkan hanya dari proses eksternal. Lihat instruksi tentang mengumpulkan peristiwa dari proses eksternal. |
| satellite_data_chunk_sent | Kebakaran ketika koneksi satelit selesai mengirim satu gugus data. | Peristiwa melaporkan jumlah baris yang dikirim, jumlah kolom, jumlah paket SNI yang digunakan dan waktu yang berlalu dalam milidetik saat mengirim potongan. Informasi ini dapat membantu Anda memahami berapa banyak waktu yang dihabiskan untuk melewati berbagai jenis data, dan berapa banyak paket yang digunakan. |
| satellite_data_receive_completion | Diaktifkan ketika semua data yang diperlukan oleh kueri diterima melalui koneksi satelit. | Diaktifkan hanya dari proses eksternal. Lihat instruksi tentang mengumpulkan peristiwa dari proses eksternal. |
| satellite_data_send_completion | Kebakaran ketika semua data yang diperlukan untuk sesi dikirim melalui koneksi satelit. | |
| satellite_data_send_start | Diaktifkan saat transmisi data dimulai. | Transmisi data dimulai tepat sebelum potongan data pertama dikirim. |
| satellite_error | Digunakan untuk melacak kesalahan satelit sql | |
| satellite_invalid_sized_message | Ukuran pesan tidak valid | |
| satellite_message_coalesced | Digunakan untuk melacak koales pesan di lapisan jaringan | |
| satellite_message_ring_buffer_record | rekaman buffer cincin pesan | |
| satellite_message_summary | informasi ringkasan tentang olahpesan | |
| satellite_message_version_mismatch | Bidang versi pesan tidak cocok | |
| satellite_messaging | Digunakan untuk melacak peristiwa olahpesan (ikat, batalkan ikatan, dll.) | |
| satellite_partial_message | Digunakan untuk melacak pesan parsial di lapisan jaringan | |
| satellite_schema_received | Aktif ketika pesan skema diterima dan dibaca oleh SQL. | |
| satellite_schema_sent | Kebakaran ketika pesan skema dikirim oleh satelit. | Diaktifkan hanya dari proses eksternal. Lihat instruksi tentang mengumpulkan peristiwa dari proses eksternal. |
| satellite_service_start_posted | Diaktifkan saat pesan mulai layanan diposting ke launchpad. | Ini memberi tahu Launchpad untuk memulai proses eksternal, dan berisi ID untuk sesi baru. |
| satellite_unexpected_message_received | Aktif ketika pesan tak terduga diterima. | Menunjukkan kesalahan. |
| stack_trace | Terjadi ketika cadangan memori proses diminta. | Menunjukkan kesalahan. |
| trace_event | Digunakan untuk tujuan pelacakan | Peristiwa ini dapat berisi SQL Server, Launchpad, dan pesan pelacakan proses eksternal. Ini termasuk output ke stdout dan stderr dari R. |
| launchpad_launch_start | Kebakaran ketika launchpad mulai meluncurkan satelit. | Diaktifkan hanya dari Launchpad. Lihat instruksi tentang mengumpulkan peristiwa dari launchpad.exe. |
| launchpad_resume_sent | Kebakaran ketika launchpad telah meluncurkan satelit dan mengirim pesan resume ke SQL Server. | Diaktifkan hanya dari Launchpad. Lihat instruksi tentang mengumpulkan peristiwa dari launchpad.exe. |
| satellite_data_chunk_sent | Kebakaran ketika koneksi satelit selesai mengirim satu gugus data. | Berisi informasi tentang jumlah kolom, jumlah baris, jumlah paket, dan waktu yang berlalu saat mengirim gugus. |
| satellite_sessionId_mismatch | ID sesi pesan tidak diharapkan |
Mengumpulkan peristiwa dari proses eksternal
SQL Server Machine Learning Services memulai beberapa layanan yang berjalan di luar proses SQL Server. Untuk mengambil peristiwa yang terkait dengan proses eksternal ini, Anda harus membuat file konfigurasi pelacakan peristiwa dan menempatkan file di direktori yang sama dengan yang dapat dieksekusi untuk proses tersebut.
Penting
Dari SQL Server 2019, mekanisme isolasi telah berubah. Oleh karena itu, Anda perlu memberikan izin yang sesuai ke direktori tempat file konfigurasi pelacakan peristiwa disimpan. Untuk informasi selengkapnya tentang cara mengatur izin ini, lihat bagian Izin file di SQL Server 2019 di Windows: Perubahan isolasi untuk Layanan Pembelajaran Mesin.
Launchpad SQL Server
Untuk mengambil peristiwa yang terkait dengan Launchpad, tempatkan file .xml di direktori Binn untuk instans SQL Server. Dalam penginstalan default, ini adalah:
C:\Program Files\Microsoft SQL Server\MSSQL_version_number.MSSQLSERVER\MSSQL\Binn.BXLServer adalah proses satelit yang mendukung ekstensibilitas SQL dengan bahasa skrip eksternal, seperti R atau Python. Instans terpisah BxlServer diluncurkan untuk setiap instans bahasa eksternal.
Untuk mengambil peristiwa yang terkait dengan BXLServer, tempatkan file .xml di direktori penginstalan R atau Python. Dalam penginstalan default, ini adalah:
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.
File konfigurasi harus dinamai sama dengan executable, menggunakan format "[name].xevents.xml". Dengan kata lain, file harus diberi nama sebagai berikut:
Launchpad.xevents.xmlbxlserver.xevents.xml
File konfigurasi itu sendiri memiliki format berikut:
<?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>
- Untuk mengonfigurasi jejak, edit tempat penampung nama sesi , tempat penampung untuk nama file (
[SessionName].xel), dan nama peristiwa yang ingin Anda ambil, Misalnya,[XEvent Name 1],[XEvent Name 1]). - Sejumlah tag paket peristiwa mungkin muncul, dan akan dikumpulkan selama atribut nama sudah benar.
Contoh: Menangkap peristiwa Launchpad
Contoh berikut menunjukkan definisi jejak peristiwa untuk layanan 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>
- Tempatkan file .xml di direktori Binn untuk instans SQL Server.
- File ini harus diberi nama
Launchpad.xevents.xml.
Contoh: Menangkap peristiwa BXLServer
Contoh berikut menunjukkan definisi jejak peristiwa untuk BXLServer yang dapat dieksekusi.
<?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>
- Tempatkan file .xml di direktori yang sama dengan BXLServer yang dapat dieksekusi.
- File ini harus diberi nama
bxlserver.xevents.xml.
Langkah berikutnya
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk