Dela via

Övervaka Python- och R-skript med utökade händelser i SQL Server Machine Learning Services

Gäller för: SQL Server 2016 (13.x) och senare versioner Azure SQL Managed Instance

Lär dig hur du använder utökade händelser för att övervaka och felsöka åtgärder relaterade till externa skript för SQL Server Machine Learning Services, SQL Server Launchpad och Python- eller R-jobb.

Utökade händelser för SQL Server Machine Learning Services

Om du vill visa en lista över händelser relaterade till SQL Server Machine Learning Services kör du följande fråga i SQL Server Management Studio (SSMS), MSSQL-tillägget för Visual Studio Code, sqlcmd eller ditt favoritverktyg för T-SQL-frågor.

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';

Mer information om hur du använder utökade händelser finns i Verktyg för utökade händelser.

Ytterligare händelser som är specifika för Machine Learning Services

Ytterligare utökade händelser är tillgängliga för komponenter som är relaterade till och används av SQL Server Machine Learning Services, till exempel SQL Server Launchpad och BXLServer, samt satellitprocessen som startar Python- eller R-körningen. Dessa ytterligare utökade händelser utlöses från de externa processerna. Därför måste de samlas in med hjälp av ett externt verktyg.

Mer information om hur du gör detta finns i avsnittet Samla in händelser från externa processer.

Tabell över utökade händelser

Event Description Noteringar
anslutning_accepterad Inträffar när en ny anslutning godkänns. Den här händelsen används för att logga alla anslutningsförsök.
misslyckad_start Det gick inte att starta. Anger ett fel.
satellit_avbryt_anslutning Avbryt anslutningsposten
satellitavbrott_mottagen Utlöses när ett avbrutet meddelande tas emot via en satellitanslutning.
satellit_avbryt_skickat Aktiveras när ett avbrottsmeddelande skickas via satellitanslutning.
slutförd satellitautentisering Utlöses när autentiseringen slutförs för en anslutning via TCP eller namngivet rör.
slutförande av satellitbehörighet Utlöses när auktoriseringen slutförs för en anslutning via TCP eller namngivet rör.
satellite_cleanup Utlöses när satelliten utför städning. Endast utlöst från extern process. Se anvisningar om hur du samlar in händelser från externa processer.
satellite_data_chunk_sent Utlöses när satellitanslutningen har skickat ett enda datasegment. Händelsen rapporterar antalet rader som skickas, antalet kolumner, antalet SNI-paket som används och tiden som förflutit i millisekunder när segmentet skickas. Informationen kan hjälpa dig att förstå hur mycket tid som ägnas åt att skicka olika typer av data och hur många paket som används.
satellit_data_mottagning_slutförd Utlöses när alla data som krävs av en fråga tas emot via satellitanslutningen. Endast utlöst från extern process. Se anvisningar om hur du samlar in händelser från externa processer.
satellit_data_sändning_slutförd Utlöses när alla nödvändiga data för en session skickas via satellitanslutningen.
satellit_data_sändning_start Utlöses när dataöverföringen startar. Dataöverföringen startar precis innan det första datasegmentet skickas.
satellite_error Används för att spåra sql-satellitfel
satellite_invalid_sized_message Meddelandets storlek är ogiltig
satellite_meddelande_sammanslagen Används för att spåra sammanfogning av meddelanden på nätverksnivå
satellit_meddelande_ringbuffert_post meddelanderingsbuffertpost
satellit_meddelande_sammanfattning sammanfattningsinformation om meddelanden
satellit_meddelande_version_missmatch Meddelandets versionsfält matchas inte
satellitmeddelanden Används för att spåra meddelandehändelser (bindning, avbindning osv.)
satellit_delmeddelande Används för att spåra partiella meddelanden i nätverksnivå
satellitschema_mottaget Utlöses när schemameddelandet tas emot och läses av SQL.
satelitschema_skickat Utlöses när schemameddelandet skickas av satelliten. Endast utlöst från extern process. Se anvisningar om hur du samlar in händelser från externa processer.
satellittjänstens_start_postad Utlöses när tjänstens startmeddelande publiceras på startskärmen. Detta instruerar Launchpad att starta den externa processen och innehåller ett ID för den nya sessionen.
satellit_oväntat_meddelande_mottaget Utlöses när ett oväntat meddelande tas emot. Anger ett fel.
stackspårning Inträffar när en minnesdump av processen begärs. Anger ett fel.
trace_event Används i spårningssyfte Dessa händelser kan innehålla SPÅRNINGsmeddelanden för SQL Server, Launchpad och externa processer. Detta inkluderar utdata till stdout och stderr från R.
launchpad_launch_start Utlöses när startplattan börjar skjuta upp en satellit. Endast utlöst från Launchpad. Se instruktioner för att samla in händelser från launchpad.exe.
launchpad_resume_sent Utlöses när launchpad har skjutit upp satelliten och skickat ett cv-meddelande till SQL Server. Endast utlöst från Launchpad. Se instruktioner för att samla in händelser från launchpad.exe.
satellite_data_chunk_sent Utlöses när satellitanslutningen har skickat ett enda datasegment. Innehåller information om antalet kolumner, antalet rader, antalet paket och den tid som förflutit när segmentet skickades.
satellite_sessionId_mismatch Meddelandets sessions-ID förväntas inte

