Oracle.ManagedDataAccess.OpenTelemetry 23.3.2-dev

Prefix Reserved
.NET Standard 2.1 This package targets .NET Standard 2.1. The package is compatible with this framework or higher. .NET Framework 4.7.2 This package targets .NET Framework 4.7.2. The package is compatible with this framework or higher.
This is a prerelease version of Oracle.ManagedDataAccess.OpenTelemetry.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Oracle.ManagedDataAccess.OpenTelemetry --version 23.3.2-dev                

                    
                

            
NuGet\Install-Package Oracle.ManagedDataAccess.OpenTelemetry -Version 23.3.2-dev
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Oracle.ManagedDataAccess.OpenTelemetry" Version="23.3.2-dev" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Oracle.ManagedDataAccess.OpenTelemetry --version 23.3.2-dev                

                    
                

            
#r "nuget: Oracle.ManagedDataAccess.OpenTelemetry, 23.3.2-dev"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Oracle.ManagedDataAccess.OpenTelemetry as a Cake Addin
#addin nuget:?package=Oracle.ManagedDataAccess.OpenTelemetry&version=23.3.2-dev&prerelease

// Install Oracle.ManagedDataAccess.OpenTelemetry as a Cake Tool
#tool nuget:?package=Oracle.ManagedDataAccess.OpenTelemetry&version=23.3.2-dev&prerelease

Oracle Logo

Oracle.ManagedDataAccess.OpenTelemetry 23.3.2-dev

Release Notes for Oracle Data Provider for .NET Extension for OpenTelemetry NuGet Package

March 2024

This NuGet package supports OpenTelemetry for both managed ODP.NET and ODP.NET Core.

This document provides information that supplements the Oracle Data Provider for .NET (ODP.NET) documentation.

New Features

  • OracleDataProviderInstrumentationOptions.EnableDBRoundTripTracing (Boolean Property)

    • This option controls the instrumentation of database/server round trip calls of instrumented methods.
    • If user set this option to false, database round trip calls will not be traced.
    • By default, this property is set to true.

  • OracleDataProviderInstrumentationOptions.RequireApplicationRootSpanCreation (Boolean Property)

    • This option controls whether ODP.NET instruments only those operations that are assocociated with root spans created by the application or not.
    • By default, this property is set to false, which means that ODP.NET will instrument operation regardless of whether the application creates the root span or not.
    • But if this property is set to true, ODP.NET will only instrument operations associated with root spans that are created by the application.

  • OracleDataProviderInstrumentationOptions.EnableOpenCloseTracing (EnableOpenCloseTracing Enum Property)

    • This option controls whether Open(), Close(), and OpenAsync() methods on the OracleConnection objects get instrumented.
    • Possible settings are
      • EnableOpenCloseTracing.None : No instrumentation for open/close
      • EnableOpenCloseTracing.HardOpenCloseOnly : Instrumentation for hard open/close only
      • EnableOpenCloseTracing.AllOpenClose : Instrumentation for all both soft + hard open/close
    • In order to instrument hard open/close, EnableDBRoundTripTracing option has to be set to true
    • By default, this property is set to EnableOpenCloseTracing.None.

  • Automatic Instrumentation and Dynamic Enablement

    • ODP.NET adds new OpenTelemetry automatic instrumentation support that delivers traces to observability backends without requiring source code changes. ODP.NET OpenTelemetry is now enabled automatically. It no longer requires adding Oracle.ManagedDataAccess.OpenTelemetry NuGet package nor calling AddOracleDataProviderInstrumentation() extension method to enable OpenTelemetry.
    • ODP.NET OpenTelemetry is now enabled by default. It can be turned off or on by setting OracleConfiguration.OpenTelemetryTracing to false or true, respectively. It can also be set in the OpenTelemetryTracing .NET configuration file setting for .NET Framework.
    • Note: The ODP.NET activity source name is "Oracle.ManagedDataAccess.Core" for ODP.NET Core and "Oracle.ManagedDataAccess" for managed ODP.NET

Bug Fixes since Oracle.ManagedDataAccess.OpenTelemetry 23.2.0-dev

  • Bug 35711064 - DOCUMENTATION IS NOT CLEAR THAT THIS NUGET PACKAGE CAN BE USED WITH BOTH MANAGED ODP.NET AND ODP.NET CORE

Copyright (c) 2024, Oracle and/or its affiliates.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Oracle.ManagedDataAccess.OpenTelemetry:

Package Downloads
Aspire.Oracle.EntityFrameworkCore

An Oracle Database provider for Entity Framework Core that integrates with Aspire, including connection pooling, health check, logging, and telemetry.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Oracle.ManagedDataAccess.OpenTelemetry:

Repository Stars
dotnet/aspire
Tools, templates, and packages to accelerate building observable, production-ready apps
Version Downloads Last updated
23.6.0 12,638 10/2/2024
23.5.0 49,784 7/11/2024
23.4.0 25,794 5/2/2024
23.3.2-dev 4,116 3/12/2024
23.3.0-dev 11,701 12/12/2023
23.2.0-dev 21,873 7/29/2023