NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #470 most downloaded on NuGet
SqlClient instrumentation for OpenTelemetry .NET.
Latest stable
1.21.0
Last release 11 days ago
11 Nov 2026
Ships unpredictably
gaps range from 3 weeks to 3.9 years
Nearly every release is documented
notes for 11 of 11 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
20 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Breaking Change Dropped support for net8.0 and net9.0.
Fixed db.query.summary so that a delimited identifier, such as [Orders] or [dbo].[Orders], is captured wherever an undelimited identifier would be (fo
Released 2026-Nov-06
Fixed db.query.summary so that a delimited identifier, such as [Orders] or
[dbo].[Orders], is captured wherever an undelimited identifier would be
(for example after INSERT INTO, EXEC, CREATE TABLE or a JOIN which
follows an ON clause), instead of only in a FROM clause.
(#5816)
Fixed a bracketed identifier which contains quotes and a comment marker, such
as [Orders''--], being parsed as SQL, which truncated the sanitized query
text and left a literal after it unsanitized if it was on a later line.
(#5827)
Fixed the time taken to sanitize a statement when it contains many IN ( lists
which are not terminated.
(#5827)
Fixed literals in a list of values in brackets (e.g. ['a', 'b']) being left
unsanitized if the list starts with a string in dollar quotes, a string with a
prefix, a number or a comment, or has a comment which contains a closing
bracket.
(#5827)
Updated Semantic Conventions version to 1.45.0.
(#5833)
Fixed db.query.summary so that a multi-part name which mixes undelimited
and delimited parts, such as dbo.[Orders], or which has whitespace around
a period, such as dbo . Orders or [dbo] . [Orders], is captured whole,
and so that a trailing period is no longer left in the summary when no
further part of the name follows it. As the summary is used to name the
span, the names of affected spans change.
(#5822)
Fixed db.query.summary so that the table name is included for a
TRUNCATE statement, with or without TABLE, for example
TRUNCATE TABLE Orders rather than TRUNCATE TABLE.
(#5822)
Fixed the cache of sanitized SQL statements retaining statements of any length for the lifetime of the process. Statements longer than 8192 characters are no longer cached. (#5869)
The attributes of the db.client.operation.duration metric are no longer
affected by tags set on the command's activity by processors or by
EnrichWithSqlCommand.
(#5865)
Fixed a memory leak on .NET Framework when a command executed asynchronously fails before it is sent. Upgrade to apply the fix. (#5872)
Fixed the activity of a command executed asynchronously (for example with
ExecuteNonQueryAsync()) being left as Activity.Current after the command
completed, which made every later command executed by the same method a child
of it and retained them all for as long as the method ran. The activity of a
command is no longer Activity.Current while the command executes or while
Filter and EnrichWithSqlCommand run, so use the activity argument of
EnrichWithSqlCommand instead.
(#5866)
Fixed a memory leak on .NET when a command executed asynchronously is
started with a CancellationToken that is already cancelled and has no
activity.
(#5924)
Fixed redaction of login and user names in additional CREATE, ALTER and
DROP statement positions, including references after FOR LOGIN and
WITH NAME =, and names containing combining marks.
(#5905)
Fixed db.query.summary for identifiers beginning with SQL keywords and
login or user statements in multi-statement commands.
(#5905)
Fixed query sanitization after bracketed identifiers containing apostrophes and after dollar signs in identifiers, temporary table names and variables. (#5905)
Fixed query sanitization of hexadecimal literals preceded by a unary plus. (#5905)
Fixed literals being left unsanitized in malformed SQL Server queries when escaped brackets extend an identifier beyond its 128-character limit. (#5905)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updated OpenTelemetry core component version(s) to 1.20.1.
Released 2026-Oct-21
1.20.1.
(#5651)Fixed db.query.summary so that a delimited identifier containing an escaped closing bracket, such as [Tab]]le], is captured whole instead of being tru
Released 2026-Oct-15
Fixed db.query.summary so that a delimited identifier containing an escaped
closing bracket, such as [Tab]]le], is captured whole instead of being
truncated at the escape.
(#5237)
Fixed db.client.operation.duration metrics on .NET having different
attributes depending on whether the command was sampled. When not sampled,
the db.operation.name and db.query.summary attributes were missing for
stored procedures, and the error.type and db.response.status_code
attributes were missing for commands which failed.
(#5471)
Fixed db.client.operation.duration metrics on .NET Framework not including
the db.namespace, server.address and server.port attributes for commands
which are not sampled.
(#5471)
Fixed exception messages being exported as the span status description on .NET.
The message is still recorded when RecordException is enabled.
(#5447)
Fixed query sanitization so that literals are no longer left unsanitized in
db.statement, db.query.text and db.query.summary after a quote inside a
quoted identifier or inside an array in a FROM clause.
(#5447)
Fixed query sanitization of nested block comments, PostgreSQL escape strings
(E'...'), Oracle alternative quoting (q'[...]'), MySQL/MariaDB #
comments, and of MySQL/MariaDB double-quoted strings, quoted identifiers and
dollar-quoted strings inside IN (...) lists.
(#5447)
Fixed query sanitization so that the whole of a quoted login or user name
(for example CREATE LOGIN [COMPANY\name]) is redacted.
(#5447)
Fixed db.query.summary treating a word which only differs from a keyword
by its first character (for example Xrom) as that keyword.
(#5447)
Fixed the cache of parsed data sources growing without bound when many distinct data sources are used. (#5447)
Fixed .NET Framework db.client.operation.duration metrics not being
recorded when only metrics are enabled and another ActivityListener samples
the command's activity.
(#5447)
Updated OpenTelemetry core component version(s) to 1.20.0.
(#5541)
Fixed .NET Framework db.client.operation.duration metrics to consistently include the db.query.summary attribute, regardless of sampling decision, pre
Released 2026-Sep-18
Fixed .NET Framework db.client.operation.duration metrics to consistently
include the db.query.summary attribute, regardless of sampling decision,
preventing the same query from being split across inconsistent metric series.
(#5209)
Fixed .NET Framework command correlation for db.client.operation.duration
metrics when command execution overlaps, or only metrics are being recorded.
(#5209)
Updated OpenTelemetry core component version(s) to 1.19.0.
(#5240)
Fixed query sanitization so that a ) inside a value or a comment in an IN (...) clause no longer causes the values which follow it to be left unsaniti
Released 2026-Aug-21
Fixed query sanitization so that a ) inside a value or a comment in an
IN (...) clause no longer causes the values which follow it to be left
unsanitized.
(#4929)
Fixed query sanitization so that literals are still redacted after the
db.query.summary length limit is reached.
(#4929)
Add the db.response.returned_rows attribute to the spans for commands
executed with ExecuteNonQuery() or ExecuteScalar() when the
OTEL_DOTNET_EXPERIMENTAL_SQLCLIENT_ENABLE_RECORD_RETURNED_ROWS environment
variable is set to true. The value is derived from the SqlClient connection
statistics. Not supported on .NET Framework.
(#4625)
Fixed the db.client.operation.duration metric reporting an incorrect duration
for commands which are not recorded as spans.
(#4625)
Updated OpenTelemetry core component version(s) to 1.18.0.
(#5022)
Assemblies are now digitally signed using cosign.
Fix SqlClientTraceInstrumentationOptions leaking across multiple tracer provider registrations.
Released 2026-Jun-24
Fix SqlClientTraceInstrumentationOptions leaking across multiple tracer
provider registrations.
(#4267)
Add support for native AoT on .NET 8+. (#4062)
Fix SQL query text sanitization for malformed bracketed identifiers in FROM
clauses to avoid leaking following literal values.
(#4317)
Fix SQL query text sanitization performance for malformed FROM clauses with
repeated unterminated bracketed identifiers.
(#4339)
Fix SqlClientTraceInstrumentationOptions.EnableTraceContextPropagation to behave
correctly when ActivityTraceFlags.RandomTraceId is available.
(#4397)
Fix db.query.parameter.<key> attributes to always emit the value as a string.
(#4395)
Fix SqlConnectionDetails to parse PostgreSQL data source URIs correctly.
(#4444)
Updated OpenTelemetry core component version(s) to 1.16.0.
(#4487)
Fix IndexOutOfRangeException when parsing SQL statements.
Fix incorrect db.query.summary when table names include a schema and are enclosed in brackets (e.g. [dbo].[Person]).
Released 2026-Mar-04
db.query.summary when table names include a schema and are
enclosed in brackets (e.g. [dbo].[Person]).
(#3897)Released 2026-Jan-28
Released 2026-Jan-28
Released 2022-Feb-02
Released 2022-Feb-02
Removes .NET Framework 4.5.2 support. The minimum .NET Framework version supported is .NET 4.6.1.
Released 2021-Oct-08
Released 2021-Jul-12
Released 2021-Jul-12
Released 2021-Jun-25
Released 2021-Jun-25
Released 2021-Jun-09
Released 2021-Jun-09
Instrumentation modified to depend only on the API.
Released 2021-Apr-23
Instrumentation modified to depend only on the API.
Activities are now created with the db.system attribute set for usage during
sampling.
(#1979)
Released 2021-Mar-19
Released 2021-Mar-19
Microsoft.Data.SqlClient v2.0.0 and higher is now properly instrumented on .NET Framework.
Released 2021-Jan-29
Microsoft.Data.SqlClient v2.0.0 and higher is now properly instrumented on .NET Framework. (#1599)
SqlClientInstrumentationOptions API changes: SetStoredProcedureCommandName
and SetTextCommandContent have been renamed to
SetDbStatementForStoredProcedure and SetDbStatementForText. They are now
only available on .NET Core. On .NET Framework they are replaced by a single
SetDbStatement property.
On .NET Framework, "db.statement_type" attribute is no longer set for activities created by the instrumentation.
New setting on SqlClientInstrumentationOptions on .NET Core: RecordException
can be set to instruct the instrumentation to record SqlExceptions as Activity
events.
(#1592)
Released 2022-Mar-04
Released 2022-Mar-04
One column per quarter.