ADO.NET 데이터 추적

Microsoft.Data.SqlClient는 Microsoft.Data.SqlClient.EventSource 이벤트 소스를 통해 데이터 액세스 추적 기능을 제공합니다. Oracle, OLE DB 및 ODBC용 .NET Framework 공급자와 같은 다른 ADO.NET 구성 요소에는 DataSet 및 자체 추적 기능이 있습니다.

데이터 액세스 API 호출을 추적하면 다음 문제를 진단하는 데 도움이 될 수 있습니다.

  • 클라이언트 프로그램과 데이터베이스 간의 스키마 불일치입니다.

  • 데이터베이스 사용 불가 또는 네트워크 라이브러리 문제

  • 애플리케이션에서 하드 코딩 또는 생성되었는지 여부에 관계없이 SQL이 잘못되었습니다.

  • 잘못된 프로그래밍 논리입니다.

  • 여러 ADO.NET 구성 요소 간의 상호 작용 또는 ADO.NET 구성 요소와 고유한 구성 요소 간의 상호 작용으로 인해 발생하는 문제입니다.

다양한 추적 기술을 지원하기 위해 개발자가 애플리케이션 스택의 모든 수준에서 문제를 추적할 수 있도록 추적을 확장할 수 있습니다. 추적은 ADO.NET에만 국한된 기능은 아니지만, Microsoft 제공자는 일반화된 추적 및 계측 API를 활용합니다.

Microsoft.Data.SqlClient 추적을 수집하는 방법에 대한 자세한 내용은 SqlClient에서 EventSource 추적 사용을 참조하세요.

확장 이벤트 로그에서 진단 정보에 액세스

Microsoft.Data.SqlClient 연결 ID를 사용하여 connectivity ring buffer 및 확장 이벤트 로그에서 연결 오류와 같은 서버 진단 정보와 클라이언트 이벤트를 상호 연결합니다. 확장 이벤트 로그를 읽는 방법에 대한 자세한 내용은 이벤트 세션 데이터 보기를 참조하세요.

연결 작업의 경우 Microsoft. Data.SqlClient는 사전 로그인 교환 중에 클라이언트 연결 ID를 보냅니다. 연결에 실패하면 연결 상태 링 버퍼에서 ClientConnectionID 필드를 찾아 연결 실패에 대한 진단 정보를 가져옵니다. 클라이언트 연결 ID는 오류가 발생한 경우에만 링 버퍼에 로그인됩니다. 사전 로그인 교환 전에 연결이 실패하면 서버는 ID를 받지 못합니다. 클라이언트 연결 ID는 16바이트 GUID입니다. 확장 이벤트 세션의 이벤트에 client_connection_id 작업을 추가하면 확장 이벤트 대상 출력에서 클라이언트 연결 ID를 찾을 수도 있습니다.

프로그래밍 방식으로 클라이언트 연결 ID를 가져오려면 ClientConnectionId를 사용합니다.

SqlConnection이(가) 연결을 성공적으로 설정한 후에 연결 ID를 사용할 수 있습니다. 연결 시도가 실패하면 ID는 ClientConnectionId를 통해 확인할 수 있습니다.

Microsoft.Data.SqlClient는 이벤트 원본을 사용하도록 설정하고 서버에서 추적 헤더를 지원할 때 일괄 처리 문 및 RPC(원격 프로시저 호출) 요청에 대한 스레드별 활동 ID도 보냅니다. 확장 이벤트 세션에서 활동 ID를 캡처하려면 TRACK_CAUSALITY을 사용하도록 설정합니다. 활성 연결의 성능 문제의 경우 클라이언트 추적에서 활동 ID를 찾은 다음 확장 이벤트 출력에서 찾습니다. 활동 ID에는 16 바이트 GUID와 4 바이트 시퀀스 번호가 포함됩니다. 시퀀스 번호는 스레드 내 요청의 상대 순서를 나타냅니다. 레거시 데이터 액세스 추적 구성 단어는 Microsoft.Data.SqlClient의 이벤트 원본을 구성하지 않습니다.

다음은 Transact-SQL을 사용하여 링 버퍼에 저장되고 RPC 및 일괄 처리 작업 시 클라이언트에서 전송된 작업 ID를 기록하는 확장 이벤트 세션을 시작하는 샘플입니다.

create event session MySession on server
add event connectivity_ring_buffer_recorded,
add event sql_statement_starting (action (client_connection_id)),
add event sql_statement_completed (action (client_connection_id)),
add event rpc_starting (action (client_connection_id)),
add event rpc_completed (action (client_connection_id))
add target ring_buffer with (track_causality=on)

참고하십시오