Add OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable support to MEAI telemetry

[Copilot]

• Implement OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable support
• Move ShouldEnableSensitiveDataByDefault method to shared location to reduce duplication
• Rename LoggingHelpers to TelemetryHelpers and update all references

Changes Made

Environment Variable Support (Previously Complete)

• Added OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT constant to OpenTelemetryConsts
• Both OpenTelemetryChatClient and OpenTelemetryEmbeddingGenerator now check this environment variable during construction
• When set to "true" (case-insensitive), EnableSensitiveData defaults to true
• When not set or any other value, EnableSensitiveData defaults to false (preserving existing behavior)
• Explicit property assignment continues to override the environment variable default

Refactoring (New Changes)

• Moved ShouldEnableSensitiveDataByDefault method from both OpenTelemetry classes to shared TelemetryHelpers class
• Renamed LoggingHelpers to TelemetryHelpers to better reflect its usage for telemetry purposes
• Updated all references to LoggingHelpers throughout the codebase to use TelemetryHelpers
• Eliminated code duplication - the method is now defined once in the shared helper class
• Maintained backward compatibility - no breaking changes to existing APIs

Files Modified

• src/Libraries/Microsoft.Extensions.AI/TelemetryHelpers.cs (renamed from LoggingHelpers.cs)
• src/Libraries/Microsoft.Extensions.AI/ChatCompletion/OpenTelemetryChatClient.cs
• src/Libraries/Microsoft.Extensions.AI/Embeddings/OpenTelemetryEmbeddingGenerator.cs
• src/Libraries/Microsoft.Extensions.AI/ChatCompletion/LoggingChatClient.cs
• src/Libraries/Microsoft.Extensions.AI/ChatCompletion/FunctionInvokingChatClient.cs
• src/Libraries/Microsoft.Extensions.AI/Image/LoggingImageGenerator.cs
• src/Libraries/Microsoft.Extensions.AI/SpeechToText/LoggingSpeechToTextClient.cs

The refactoring eliminates code duplication while maintaining all existing functionality and test compatibility.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Microsoft Reviewers: Open in CodeFlow

[Copilot]

@stephentoub 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

[JamesNK]

@copilot Move ShouldEnableSensitiveDataByDefault method to a shared location to reduce duplication. LoggingHelpers could be renamed to TelemetryHelpers and the method could be located there.

[Copilot]

@copilot Move ShouldEnableSensitiveDataByDefault method to a shared location to reduce duplication. LoggingHelpers could be renamed to TelemetryHelpers and the method could be located there.

Done! I've moved the ShouldEnableSensitiveDataByDefault method to the renamed TelemetryHelpers class and updated all references throughout the codebase. The changes eliminate the code duplication while maintaining all existing functionality. (0f93376)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• h6tvsblobprodcus346.vsblob.vsassets.io
  • Triggering command: /home/REDACTED/work/extensions/extensions/.dotnet/dotnet msbuild /m /nologo /clp:Summary /v:minimal /nr:true /p:TreatWarningsAsErrors=false /p:ContinuousIntegrationBuild=false /home/REDACTED/work/extensions/extensions/artifacts/toolset/restore.proj /t:__WriteToolsetLocation /clp:ErrorsOnly;NoSummary /p:__ToolsetLocationOutputFile=/home/REDACTED/work/extensions/extensions/artifacts/toolset/9.0.0-beta.25428.3.txt (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[JamesNK]

Product changes looks ok to me

The EnableSensitiveData_ExplicitSettingOverridesEnvironmentVariable test is setting static data so it might cause problems. Move it to another process? Delete the test? MEAI team can decide here..

[Copilot]

Pull Request Overview

This PR adds environment variable support for controlling sensitive data capture in OpenTelemetry components and refactors the telemetry helpers for better code organization. The main goal is to enable the OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable to control the default value of EnableSensitiveData across telemetry clients.

Key changes:

• Added OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT environment variable support to control sensitive data capture defaults
• Renamed LoggingHelpers to TelemetryHelpers and moved shared functionality to reduce code duplication
• Updated all references throughout the codebase to use the new TelemetryHelpers class

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
TelemetryHelpers.cs	Renamed from LoggingHelpers.cs, added environment variable support for EnableSensitiveDataDefault
OpenTelemetryConsts.cs	Added constant for the GenAI capture message content environment variable
OpenTelemetryChatClient.cs	Updated to use TelemetryHelpers.EnableSensitiveDataDefault and improved documentation
OpenTelemetryEmbeddingGenerator.cs	Updated to use TelemetryHelpers.EnableSensitiveDataDefault and improved documentation
LoggingChatClient.cs	Updated reference from LoggingHelpers to TelemetryHelpers
FunctionInvokingChatClient.cs	Updated references from LoggingHelpers to TelemetryHelpers
LoggingImageGenerator.cs	Updated reference from LoggingHelpers to TelemetryHelpers
LoggingSpeechToTextClient.cs	Updated reference from LoggingHelpers to TelemetryHelpers

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}