ADO.NET 中的数据跟踪

Microsoft.Data.SqlClient 通过 Microsoft.Data.SqlClient.EventSource 事件源公开数据访问跟踪。 其他 ADO.NET 组件(例如用于 Oracle、OLE DB 和 ODBC 的 .NET Framework 提供程序)以及 DataSet 都具备各自的跟踪功能。

跟踪数据访问 API 调用可以帮助诊断以下问题:

  • 客户端程序和数据库之间的架构不匹配。

  • 数据库不可用或网络库问题。

  • 不正确的 SQL,无论是硬编码还是由应用程序生成。

  • 不正确的编程逻辑。

  • 由多个 ADO.NET 组件或 ADO.NET 与你自己的组件之间的交互导致的问题。

为了支持不同的跟踪技术,跟踪是可扩展的,这样,开发人员可以在任何应用程序堆栈级别上跟踪问题。 虽然跟踪并不是 ADO.NET 独有的功能,但 Microsoft 的提供程序利用了通用的跟踪和监测 API。

有关如何收集 Microsoft.Data.SqlClient 跟踪的详细信息,请参阅在 SqlClient 中启用 EventSource 跟踪。

访问扩展事件日志中的诊断信息

使用 Microsoft.Data.SqlClient 连接 ID,将客户端事件与连接环缓冲区和扩展事件日志中的服务器诊断信息(例如连接故障)相关联。 有关如何读取扩展事件日志的信息,请参阅 查看事件会话数据。

对于连接操作,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。 活动 ID 包含 16 字节 GUID 和四字节序列号。 序列号指示线程内请求的相对顺序。 旧数据访问跟踪配置字不会配置 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)

另请参阅