@microsoft/opentelemetry 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,91 @@
+# @microsoft/opentelemetry
+
+Microsoft OpenTelemetry distribution for Node.js — one import, one call, full observability across Azure Monitor, OTLP-compatible backends, and A365.
+
+## Getting Started
+
+```bash
+npm install @microsoft/opentelemetry
+```
+
+```typescript
+import { useMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
+
+useMicrosoftOpenTelemetry({
+  azureMonitor: {
+    azureMonitorExporterOptions: {
+      connectionString: process.env.APPLICATIONINSIGHTS_CONNECTION_STRING,
+    },
+  },
+});
+```
+
+That's it — traces, metrics, and logs are collected automatically with built-in instrumentations for HTTP, databases, and more.
+
+## Configuration
+
+### `MicrosoftOpenTelemetryOptions`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `resource` | `Resource` | auto-detected | OpenTelemetry Resource (service name, version, etc.) |
+| `samplingRatio` | `number` | `1.0` | Ratio of telemetry items to transmit (0.0–1.0) |
+| `tracesPerSecond` | `number` | `5` | Max traces per second. Set to `0` to use `samplingRatio` instead |
+| `instrumentationOptions` | `InstrumentationOptions` | all enabled | Toggle built-in instrumentations (HTTP, MongoDB, MySQL, PostgreSQL, Redis, Azure SDK, Azure Functions, Winston, Bunyan, OpenAI Agents, LangChain) |
+| `spanProcessors` | `SpanProcessor[]` | — | Additional span processors |
+| `logRecordProcessors` | `LogRecordProcessor[]` | — | Additional log record processors |
+| `metricReaders` | `MetricReader[]` | — | Additional metric readers |
+| `views` | `ViewOptions[]` | — | Metric views |
+| `azureMonitor` | `AzureMonitorOpenTelemetryOptions` | — | Azure Monitor backend config (see below) |
+| `a365` | `A365Options` | — | A365 observability config |
+
+### `azureMonitor` options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `azureMonitorExporterOptions` | `AzureMonitorExporterOptions` | — | Exporter config including `connectionString`, `storageDirectory`, `disableOfflineStorage` |
+| `enableLiveMetrics` | `boolean` | `true` | Enable Live Metrics streaming |
+| `enableStandardMetrics` | `boolean` | `true` | Enable standard metrics collection |
+| `enableTraceBasedSamplingForLogs` | `boolean` | `false` | Enable log sampling based on trace |
+| `enablePerformanceCounters` | `boolean` | `true` | Enable performance counter collection |
+| `browserSdkLoaderOptions` | `BrowserSdkLoaderOptions` | — | Application Insights browser SDK loader config |
+
+### OTLP via environment variables
+
+Set `OTEL_EXPORTER_OTLP_ENDPOINT` and OTLP export is enabled automatically — no code changes needed. Signal-specific variables (`OTEL_EXPORTER_OTLP_TRACES_ENDPOINT`, etc.) override the base endpoint.
+
+See the [OpenTelemetry OTLP Exporter specification](https://opentelemetry.io/docs/specs/otel/protocol/exporter/) for the full list.
+
+### Example
+
+```typescript
+import { useMicrosoftOpenTelemetry, shutdownMicrosoftOpenTelemetry } from "@microsoft/opentelemetry";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+
+useMicrosoftOpenTelemetry({
+  resource: resourceFromAttributes({ "service.name": "my-app" }),
+  samplingRatio: 0.5,
+  azureMonitor: {
+    azureMonitorExporterOptions: {
+      connectionString: process.env.APPLICATIONINSIGHTS_CONNECTION_STRING,
+    },
+    enableLiveMetrics: true,
+  },
+});
+
+// On shutdown
+await shutdownMicrosoftOpenTelemetry();
+```
+
+## Samples
+
+See the [samples/](./samples/) directory for working TypeScript examples covering connection setup, custom metrics, custom traces, sampling, OTLP dual-export, and more.
+
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/commonjs/_a365/configuration/A365Configuration.d.ts

@@ -0,0 +1,42 @@
+import type { A365Options, ClusterCategory, A365BaggageOptions, A365HostingOptions } from "./A365ConfigurationOptions.js";
+/**
+ * Environment variable names for A365 configuration.
+ * These follow the MICROSOFT_OTEL_A365_* convention defined in PLANNING.md.
+ */
+export declare const A365_ENV_VARS: {
+    readonly EXPORTER_ENABLED: "MICROSOFT_OTEL_A365_EXPORTER_ENABLED";
+    readonly PER_REQUEST_EXPORT: "MICROSOFT_OTEL_A365_PER_REQUEST_EXPORT";
+    readonly AUTH_SCOPES: "MICROSOFT_OTEL_A365_AUTH_SCOPES";
+    readonly DOMAIN: "MICROSOFT_OTEL_A365_DOMAIN";
+    readonly CLUSTER_CATEGORY: "MICROSOFT_OTEL_A365_CLUSTER_CATEGORY";
+};
+/**
+ * Resolved A365 configuration.
+ *
+ * Merges values from four sources (lowest to highest precedence):
+ *   1. Defaults
+ *   2. Programmatic options (`A365Options`)
+ *   3. JSON config (`applicationinsights.json` → `a365` key)
+ *   4. Environment variables (`MICROSOFT_OTEL_A365_*`)
+ */
+export declare class A365Configuration {
+    /** Whether A365 observability is enabled. */
+    readonly enabled: boolean;
+    /** Token resolver callback for A365 service authentication. */
+    readonly tokenResolver?: (agentId: string, tenantId: string) => string | Promise<string>;
+    /** Cluster category. */
+    readonly clusterCategory: ClusterCategory;
+    /** Domain override for the A365 observability service. */
+    readonly domainOverride?: string;
+    /** OAuth scopes for A365 service authentication. */
+    readonly authScopes: string[];
+    /** Whether to use per-request export mode. */
+    readonly perRequestExport: boolean;
+    /** Baggage options. */
+    readonly baggage: Required<A365BaggageOptions>;
+    /** Hosting options. */
+    readonly hosting: Required<A365HostingOptions>;
+    constructor(options?: A365Options);
+    private _warnIfOptionsSetButDisabled;
+}
+//# sourceMappingURL=A365Configuration.d.ts.map

package/dist/commonjs/_a365/configuration/A365Configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"A365Configuration.d.ts","sourceRoot":"","sources":["../../../../src/_a365/configuration/A365Configuration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AAKvC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAmBX;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,6CAA6C;IAC7C,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,+DAA+D;IAC/D,SAAgB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhG,wBAAwB;IACxB,SAAgB,eAAe,EAAE,eAAe,CAAC;IAEjD,0DAA0D;IAC1D,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExC,oDAAoD;IACpD,SAAgB,UAAU,EAAE,MAAM,EAAE,CAAC;IAErC,8CAA8C;IAC9C,SAAgB,gBAAgB,EAAE,OAAO,CAAC;IAE1C,uBAAuB;IACvB,SAAgB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAEtD,uBAAuB;IACvB,SAAgB,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBAE1C,OAAO,CAAC,EAAE,WAAW;IAkFjC,OAAO,CAAC,4BAA4B;CAgBrC"}

package/dist/commonjs/_a365/configuration/A365Configuration.js

@@ -0,0 +1,146 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A365Configuration = exports.A365_ENV_VARS = void 0;
+const utils_js_1 = require("../utils/utils.js");
+const index_js_1 = require("../../shared/logging/index.js");
+const jsonConfig_js_1 = require("../../shared/jsonConfig.js");
+/**
+ * Environment variable names for A365 configuration.
+ * These follow the MICROSOFT_OTEL_A365_* convention defined in PLANNING.md.
+ */
+exports.A365_ENV_VARS = {
+    EXPORTER_ENABLED: "MICROSOFT_OTEL_A365_EXPORTER_ENABLED",
+    PER_REQUEST_EXPORT: "MICROSOFT_OTEL_A365_PER_REQUEST_EXPORT",
+    AUTH_SCOPES: "MICROSOFT_OTEL_A365_AUTH_SCOPES",
+    DOMAIN: "MICROSOFT_OTEL_A365_DOMAIN",
+    CLUSTER_CATEGORY: "MICROSOFT_OTEL_A365_CLUSTER_CATEGORY",
+};
+const DEFAULT_AUTH_SCOPE = "https://api.powerplatform.com/.default";
+const VALID_CLUSTER_CATEGORIES = new Set([
+    "local",
+    "dev",
+    "test",
+    "preprod",
+    "firstrelease",
+    "prod",
+    "gov",
+    "high",
+    "dod",
+    "mooncake",
+    "ex",
+    "rx",
+]);
+/**
+ * Resolved A365 configuration.
+ *
+ * Merges values from four sources (lowest to highest precedence):
+ *   1. Defaults
+ *   2. Programmatic options (`A365Options`)
+ *   3. JSON config (`applicationinsights.json` → `a365` key)
+ *   4. Environment variables (`MICROSOFT_OTEL_A365_*`)
+ */
+class A365Configuration {
+    /** Whether A365 observability is enabled. */
+    enabled;
+    /** Token resolver callback for A365 service authentication. */
+    tokenResolver;
+    /** Cluster category. */
+    clusterCategory;
+    /** Domain override for the A365 observability service. */
+    domainOverride;
+    /** OAuth scopes for A365 service authentication. */
+    authScopes;
+    /** Whether to use per-request export mode. */
+    perRequestExport;
+    /** Baggage options. */
+    baggage;
+    /** Hosting options. */
+    hosting;
+    constructor(options) {
+        // 1. Set defaults
+        let enabled = false;
+        let clusterCategory = "prod";
+        let domainOverride = options?.domainOverride;
+        let authScopes = options?.authScopes ?? [DEFAULT_AUTH_SCOPE];
+        let perRequestExport = false;
+        // 2. Apply programmatic options
+        if (options) {
+            enabled = options.enabled ?? enabled;
+            clusterCategory = options.clusterCategory ?? clusterCategory;
+            perRequestExport = options.perRequestExport ?? perRequestExport;
+        }
+        // 3. Apply JSON config (takes precedence over programmatic options)
+        const jsonA365 = jsonConfig_js_1.JsonConfig.getInstance().a365;
+        if (jsonA365) {
+            enabled = jsonA365.enabled ?? enabled;
+            clusterCategory = jsonA365.clusterCategory ?? clusterCategory;
+            domainOverride = jsonA365.domainOverride ?? domainOverride;
+            perRequestExport = jsonA365.perRequestExport ?? perRequestExport;
+            if (jsonA365.authScopes) {
+                authScopes = jsonA365.authScopes;
+            }
+        }
+        // 4. Apply environment variable overrides (highest precedence)
+        if ((0, utils_js_1.getEnv)(exports.A365_ENV_VARS.EXPORTER_ENABLED) === "true") {
+            enabled = true;
+        }
+        else if ((0, utils_js_1.getEnv)(exports.A365_ENV_VARS.EXPORTER_ENABLED) === "false") {
+            enabled = false;
+        }
+        if ((0, utils_js_1.getEnv)(exports.A365_ENV_VARS.PER_REQUEST_EXPORT) === "true") {
+            perRequestExport = true;
+        }
+        else if ((0, utils_js_1.getEnv)(exports.A365_ENV_VARS.PER_REQUEST_EXPORT) === "false") {
+            perRequestExport = false;
+        }
+        const envScopes = (0, utils_js_1.getEnv)(exports.A365_ENV_VARS.AUTH_SCOPES);
+        if (envScopes) {
+            authScopes = envScopes
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        const envDomain = (0, utils_js_1.getEnv)(exports.A365_ENV_VARS.DOMAIN);
+        if (envDomain) {
+            domainOverride = envDomain;
+        }
+        const envCluster = (0, utils_js_1.getEnv)(exports.A365_ENV_VARS.CLUSTER_CATEGORY);
+        if (envCluster && VALID_CLUSTER_CATEGORIES.has(envCluster)) {
+            clusterCategory = envCluster;
+        }
+        // Assign resolved values
+        this.enabled = enabled;
+        this.tokenResolver = options?.tokenResolver;
+        this.clusterCategory = clusterCategory;
+        this.domainOverride = domainOverride;
+        this.authScopes = authScopes;
+        this.perRequestExport = perRequestExport;
+        this.baggage = {
+            propagationEnabled: jsonA365?.baggage?.propagationEnabled ?? options?.baggage?.propagationEnabled ?? true,
+            enrichSpans: jsonA365?.baggage?.enrichSpans ?? options?.baggage?.enrichSpans ?? true,
+        };
+        this.hosting = {
+            enabled: jsonA365?.hosting?.enabled ?? options?.hosting?.enabled ?? false,
+        };
+        // Warn when A365-scoped options are set but A365 is not enabled
+        if (!this.enabled) {
+            this._warnIfOptionsSetButDisabled(options);
+        }
+    }
+    _warnIfOptionsSetButDisabled(options) {
+        if (!options)
+            return;
+        const hasNonTrivialOptions = options.tokenResolver !== undefined ||
+            options.domainOverride !== undefined ||
+            options.perRequestExport !== undefined ||
+            options.hosting?.enabled === true;
+        if (hasNonTrivialOptions) {
+            index_js_1.Logger.getInstance().warn("A365 configuration options are set but A365 is not enabled. " +
+                "Set `a365.enabled: true` or `MICROSOFT_OTEL_A365_EXPORTER_ENABLED=true` to enable.");
+        }
+    }
+}
+exports.A365Configuration = A365Configuration;
+//# sourceMappingURL=A365Configuration.js.map

package/dist/commonjs/_a365/configuration/A365Configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A365Configuration.js","sourceRoot":"","sources":["../../../../src/_a365/configuration/A365Configuration.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/_a365/configuration/A365ConfigurationOptions.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cluster categories for A365 service endpoint resolution.
+ * Mirrors the ClusterCategory enum from Agent365-nodejs.
+ */
+export type ClusterCategory = "local" | "dev" | "test" | "preprod" | "firstrelease" | "prod" | "gov" | "high" | "dod" | "mooncake" | "ex" | "rx";
+/**
+ * A365 observability configuration options.
+ *
+ * These are the public-facing options passed via the `a365` scope
+ * of {@link MicrosoftOpenTelemetryOptions}.
+ */
+export interface A365Options {
+    /** Enable A365 observability. When false, no A365 components are created. */
+    enabled?: boolean;
+    /**
+     * Token resolver for authenticating with the A365 observability service.
+     * Called with (agentId, tenantId) extracted from span attributes.
+     * Must return a bearer token string or a promise resolving to one.
+     */
+    tokenResolver?: (agentId: string, tenantId: string) => string | Promise<string>;
+    /** Cluster category for the A365 service endpoint. */
+    clusterCategory?: ClusterCategory;
+    /** Override the A365 observability service domain. */
+    domainOverride?: string;
+    /** OAuth scopes for A365 service authentication. */
+    authScopes?: string[];
+    /**
+     * Use per-request export mode (buffer spans per trace, export on root completion).
+     * When false, uses standard batch export.
+     * @default false
+     */
+    perRequestExport?: boolean;
+    /** Baggage propagation and span enrichment options. */
+    baggage?: A365BaggageOptions;
+    /** Hosting middleware options (requires @microsoft/agents-hosting). */
+    hosting?: A365HostingOptions;
+}
+/** Baggage propagation and span enrichment options. */
+export interface A365BaggageOptions {
+    /** Enable baggage propagation from request headers to span context. */
+    propagationEnabled?: boolean;
+    /** Copy baggage items to span attributes. */
+    enrichSpans?: boolean;
+}
+/** Hosting middleware options. */
+export interface A365HostingOptions {
+    /**
+     * Enable hosting middleware integration (baggage middleware, output logging, etc.).
+     * Requires `@microsoft/agents-hosting` as an optional peer dependency.
+     */
+    enabled?: boolean;
+}
+//# sourceMappingURL=A365ConfigurationOptions.d.ts.map

package/dist/commonjs/_a365/configuration/A365ConfigurationOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"A365ConfigurationOptions.d.ts","sourceRoot":"","sources":["../../../../src/_a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,cAAc,GACd,MAAM,GACN,KAAK,GACL,MAAM,GACN,KAAK,GACL,UAAU,GACV,IAAI,GACJ,IAAI,CAAC;AAET;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhF,sDAAsD;IACtD,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,uDAAuD;IACvD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B,uEAAuE;IACvE,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/commonjs/_a365/configuration/A365ConfigurationOptions.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=A365ConfigurationOptions.js.map

package/dist/commonjs/_a365/configuration/A365ConfigurationOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A365ConfigurationOptions.js","sourceRoot":"","sources":["../../../../src/_a365/configuration/A365ConfigurationOptions.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC"}

package/dist/commonjs/_a365/configuration/index.d.ts

@@ -0,0 +1,3 @@
+export { A365Configuration, A365_ENV_VARS } from "./A365Configuration.js";
+export type { A365Options, ClusterCategory, A365BaggageOptions, A365HostingOptions, } from "./A365ConfigurationOptions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/_a365/configuration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/_a365/configuration/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}

package/dist/commonjs/_a365/configuration/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A365_ENV_VARS = exports.A365Configuration = void 0;
+var A365Configuration_js_1 = require("./A365Configuration.js");
+Object.defineProperty(exports, "A365Configuration", { enumerable: true, get: function () { return A365Configuration_js_1.A365Configuration; } });
+Object.defineProperty(exports, "A365_ENV_VARS", { enumerable: true, get: function () { return A365Configuration_js_1.A365_ENV_VARS; } });
+//# sourceMappingURL=index.js.map

package/dist/commonjs/_a365/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/_a365/configuration/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,+DAA0E;AAAjE,yHAAA,iBAAiB,OAAA;AAAE,qHAAA,aAAa,OAAA"}

package/dist/commonjs/_a365/exporter/Agent365Exporter.d.ts

@@ -0,0 +1,25 @@
+import type { ExportResult } from "@opentelemetry/core";
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import type { Agent365ExporterOptions } from "./Agent365ExporterOptions.js";
+/**
+ * Agent365 span exporter.
+ *
+ * Implements `SpanExporter` from `@opentelemetry/sdk-trace-base`.
+ * Partitions spans by (tenantId, agentId), builds OTLP-like JSON payloads,
+ * and POSTs them to the Agent365 observability service with Bearer auth.
+ */
+export declare class Agent365Exporter implements SpanExporter {
+    private closed;
+    private readonly options;
+    private readonly logger;
+    constructor(options?: Agent365ExporterOptions);
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): Promise<void>;
+    private exportGroup;
+    private resolveToken;
+    private postWithRetries;
+    private buildExportRequest;
+    private mapSpan;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=Agent365Exporter.d.ts.map

package/dist/commonjs/_a365/exporter/Agent365Exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/_a365/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AA+D5E;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,OAAO,CAAC,EAAE,uBAAuB;IAIvC,MAAM,CACV,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,OAAO,CAAC,IAAI,CAAC;YAoCF,WAAW;YAmCX,YAAY;YAMZ,eAAe;IA0D7B,OAAO,CAAC,kBAAkB;IAwC1B,OAAO,CAAC,OAAO;IAwDT,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/commonjs/_a365/exporter/Agent365Exporter.js

@@ -0,0 +1,220 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent365Exporter = void 0;
+const core_1 = require("@opentelemetry/core");
+const Agent365ExporterOptions_js_1 = require("./Agent365ExporterOptions.js");
+const utils_js_1 = require("./utils.js");
+const index_js_1 = require("../../shared/logging/index.js");
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Agent365 span exporter.
+ *
+ * Implements `SpanExporter` from `@opentelemetry/sdk-trace-base`.
+ * Partitions spans by (tenantId, agentId), builds OTLP-like JSON payloads,
+ * and POSTs them to the Agent365 observability service with Bearer auth.
+ */
+class Agent365Exporter {
+    closed = false;
+    options;
+    logger = index_js_1.Logger.getInstance();
+    constructor(options) {
+        this.options = new Agent365ExporterOptions_js_1.ResolvedExporterOptions(options);
+    }
+    async export(spans, resultCallback) {
+        if (this.closed) {
+            resultCallback({ code: core_1.ExportResultCode.FAILED });
+            return;
+        }
+        try {
+            this.logger.info(`[Agent365Exporter] Exporting ${spans.length} spans`);
+            const groups = (0, utils_js_1.partitionByIdentity)(spans);
+            if (groups.size === 0) {
+                resultCallback({ code: core_1.ExportResultCode.SUCCESS });
+                return;
+            }
+            let anyFailure = false;
+            const promises = [];
+            for (const [identityKey, groupSpans] of groups) {
+                const promise = this.exportGroup(identityKey, groupSpans).catch((err) => {
+                    anyFailure = true;
+                    this.logger.error(`[Agent365Exporter] Error exporting group ${identityKey}:`, err);
+                });
+                promises.push(promise);
+            }
+            await Promise.all(promises);
+            resultCallback({
+                code: anyFailure ? core_1.ExportResultCode.FAILED : core_1.ExportResultCode.SUCCESS,
+            });
+        }
+        catch (err) {
+            this.logger.error("[Agent365Exporter] Export failed:", err);
+            resultCallback({ code: core_1.ExportResultCode.FAILED });
+        }
+    }
+    async exportGroup(identityKey, spans) {
+        const { tenantId, agentId } = (0, utils_js_1.parseIdentityKey)(identityKey);
+        const payload = this.buildExportRequest(spans);
+        const body = JSON.stringify(payload);
+        const endpointPath = this.options.useS2SEndpoint
+            ? `/observabilityService/tenants/${encodeURIComponent(tenantId)}/agents/${encodeURIComponent(agentId)}/traces`
+            : `/observability/tenants/${encodeURIComponent(tenantId)}/agents/${encodeURIComponent(agentId)}/traces`;
+        const baseUrl = this.options.domainOverride ?? (0, utils_js_1.resolveAgent365Endpoint)(this.options.clusterCategory);
+        const url = `${baseUrl}${endpointPath}?api-version=1`;
+        const headers = {
+            "content-type": "application/json",
+            "x-ms-tenant-id": tenantId,
+        };
+        // Resolve token
+        const token = await this.resolveToken(agentId, tenantId);
+        if (!token) {
+            this.logger.warn(`[Agent365Exporter] Skipping export for ${tenantId}/${agentId}: no token available`);
+            return;
+        }
+        headers["authorization"] = `Bearer ${token}`;
+        const { ok } = await this.postWithRetries(url, body, headers);
+        if (!ok) {
+            throw new Error(`Failed to export spans for ${tenantId}/${agentId}`);
+        }
+    }
+    async resolveToken(agentId, tenantId) {
+        if (!this.options.tokenResolver)
+            return null;
+        const result = this.options.tokenResolver(agentId, tenantId);
+        return result instanceof Promise ? result : result;
+    }
+    async postWithRetries(url, body, headers) {
+        let lastCorrelationId = "unknown";
+        for (let attempt = 0; attempt <= DEFAULT_MAX_RETRIES; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: AbortSignal.timeout(this.options.httpRequestTimeoutMilliseconds),
+                });
+                const correlationId = response.headers.get("x-ms-correlation-id") ??
+                    response.headers.get("x-correlation-id") ??
+                    "unknown";
+                lastCorrelationId = correlationId;
+                if (response.status >= 200 && response.status < 300) {
+                    return { ok: true, correlationId };
+                }
+                // Retry on transient errors
+                if ([408, 429].includes(response.status) ||
+                    (response.status >= 500 && response.status < 600)) {
+                    if (attempt < DEFAULT_MAX_RETRIES) {
+                        const sleepMs = 200 * (attempt + 1) + Math.floor(Math.random() * 100);
+                        this.logger.warn(`[Agent365Exporter] Transient error ${response.status}, retrying after ${sleepMs}ms`);
+                        await sleep(sleepMs);
+                        continue;
+                    }
+                }
+                this.logger.error(`[Agent365Exporter] Failed with status ${response.status}, correlation: ${correlationId}`);
+                return { ok: false, correlationId };
+            }
+            catch (error) {
+                this.logger.error("[Agent365Exporter] Request error:", error);
+                if (attempt < DEFAULT_MAX_RETRIES) {
+                    await sleep(200 * (attempt + 1));
+                    continue;
+                }
+                return { ok: false, correlationId: lastCorrelationId };
+            }
+        }
+        return { ok: false, correlationId: lastCorrelationId };
+    }
+    buildExportRequest(spans) {
+        const scopeMap = new Map();
+        for (const sp of spans) {
+            const scope = sp.instrumentationScope;
+            const scopeKey = `${scope?.name ?? "unknown"}:${scope?.version ?? ""}`;
+            let existing = scopeMap.get(scopeKey);
+            if (!existing) {
+                existing = [];
+                scopeMap.set(scopeKey, existing);
+            }
+            existing.push((0, utils_js_1.truncateSpan)(this.mapSpan(sp)));
+        }
+        const scopeSpans = [];
+        for (const [scopeKey, mappedSpans] of scopeMap) {
+            const [name, version] = scopeKey.split(":");
+            scopeSpans.push({
+                scope: { name, version: version || undefined },
+                spans: mappedSpans,
+            });
+        }
+        let resourceAttrs = {};
+        if (spans.length > 0 && spans[0].resource?.attributes) {
+            resourceAttrs = { ...spans[0].resource.attributes };
+        }
+        return {
+            resourceSpans: [
+                {
+                    resource: {
+                        attributes: Object.keys(resourceAttrs).length > 0 ? resourceAttrs : null,
+                    },
+                    scopeSpans,
+                },
+            ],
+        };
+    }
+    mapSpan(sp) {
+        const ctx = sp.spanContext();
+        let parentSpanId;
+        if (sp.parentSpanContext?.spanId && sp.parentSpanContext.spanId !== "0000000000000000") {
+            parentSpanId = (0, utils_js_1.hexSpanId)(sp.parentSpanContext.spanId);
+        }
+        const attrs = sp.attributes ? { ...sp.attributes } : {};
+        const events = (sp.events ?? []).map((ev) => {
+            const timeNs = Array.isArray(ev.time)
+                ? ev.time[0] * 1_000_000_000 + ev.time[1]
+                : ev.time;
+            const evAttrs = ev.attributes && Object.keys(ev.attributes).length > 0 ? { ...ev.attributes } : null;
+            return { timeUnixNano: timeNs, name: ev.name, attributes: evAttrs };
+        });
+        const links = (sp.links ?? []).map((ln) => {
+            const lnAttrs = ln.attributes && Object.keys(ln.attributes).length > 0 ? { ...ln.attributes } : null;
+            return {
+                traceId: (0, utils_js_1.hexTraceId)(ln.context.traceId),
+                spanId: (0, utils_js_1.hexSpanId)(ln.context.spanId),
+                attributes: lnAttrs,
+            };
+        });
+        const status = {
+            code: (0, utils_js_1.statusName)(sp.status?.code ?? 0),
+            message: sp.status?.message || "",
+        };
+        const startTimeNs = Array.isArray(sp.startTime)
+            ? sp.startTime[0] * 1_000_000_000 + sp.startTime[1]
+            : sp.startTime;
+        const endTimeNs = Array.isArray(sp.endTime)
+            ? sp.endTime[0] * 1_000_000_000 + sp.endTime[1]
+            : sp.endTime;
+        return {
+            traceId: (0, utils_js_1.hexTraceId)(ctx.traceId),
+            spanId: (0, utils_js_1.hexSpanId)(ctx.spanId),
+            parentSpanId,
+            name: sp.name,
+            kind: (0, utils_js_1.kindName)(sp.kind),
+            startTimeUnixNano: startTimeNs,
+            endTimeUnixNano: endTimeNs,
+            attributes: Object.keys(attrs).length > 0 ? attrs : null,
+            events: events.length > 0 ? events : null,
+            links: links.length > 0 ? links : null,
+            status,
+        };
+    }
+    async shutdown() {
+        this.closed = true;
+    }
+    async forceFlush() {
+        // No-op — spans are exported immediately on export() call
+    }
+}
+exports.Agent365Exporter = Agent365Exporter;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=Agent365Exporter.js.map