Released 2024-Dec-09
-
Drop support for .NET 6 as this target is no longer supported. (#2159)
-
The new database semantic conventions can be opted in to by setting the
OTEL_SEMCONV_STABILITY_OPT_IN
environment variable. This allows for a transition period for users to experiment with the new semantic conventions and adapt as necessary. The environment variable supports the following values:database
- emit the new, frozen (proposed for stable) database attributes, and stop emitting the old experimental database attributes that the instrumentation emitted previously.database/dup
- emit both the old and the frozen (proposed for stable) database attributes, allowing for a more seamless transition.- The default behavior (in the absence of one of these values) is to continue emitting the same database semantic conventions that were emitted in the previous version.
- Note: this option will be be removed after the new database semantic conventions is marked stable. At which time this instrumentation can receive a stable release, and the old database semantic conventions will no longer be supported. Refer to the specification for more information regarding the new database semantic conventions for spans. (#2229, #2277, #2262, #2279)
-
Breaking change: The
peer.service
andserver.socket.address
attributes are no longer emitted. Users should rely on theserver.address
attribute for the same information. Note thatserver.address
is only included when theEnableConnectionLevelAttributes
option is enabled. (#2229) -
Breaking change: When
EnableConnectionLevelAttributes
is enabled, theserver.port
attribute will now be written as an integer to be compliant with the semantic conventions. Previously, it was written as a string. (#2233) -
The
EnableConnectionLevelAttributes
option is now enabled by default. (#2249) -
The following attributes are now provided when starting an activity for a database call:
db.system
,db.name
(old conventions),db.namespace
(new conventions),server.address
, andserver.port
. These attributes are now available for sampling decisions. (#2277) -
Breaking change: The
SetDbStatementForStoredProcedure
option has been removed. (#2284) -
Add support for metric
db.client.operation.duration
from new database semantic conventions on .NET 8+. (#2309) -
Add support for metric
db.client.operation.duration
from new database semantic conventions on .NET Framework. (#2311)- Only the following attributes are available when a trace is not captured:
db.system
,db.response.status_code
, anderror.type
- Only the following attributes are available when a trace is not captured:
-
Updated OpenTelemetry core component version(s) to
1.10.0
. (#2317)
Released 2024-Jun-17
-
ActivitySource.Version
is set to NuGet package version. (#5498) -
Updated OpenTelemetry core component version(s) to
1.9.0
. (#1888)
Released 2024-Apr-04
Released 2024-Feb-09
-
Removed support for the
OTEL_SEMCONV_STABILITY_OPT_IN
environment variable which toggled the use of the new conventions for the server, client, and shared network attributes. Now that this suite of attributes are stable, this instrumentation will only emit the new attributes. (#5270) -
Breaking Change: Renamed
SqlClientInstrumentationOptions
toSqlClientTraceInstrumentationOptions
. (#5285) -
Breaking Change: Stop emitting
db.statement_type
attribute. This attribute was never a part of the semantic conventions. (#5301)
Released 2023-Nov-17
- Updated
Microsoft.Extensions.Configuration
andMicrosoft.Extensions.Options
package version to8.0.0
. (#5051)
Released 2023-Oct-26
Released 2023-Jul-20
- The new network semantic conventions can be opted in to by setting
the
OTEL_SEMCONV_STABILITY_OPT_IN
environment variable. This allows for a transition period for users to experiment with the new semantic conventions and adapt as necessary. The environment variable supports the following values:http
- emit the new, frozen (proposed for stable) networking attributes, and stop emitting the old experimental networking attributes that the instrumentation emitted previously.http/dup
- emit both the old and the frozen (proposed for stable) networking attributes, allowing for a more seamless transition.- The default behavior (in the absence of one of these values) is to continue
emitting the same network semantic conventions that were emitted in
1.5.0-beta.1
. - Note: this option will eventually be removed after the new network semantic conventions are marked stable. Refer to the specification for more information regarding the new network semantic conventions for spans. (#4644)
Released 2023-Jun-05
- Bumped the package version to
1.5.0-beta.1
to keep its major and minor version in sync with that of the core packages. This would make it more intuitive for users to figure out what version of core packages would work with a given version of this package. The pre-release identifier has also been changed fromrc
tobeta
as we believe this more accurately reflects the status of this package. We believe therc
identifier will be more appropriate as semantic conventions reach stability.
Released 2023-Feb-24
- Updated OpenTelemetry.Api.ProviderBuilderExtensions dependency to 1.4.0
Released 2023-Feb-10
Released 2023-Feb-01
Released 2023-Jan-09
Released 2022-Dec-12
-
Breaking change: The same API is now exposed for
net462
andnetstandard2.0
targets.SetDbStatement
has been removed. UseSetDbStatementForText
to capture command text and stored procedure names on .NET Framework. Note:Enrich
,Filter
,RecordException
, andSetDbStatementForStoredProcedure
options are NOT supported on .NET Framework. (#3900) -
Added overloads which accept a name to the
TracerProviderBuilder
AddSqlClientInstrumentation
extension to allow for more fine-grained options management (#3994)
Released 2022-Nov-07
Released 2022-Oct-17
-
Use
Activity.Status
andActivity.StatusDescription
properties instead ofOpenTelemetry.Trace.Status
andOpenTelemetry.Trace.Status.Description
respectively to set activity status. (#3118) (#3751) -
Add support for Filter option for non .NET Framework Targets (#3743)
Released 2022-Sep-29
Released 2022-Aug-18
Released 2022-Aug-02
- Update the
ActivitySource.Name
from "OpenTelemetry.SqlClient" to "OpenTelemetry.Instrumentation.SqlClient". (#3435)
Released 2022-Jun-03
Released 2022-Apr-15
- Removes .NET Framework 4.6.1. The minimum .NET Framework version supported is .NET 4.6.2. (#3190)
Released 2022-Apr-12
Released 2022-Mar-30
Released 2022-Mar-04
Released 2022-Feb-02
Released 2021-Oct-08
- Removes .NET Framework 4.5.2 support. The minimum .NET Framework version supported is .NET 4.6.1. (#2138)
Released 2021-Jul-12
Released 2021-Jun-25
Released 2021-Jun-09
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-Jan-29
-
Microsoft.Data.SqlClient v2.0.0 and higher is now properly instrumented on .NET Framework. (#1599)
-
SqlClientInstrumentationOptions API changes:
SetStoredProcedureCommandName
andSetTextCommandContent
have been renamed toSetDbStatementForStoredProcedure
andSetDbStatementForText
. They are now only available on .NET Core. On .NET Framework they are replaced by a singleSetDbStatement
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 2020-Nov-17
- SqlInstrumentation sets ActivitySource to activities created outside ActivitySource. (#1515)
Released 2020-Nov-5
Released 2020-Oct-16
-
Instrumentation no longer store raw objects like
object
in Activity.CustomProperty. To enrich activity, use the Enrich action on the instrumentation. (#1261) -
Span Status is populated as per new spec (#1313)
Released 2020-Sep-15
Released 2020-08-28
-
.NET Core SqlClient instrumentation will now add the raw Command object to the Activity it creates (#1099)
-
Renamed from
AddSqlClientDependencyInstrumentation
toAddSqlClientInstrumentation
Released 2020-07-24
- First beta release
Released 2020-07-23
- Initial release