👁 Image
Datadog.FeatureFlags.OpenFeature 2.3.0

Datadog.FeatureFlags.OpenFeature NuGet package

This package contains the OpenFeature provider for Datadog .NET Feature Flags Events platform (FFE).

What does Datadog.Trace.OpenFeature contain?

Datadog.Trace.OpenFeature contains two things:

• A reference to the OpenFeature v2 NuGet package for custom instrumentation.
• The native binaries required for automatic instrumentation, for the Continuous Profiler, and for ASM.

These native binaries are identical to those installed by the MSI and Linux installer packages, so Datadog.Trace.Bundle should be considered an alternative deployment mechanism for automatic instrumentation.

The main advantages of Datadog.Trace.Bundle over the MSI or Linux packages are:

• You can use it in locations where you cannot access the underlying host to install the MSI or Linux package.
• You can have multiple applications on the same host using different versions of Datadog.Trace.Bundle without issue.

Getting Started

1. Configure the Datadog agent for APM as described in our documentation.
2. Configure the tracer as shown in the next section
3. Configure the Datadog OpenFeature SDK as described in our documentation.
   1. Add the Datadog.FeatureFlags.OpenFeature NuGet package to your project, using dotnet add package Datadog.FeatureFlags.OpenFeature, for example.
   2. Add the Datadog.FeatureFlags.OpenFeature.DatadogProvider to the OpenFeature.Api.Instance.
4. Use the OpenFeature.FeatureClient to retrieve configured feature flags from Datadog's backend.
5. View your live data on Datadog.

Configure the tracer

After adding the NuGet package to your project, set the following required environment variables to enable automatic instrumentation of your application and restart the application.

NOTE: The following are the mandatory variables. For further configuration options, see our public documentation for the Tracer and the Continuous Profiler.

.NET Core:

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
CORECLR_PROFILER_PATH=<System-dependent path>
DD_DOTNET_TRACER_HOME=<APP_DIRECTORY>/datadog

.NET Framework:

COR_ENABLE_PROFILING=1
COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
COR_PROFILER_PATH=<System-dependent path>
DD_DOTNET_TRACER_HOME=<APP_DIRECTORY>/datadog

The value for the <APP_DIRECTORY> placeholder is the path to the directory containing the application’s .dll files. The value for the CORECLR_PROFILER_PATH/COR_PROFILER_PATH environment variable varies based on the system where the application is running:

For Docker images running on Linux, configure the image to run the createLogPath.sh script:

RUN /<APP_DIRECTORY>/datadog/createLogPath.sh

Examples

Docker examples are available here

Get in touch

If you have questions, feedback, or feature requests, reach our support.