Samla in händelser från externa processer

SQL Server Machine Learning Services startar vissa tjänster som körs utanför SQL Server-processen. Om du vill samla in händelser relaterade till dessa externa processer måste du skapa en händelsespårningskonfigurationsfil och placera filen i samma katalog som den körbara filen för processen.

Viktigt!

Från SQL Server 2019 har isoleringsmekanismen ändrats. Därför måste du ge lämplig behörighet till katalogen där händelsespårningskonfigurationsfilen lagras. Mer information om hur du anger dessa behörigheter finns i avsnittet Filbehörigheter i SQL Server 2019 i Windows: Isoleringsändringar för Machine Learning Services.

  • STARTPLATTA FÖR SQL Server

    Om du vill registrera händelser som är relaterade till Launchpad placerar du .xml-filen i Binn-katalogen för SQL Server-instansen. I en standardinstallation skulle detta vara:

    C:\Program Files\Microsoft SQL Server\MSSQL_version_number.MSSQLSERVER\MSSQL\Binn.

  • BXLServer är den satellitprocess som stöder SQL-utökningsbarhet med externa skriptspråk, till exempel R eller Python. En separat instans av BxlServer startas för varje extern språkinstans.

    För att samla in händelser relaterade till BXLServer, placera .xml-filen i R- eller Pythons installationskatalog. I en standardinstallation skulle detta vara:

    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.

Konfigurationsfilen måste namnges på samma sätt som den körbara filen med formatet "[namn].xevents.xml". Med andra ord måste filerna namnges på följande sätt:

  • Launchpad.xevents.xml
  • bxlserver.xevents.xml

Själva konfigurationsfilen har följande format:

<?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>
  • Om du vill konfigurera spårningen redigerar du platshållaren för sessionsnamn , platshållaren för filnamnet ([SessionName].xel) och namnen på de händelser som du vill samla in, till exempel [XEvent Name 1], [XEvent Name 1]).
  • Valfritt antal taggar för händelsepaket kan visas och samlas in så länge namnattributet är korrekt.

Exempel: Fånga Launchpad-händelser

I följande exempel visas definitionen av en händelsespårning för Launchpad-tjänsten:

<?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>
  • Placera .xml-filen i Binn-katalogen för SQL Server-instansen.
  • Den här filen måste ha namnet Launchpad.xevents.xml.

Exempel: Fånga BXLServer-händelser

I följande exempel visas definitionen av en händelsespårning för den körbara BXLServer-filen.

<?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>
  • Placera .xml-filen i samma katalog som den körbara BXLServer-filen.
  • Den här filen måste ha namnet bxlserver.xevents.xml.

Nästa steg