Enable SDK Stats and route to the SDK Stats ingestion endpoint

[JacksonWeber]

Summary

Re-enables the SDK Stats manager (createStatsMgr) and routes its events to the distro-owned SDK Stats ingestion endpoint used by opentelemetry-distro-dotnet, instead of piggy-backing on the customer's breeze endpoint.

Endpoints (from Azure/azure-sdk-for-net StatsbeatConstants.cs + the .NET distro)

• Non-EU -> https://stats.monitor.azure.com/v2/track
• EU -> https://eu.stats.monitor.azure.com/v2/track
• Placeholder iKey 00000000-0000-0000-0000-000000000000, same Breeze envelope, no auth. EU vs non-EU chosen from the customer endpoint region.

Configurable Destination (new stats.monitor endpoint vs. legacy breeze)

The SDK Stats destination is now selectable at runtime via the CDN / dynamic config:

• New config field config.stats (IStatsBeatConfig), overridable via the CDN / cfgSync dynamic config.
• config.stats.mode (eStatsEndpointType): SdkStats (default) sends to stats.monitor.azure.com / eu.stats.monitor.azure.com; Breeze sends to the legacy breeze endpoint (the customer's own breeze host, using the Microsoft-owned SDK Stats iKey c4a29126… / 7dc56bab… by region).
• The destination iKey and ingestion endpoint are resolved per-event in _track from the live config, so CDN changes take effect at runtime. A full endCfg key map (with explicit key and new url) can also be supplied via config.stats.endCfg to fully override routing.

Note: in Breeze mode the events flow through the normal channel to the customer's breeze endpoint (legacy behaviour); in SdkStats mode they bypass the customer buffer and are excluded from request counting.

Changes

• StatsBeat.ts — SDK Stats endpoint constants, EU/non-EU region detection (getStatsEndpoint), per-event destination + placeholder-iKey stamping, enabled-by-default feature gate (opt-out via featureOptIn: "sdkStats"), createSdkStatsMgrConfig() helper, and configurable mode + key map support.
• AppInsightsCore.ts / IAppInsightsCore.ts / index.ts — restore getStatsBeat/setStatsMgr, fields, unload cleanup, stubs, interface methods, and exports.
• Sender.ts — restore request-counting hooks + statsBeatData; redirect SDK Stats items to the SDK Stats endpoint via a per-item URL override on _doSend/_getPayload, bypassing the customer buffer; SDK Stats sends are excluded from counting (no feedback loop); optimized property access for minification efficiency.
• AISku.ts — create + init + set the manager after core init (kept out of core/AISKULight for bundle size).
• IConfiguration.ts — added stats?: IStatsBeatConfig field for dynamic config.
• StatsType.ts — added eStatsEndpointType enum (SdkStats / Breeze).
• IStatsBeat.ts — added IStatsBeatConfig.mode and IStatsBeatKeyMap.url fields.
• Tests — re-enabled all SDK Stats unit tests (StatsBeat.Tests.ts in both core and channel-js), fixed import paths, updated terminology from "statsbeat" to "SDK Stats" in test names and assertions.

Architecture note

createStatsMgr lives in core, which cannot depend on the channel's Breeze EnvelopeCreator. So SDK Stats events flow through _core.track() (reusing the channel's envelope creation) and the redirect to the SDK Stats endpoint happens in the Sender via a per-item endpoint override.

Verification

• Verified with tsc --noEmit from source using the repo's exact compiler settings — core, channel, and AISKU compile with 0 errors.
• Reviewed for minification efficiency — no spread operators, optional chaining, or nullish coalescing; optimized repeated property access.
• Unit tests uncommented and updated with proper terminology.

Follow-ups (left for review)

• Update bundle-size test thresholds (AISKULightSize, AppInsightsCoreSize) if needed.
• Run npm run lint-fix + npm run fullCleanBuild before marking ready (requires environment outside VS Code due to Rush/ESLint plugin version conflicts).

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

[Copilot]

Pull request overview

This PR re-enables the SDK Stats (StatsBeat) manager in the Application Insights JavaScript SDK and adds support for routing SDK Stats telemetry to a distro-owned ingestion endpoint (EU vs non-EU), rather than piggy-backing on the customer’s Breeze endpoint. It introduces a runtime-selectable destination mode via config/dynamic config, restores core APIs for stats manager access, and updates the Sender channel to redirect per-item sends when the SDK Stats endpoint override marker is present.

Changes:

• Added SDK Stats endpoint + iKey resolution (EU vs non-EU), plus configurable routing mode (SDK Stats endpoint vs legacy Breeze) and per-event destination stamping.
• Restored core APIs (getStatsBeat / setStatsMgr) and exports to support enabling SDK Stats from AISKU without increasing core bundle size.
• Updated Sender to detect SDK Stats endpoint overrides, bypass the customer buffer for SDK Stats sends, and re-enabled associated unit tests.

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
shared/AppInsightsCore/Tests/Unit/src/aiunittests.ts	Re-enabled SDK Stats unit test suite execution.
shared/AppInsightsCore/Tests/Unit/src/ai/StatsBeat.Tests.ts	Re-enabled and updated core SDK Stats unit tests.
shared/AppInsightsCore/src/interfaces/ai/IStatsBeat.ts	Added SDK Stats routing config surface (mode, per-keymap url).
shared/AppInsightsCore/src/interfaces/ai/IConfiguration.ts	Added stats?: IStatsBeatConfig for runtime/dynamic config control.
shared/AppInsightsCore/src/interfaces/ai/IAppInsightsCore.ts	Restored getStatsBeat / setStatsMgr APIs on the core interface.
shared/AppInsightsCore/src/index.ts	Re-exported SDK Stats enums, interfaces, and core helper APIs/constants.
shared/AppInsightsCore/src/enums/ai/StatsType.ts	Added eStatsEndpointType / StatsEndpointType for routing mode selection.
shared/AppInsightsCore/src/core/StatsBeat.ts	Implemented SDK Stats endpoint/iKey resolution, routing mode support, and default manager config helper.
shared/AppInsightsCore/src/core/AppInsightsCore.ts	Restored core state + lifecycle cleanup for stats manager / stats beat instance.
channels/applicationinsights-channel-js/Tests/Unit/src/StatsBeat.tests.ts	Re-enabled channel-level SDK Stats tests for Sender request counting / emission.
channels/applicationinsights-channel-js/Tests/Unit/src/aichannel.tests.ts	Re-enabled channel SDK Stats tests in the channel test runner.
channels/applicationinsights-channel-js/src/Sender.ts	Added per-item SDK Stats endpoint override handling + direct send path, and restored request counting hooks.
AISKU/src/AISku.ts	Enabled SDK Stats from AISKU after core init via createSdkStatsMgrConfig().