@azure/opentelemetry-instrumentation-azure-sdk 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/commonjs/instrumentation.js

@@ -0,0 +1,57 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureSdkInstrumentation = void 0;
+exports.createAzureSdkInstrumentation = createAzureSdkInstrumentation;
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const instrumenter_js_1 = require("./instrumenter.js");
+const configuration_js_1 = require("./configuration.js");
+/**
+ * The instrumentation module for the Azure SDK. Implements OpenTelemetry's {@link Instrumentation}.
+ */
+class AzureSdkInstrumentation extends instrumentation_1.InstrumentationBase {
+    constructor(options = {}) {
+        super("@azure/opentelemetry-instrumentation-azure-sdk", configuration_js_1.SDK_VERSION, Object.assign({}, options));
+    }
+    /**
+     * Entrypoint for the module registration.
+     *
+     * @returns The patched \@azure/core-tracing module after setting its instrumenter.
+     */
+    init() {
+        const result = new instrumentation_1.InstrumentationNodeModuleDefinition("@azure/core-tracing", ["^1.0.0-preview.14", "^1.0.0"], (moduleExports) => {
+            if (typeof moduleExports.useInstrumenter === "function") {
+                moduleExports.useInstrumenter(new instrumenter_js_1.OpenTelemetryInstrumenter());
+            }
+            return moduleExports;
+        });
+        // Needed to support 1.0.0-preview.14
+        result.includePrerelease = true;
+        return result;
+    }
+}
+exports.AzureSdkInstrumentation = AzureSdkInstrumentation;
+/**
+ * Enables Azure SDK Instrumentation using OpenTelemetry for Azure SDK client libraries.
+ *
+ * When registered, any Azure data plane package will begin emitting tracing spans for internal calls
+ * as well as network calls
+ *
+ * Example usage:
+ * ```ts
+ * const openTelemetryInstrumentation = require("@opentelemetry/instrumentation");
+ * openTelemetryInstrumentation.registerInstrumentations({
+ *   instrumentations: [createAzureSdkInstrumentation()],
+ * })
+ * ```
+ *
+ * @remarks
+ *
+ * As OpenTelemetry instrumentations rely on patching required modules, you should register
+ * this instrumentation as early as possible and before loading any Azure Client Libraries.
+ */
+function createAzureSdkInstrumentation(options = {}) {
+    return new AzureSdkInstrumentation(options);
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/commonjs/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAuElC,sEAIC;AAzED,oEAMwC;AAExC,uDAA8D;AAC9D,yDAAiD;AAOjD;;GAEG;AACH,MAAa,uBAAwB,SAAQ,qCAAmB;IAC9D,YAAY,UAA0C,EAAE;QACtD,KAAK,CACH,gDAAgD,EAChD,8BAAW,EACX,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAC3B,CAAC;IACJ,CAAC;IACD;;;;OAIG;IACO,IAAI;QACZ,MAAM,MAAM,GAAoC,IAAI,qDAAmC,CACrF,qBAAqB,EACrB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC/B,CAAC,aAAa,EAAE,EAAE;YAChB,IAAI,OAAO,aAAa,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;gBACxD,aAAa,CAAC,eAAe,CAAC,IAAI,2CAAyB,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC,CACF,CAAC;QACF,qCAAqC;QACrC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA7BD,0DA6BC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,6BAA6B,CAC3C,UAA0C,EAAE;IAE5C,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  Instrumentation,\n  InstrumentationBase,\n  InstrumentationConfig,\n  InstrumentationModuleDefinition,\n  InstrumentationNodeModuleDefinition,\n} from \"@opentelemetry/instrumentation\";\n\nimport { OpenTelemetryInstrumenter } from \"./instrumenter.js\";\nimport { SDK_VERSION } from \"./configuration.js\";\n\n/**\n * Configuration options that can be passed to {@link createAzureSdkInstrumentation} function.\n */\nexport interface AzureSdkInstrumentationOptions extends InstrumentationConfig {}\n\n/**\n * The instrumentation module for the Azure SDK. Implements OpenTelemetry's {@link Instrumentation}.\n */\nexport class AzureSdkInstrumentation extends InstrumentationBase {\n  constructor(options: AzureSdkInstrumentationOptions = {}) {\n    super(\n      \"@azure/opentelemetry-instrumentation-azure-sdk\",\n      SDK_VERSION,\n      Object.assign({}, options),\n    );\n  }\n  /**\n   * Entrypoint for the module registration.\n   *\n   * @returns The patched \\@azure/core-tracing module after setting its instrumenter.\n   */\n  protected init(): void | InstrumentationModuleDefinition | InstrumentationModuleDefinition[] {\n    const result: InstrumentationModuleDefinition = new InstrumentationNodeModuleDefinition(\n      \"@azure/core-tracing\",\n      [\"^1.0.0-preview.14\", \"^1.0.0\"],\n      (moduleExports) => {\n        if (typeof moduleExports.useInstrumenter === \"function\") {\n          moduleExports.useInstrumenter(new OpenTelemetryInstrumenter());\n        }\n\n        return moduleExports;\n      },\n    );\n    // Needed to support 1.0.0-preview.14\n    result.includePrerelease = true;\n    return result;\n  }\n}\n\n/**\n * Enables Azure SDK Instrumentation using OpenTelemetry for Azure SDK client libraries.\n *\n * When registered, any Azure data plane package will begin emitting tracing spans for internal calls\n * as well as network calls\n *\n * Example usage:\n * ```ts\n * const openTelemetryInstrumentation = require(\"@opentelemetry/instrumentation\");\n * openTelemetryInstrumentation.registerInstrumentations({\n *   instrumentations: [createAzureSdkInstrumentation()],\n * })\n * ```\n *\n * @remarks\n *\n * As OpenTelemetry instrumentations rely on patching required modules, you should register\n * this instrumentation as early as possible and before loading any Azure Client Libraries.\n */\nexport function createAzureSdkInstrumentation(\n  options: AzureSdkInstrumentationOptions = {},\n): Instrumentation {\n  return new AzureSdkInstrumentation(options);\n}\n"]}

package/dist/commonjs/instrumenter.d.ts

@@ -0,0 +1,13 @@
+import { Instrumenter, InstrumenterSpanOptions, TracingContext, TracingSpan } from "@azure/core-tracing";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+export declare const propagator: W3CTraceContextPropagator;
+export declare class OpenTelemetryInstrumenter implements Instrumenter {
+    startSpan(name: string, spanOptions: InstrumenterSpanOptions): {
+        span: TracingSpan;
+        tracingContext: TracingContext;
+    };
+    withContext<CallbackArgs extends unknown[], Callback extends (...args: CallbackArgs) => ReturnType<Callback>>(tracingContext: TracingContext, callback: Callback, ...callbackArgs: CallbackArgs): ReturnType<Callback>;
+    parseTraceparentHeader(traceparentHeader: string): TracingContext;
+    createRequestHeaders(tracingContext?: TracingContext): Record<string, string>;
+}
+//# sourceMappingURL=instrumenter.d.ts.map

package/dist/commonjs/instrumenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumenter.d.ts","sourceRoot":"","sources":["../../src/instrumenter.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAmB,MAAM,qBAAqB,CAAC;AAOjF,eAAO,MAAM,UAAU,2BAAkC,CAAC;AAE1D,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,uBAAuB,GACnC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE;IA2BxD,WAAW,CACT,YAAY,SAAS,OAAO,EAAE,EAC9B,QAAQ,SAAS,CAAC,GAAG,IAAI,EAAE,YAAY,KAAK,UAAU,CAAC,QAAQ,CAAC,EAEhE,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,GAAG,YAAY,EAAE,YAAY,GAC5B,UAAU,CAAC,QAAQ,CAAC;IASvB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,GAAG,cAAc;IAQjE,oBAAoB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAK9E"}

package/dist/commonjs/instrumenter.js

@@ -0,0 +1,51 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetryInstrumenter = exports.propagator = void 0;
+const api_1 = require("@opentelemetry/api");
+const core_1 = require("@opentelemetry/core");
+const spanWrapper_js_1 = require("./spanWrapper.js");
+const configuration_js_1 = require("./configuration.js");
+const transformations_js_1 = require("./transformations.js");
+// While default propagation is user-configurable, Azure services always use the W3C implementation.
+exports.propagator = new core_1.W3CTraceContextPropagator();
+class OpenTelemetryInstrumenter {
+    startSpan(name, spanOptions) {
+        let ctx = (spanOptions === null || spanOptions === void 0 ? void 0 : spanOptions.tracingContext) || api_1.context.active();
+        let span;
+        if ((0, configuration_js_1.envVarToBoolean)("AZURE_TRACING_DISABLED")) {
+            // disable only our spans but not any downstream spans
+            span = api_1.trace.wrapSpanContext(api_1.INVALID_SPAN_CONTEXT);
+        }
+        else {
+            // Create our span
+            span = api_1.trace
+                .getTracer(spanOptions.packageName, spanOptions.packageVersion)
+                .startSpan(name, (0, transformations_js_1.toSpanOptions)(spanOptions), ctx);
+            if ((0, configuration_js_1.envVarToBoolean)("AZURE_HTTP_TRACING_CHILDREN_DISABLED") &&
+                name.toUpperCase().startsWith("HTTP")) {
+                // disable downstream spans
+                ctx = (0, core_1.suppressTracing)(ctx);
+            }
+        }
+        return {
+            span: new spanWrapper_js_1.OpenTelemetrySpanWrapper(span),
+            tracingContext: api_1.trace.setSpan(ctx, span),
+        };
+    }
+    withContext(tracingContext, callback, ...callbackArgs) {
+        return api_1.context.with(tracingContext, callback, 
+        /** Assume caller will bind `this` or use arrow functions */ undefined, ...callbackArgs);
+    }
+    parseTraceparentHeader(traceparentHeader) {
+        return exports.propagator.extract(api_1.context.active(), { traceparent: traceparentHeader }, api_1.defaultTextMapGetter);
+    }
+    createRequestHeaders(tracingContext) {
+        const headers = {};
+        exports.propagator.inject(tracingContext || api_1.context.active(), headers, api_1.defaultTextMapSetter);
+        return headers;
+    }
+}
+exports.OpenTelemetryInstrumenter = OpenTelemetryInstrumenter;
+//# sourceMappingURL=instrumenter.js.map

package/dist/commonjs/instrumenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumenter.js","sourceRoot":"","sources":["../../src/instrumenter.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,4CAO4B;AAO5B,8CAAiF;AAEjF,qDAA4D;AAC5D,yDAAqD;AACrD,6DAAqD;AAErD,oGAAoG;AACvF,QAAA,UAAU,GAAG,IAAI,gCAAyB,EAAE,CAAC;AAE1D,MAAa,yBAAyB;IACpC,SAAS,CACP,IAAY,EACZ,WAAoC;QAEpC,IAAI,GAAG,GAAG,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,cAAc,KAAI,aAAO,CAAC,MAAM,EAAE,CAAC;QAC1D,IAAI,IAAU,CAAC;QAEf,IAAI,IAAA,kCAAe,EAAC,wBAAwB,CAAC,EAAE,CAAC;YAC9C,sDAAsD;YACtD,IAAI,GAAG,WAAK,CAAC,eAAe,CAAC,0BAAoB,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,IAAI,GAAG,WAAK;iBACT,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,cAAc,CAAC;iBAC9D,SAAS,CAAC,IAAI,EAAE,IAAA,kCAAa,EAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;YAEpD,IACE,IAAA,kCAAe,EAAC,sCAAsC,CAAC;gBACvD,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EACrC,CAAC;gBACD,2BAA2B;gBAC3B,GAAG,GAAG,IAAA,sBAAe,EAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,yCAAwB,CAAC,IAAI,CAAC;YACxC,cAAc,EAAE,WAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;SACzC,CAAC;IACJ,CAAC;IACD,WAAW,CAIT,cAA8B,EAC9B,QAAkB,EAClB,GAAG,YAA0B;QAE7B,OAAO,aAAO,CAAC,IAAI,CACjB,cAAc,EACd,QAAQ;QACR,4DAA4D,CAAC,SAAS,EACtE,GAAG,YAAY,CAChB,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,iBAAyB;QAC9C,OAAO,kBAAU,CAAC,OAAO,CACvB,aAAO,CAAC,MAAM,EAAE,EAChB,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAClC,0BAAoB,CACrB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,cAA+B;QAClD,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,kBAAU,CAAC,MAAM,CAAC,cAAc,IAAI,aAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,0BAAoB,CAAC,CAAC;QACrF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA5DD,8DA4DC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  INVALID_SPAN_CONTEXT,\n  Span,\n  context,\n  defaultTextMapGetter,\n  defaultTextMapSetter,\n  trace,\n} from \"@opentelemetry/api\";\nimport {\n  Instrumenter,\n  InstrumenterSpanOptions,\n  TracingContext,\n  TracingSpan,\n} from \"@azure/core-tracing\";\nimport { W3CTraceContextPropagator, suppressTracing } from \"@opentelemetry/core\";\n\nimport { OpenTelemetrySpanWrapper } from \"./spanWrapper.js\";\nimport { envVarToBoolean } from \"./configuration.js\";\nimport { toSpanOptions } from \"./transformations.js\";\n\n// While default propagation is user-configurable, Azure services always use the W3C implementation.\nexport const propagator = new W3CTraceContextPropagator();\n\nexport class OpenTelemetryInstrumenter implements Instrumenter {\n  startSpan(\n    name: string,\n    spanOptions: InstrumenterSpanOptions,\n  ): { span: TracingSpan; tracingContext: TracingContext } {\n    let ctx = spanOptions?.tracingContext || context.active();\n    let span: Span;\n\n    if (envVarToBoolean(\"AZURE_TRACING_DISABLED\")) {\n      // disable only our spans but not any downstream spans\n      span = trace.wrapSpanContext(INVALID_SPAN_CONTEXT);\n    } else {\n      // Create our span\n      span = trace\n        .getTracer(spanOptions.packageName, spanOptions.packageVersion)\n        .startSpan(name, toSpanOptions(spanOptions), ctx);\n\n      if (\n        envVarToBoolean(\"AZURE_HTTP_TRACING_CHILDREN_DISABLED\") &&\n        name.toUpperCase().startsWith(\"HTTP\")\n      ) {\n        // disable downstream spans\n        ctx = suppressTracing(ctx);\n      }\n    }\n\n    return {\n      span: new OpenTelemetrySpanWrapper(span),\n      tracingContext: trace.setSpan(ctx, span),\n    };\n  }\n  withContext<\n    CallbackArgs extends unknown[],\n    Callback extends (...args: CallbackArgs) => ReturnType<Callback>,\n  >(\n    tracingContext: TracingContext,\n    callback: Callback,\n    ...callbackArgs: CallbackArgs\n  ): ReturnType<Callback> {\n    return context.with(\n      tracingContext,\n      callback,\n      /** Assume caller will bind `this` or use arrow functions */ undefined,\n      ...callbackArgs,\n    );\n  }\n\n  parseTraceparentHeader(traceparentHeader: string): TracingContext {\n    return propagator.extract(\n      context.active(),\n      { traceparent: traceparentHeader },\n      defaultTextMapGetter,\n    );\n  }\n\n  createRequestHeaders(tracingContext?: TracingContext): Record<string, string> {\n    const headers: Record<string, string> = {};\n    propagator.inject(tracingContext || context.active(), headers, defaultTextMapSetter);\n    return headers;\n  }\n}\n"]}

package/dist/commonjs/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The \@azure/logger configuration for this package.
+ */
+export declare const logger: import("@azure/logger").AzureLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/commonjs/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,MAAM,qCAAgE,CAAC"}

package/dist/commonjs/logger.js

@@ -0,0 +1,11 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const logger_1 = require("@azure/logger");
+/**
+ * The \@azure/logger configuration for this package.
+ */
+exports.logger = (0, logger_1.createClientLogger)("opentelemetry-instrumentation-azure-sdk");
+//# sourceMappingURL=logger.js.map

package/dist/commonjs/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,0CAAmD;AAEnD;;GAEG;AACU,QAAA,MAAM,GAAG,IAAA,2BAAkB,EAAC,yCAAyC,CAAC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { createClientLogger } from \"@azure/logger\";\n\n/**\n * The \\@azure/logger configuration for this package.\n */\nexport const logger = createClientLogger(\"opentelemetry-instrumentation-azure-sdk\");\n"]}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/spanWrapper.d.ts

@@ -0,0 +1,20 @@
+import { Span } from "@opentelemetry/api";
+import { SpanStatus, TracingSpan, AddEventOptions } from "@azure/core-tracing";
+export declare class OpenTelemetrySpanWrapper implements TracingSpan {
+    private _span;
+    constructor(span: Span);
+    setStatus(status: SpanStatus): void;
+    setAttribute(name: string, value: unknown): void;
+    end(): void;
+    recordException(exception: string | Error): void;
+    isRecording(): boolean;
+    addEvent(name: string, options?: AddEventOptions): void;
+    /**
+     * Allows getting the wrapped span as needed.
+     * @internal
+     *
+     * @returns The underlying span
+     */
+    unwrap(): Span;
+}
+//# sourceMappingURL=spanWrapper.d.ts.map

package/dist/commonjs/spanWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanWrapper.d.ts","sourceRoot":"","sources":["../../src/spanWrapper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAkB,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG/E,qBAAa,wBAAyB,YAAW,WAAW;IAC1D,OAAO,CAAC,KAAK,CAAO;gBAER,IAAI,EAAE,IAAI;IAItB,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAanC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAMhD,GAAG,IAAI,IAAI;IAIX,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAIhD,WAAW,IAAI,OAAO;IAItB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAI3D;;;;;OAKG;IACH,MAAM,IAAI,IAAI;CAGf"}

package/dist/commonjs/spanWrapper.js

@@ -0,0 +1,54 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenTelemetrySpanWrapper = void 0;
+const api_1 = require("@opentelemetry/api");
+const core_1 = require("@opentelemetry/core");
+class OpenTelemetrySpanWrapper {
+    constructor(span) {
+        this._span = span;
+    }
+    setStatus(status) {
+        if (status.status === "error") {
+            if (status.error) {
+                this._span.setStatus({ code: api_1.SpanStatusCode.ERROR, message: status.error.toString() });
+                this.recordException(status.error);
+            }
+            else {
+                this._span.setStatus({ code: api_1.SpanStatusCode.ERROR });
+            }
+        }
+        else if (status.status === "success") {
+            this._span.setStatus({ code: api_1.SpanStatusCode.OK });
+        }
+    }
+    setAttribute(name, value) {
+        if (value !== null && value !== undefined && (0, core_1.isAttributeValue)(value)) {
+            this._span.setAttribute(name, value);
+        }
+    }
+    end() {
+        this._span.end();
+    }
+    recordException(exception) {
+        this._span.recordException(exception);
+    }
+    isRecording() {
+        return this._span.isRecording();
+    }
+    addEvent(name, options = {}) {
+        this._span.addEvent(name, (0, core_1.sanitizeAttributes)(options.attributes), options.startTime);
+    }
+    /**
+     * Allows getting the wrapped span as needed.
+     * @internal
+     *
+     * @returns The underlying span
+     */
+    unwrap() {
+        return this._span;
+    }
+}
+exports.OpenTelemetrySpanWrapper = OpenTelemetrySpanWrapper;
+//# sourceMappingURL=spanWrapper.js.map

package/dist/commonjs/spanWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanWrapper.js","sourceRoot":"","sources":["../../src/spanWrapper.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,4CAA0D;AAE1D,8CAA2E;AAE3E,MAAa,wBAAwB;IAGnC,YAAY,IAAU;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,MAAkB;QAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,KAAc;QACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,GAAG;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,eAAe,CAAC,SAAyB;QACvC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,UAA2B,EAAE;QAClD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAA,yBAAkB,EAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvF,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAnDD,4DAmDC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { Span, SpanStatusCode } from \"@opentelemetry/api\";\nimport { SpanStatus, TracingSpan, AddEventOptions } from \"@azure/core-tracing\";\nimport { isAttributeValue, sanitizeAttributes } from \"@opentelemetry/core\";\n\nexport class OpenTelemetrySpanWrapper implements TracingSpan {\n  private _span: Span;\n\n  constructor(span: Span) {\n    this._span = span;\n  }\n\n  setStatus(status: SpanStatus): void {\n    if (status.status === \"error\") {\n      if (status.error) {\n        this._span.setStatus({ code: SpanStatusCode.ERROR, message: status.error.toString() });\n        this.recordException(status.error);\n      } else {\n        this._span.setStatus({ code: SpanStatusCode.ERROR });\n      }\n    } else if (status.status === \"success\") {\n      this._span.setStatus({ code: SpanStatusCode.OK });\n    }\n  }\n\n  setAttribute(name: string, value: unknown): void {\n    if (value !== null && value !== undefined && isAttributeValue(value)) {\n      this._span.setAttribute(name, value);\n    }\n  }\n\n  end(): void {\n    this._span.end();\n  }\n\n  recordException(exception: string | Error): void {\n    this._span.recordException(exception);\n  }\n\n  isRecording(): boolean {\n    return this._span.isRecording();\n  }\n\n  addEvent(name: string, options: AddEventOptions = {}): void {\n    this._span.addEvent(name, sanitizeAttributes(options.attributes), options.startTime);\n  }\n\n  /**\n   * Allows getting the wrapped span as needed.\n   * @internal\n   *\n   * @returns The underlying span\n   */\n  unwrap(): Span {\n    return this._span;\n  }\n}\n"]}

package/dist/commonjs/transformations.d.ts

@@ -0,0 +1,29 @@
+import { InstrumenterSpanOptions, TracingSpanKind } from "@azure/core-tracing";
+import { SpanKind, SpanOptions } from "@opentelemetry/api";
+/**
+ * Converts our TracingSpanKind to the corresponding OpenTelemetry SpanKind.
+ *
+ * By default it will return {@link SpanKind.INTERNAL}
+ * @param tracingSpanKind - The core tracing {@link TracingSpanKind}
+ * @returns - The OpenTelemetry {@link SpanKind}
+ */
+export declare function toOpenTelemetrySpanKind<K extends TracingSpanKind>(tracingSpanKind?: K): SpanKindMapping[K];
+/**
+ * A mapping between our {@link TracingSpanKind} union type and OpenTelemetry's {@link SpanKind}.
+ */
+type SpanKindMapping = {
+    client: SpanKind.CLIENT;
+    server: SpanKind.SERVER;
+    producer: SpanKind.PRODUCER;
+    consumer: SpanKind.CONSUMER;
+    internal: SpanKind.INTERNAL;
+};
+/**
+ * Converts core-tracing span options to OpenTelemetry options.
+ *
+ * @param spanOptions - The {@link InstrumenterSpanOptions} to convert.
+ * @returns An OpenTelemetry {@link SpanOptions} that can be used when creating a span.
+ */
+export declare function toSpanOptions(spanOptions?: InstrumenterSpanOptions): SpanOptions;
+export {};
+//# sourceMappingURL=transformations.d.ts.map

package/dist/commonjs/transformations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../src/transformations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAQ,QAAQ,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AAGxE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAC/D,eAAe,CAAC,EAAE,CAAC,GAClB,eAAe,CAAC,CAAC,CAAC,CAGpB;AAED;;GAEG;AACH,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC;CAC7B,CAAC;AAqBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,uBAAuB,GAAG,WAAW,CAYhF"}

package/dist/commonjs/transformations.js

@@ -0,0 +1,55 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toOpenTelemetrySpanKind = toOpenTelemetrySpanKind;
+exports.toSpanOptions = toSpanOptions;
+const api_1 = require("@opentelemetry/api");
+const core_1 = require("@opentelemetry/core");
+/**
+ * Converts our TracingSpanKind to the corresponding OpenTelemetry SpanKind.
+ *
+ * By default it will return {@link SpanKind.INTERNAL}
+ * @param tracingSpanKind - The core tracing {@link TracingSpanKind}
+ * @returns - The OpenTelemetry {@link SpanKind}
+ */
+function toOpenTelemetrySpanKind(tracingSpanKind) {
+    const key = (tracingSpanKind || "internal").toUpperCase();
+    return api_1.SpanKind[key];
+}
+/**
+ * Converts core-tracing's TracingSpanLink to OpenTelemetry's Link
+ *
+ * @param spanLinks - The core tracing {@link TracingSpanLink} to convert
+ * @returns A set of {@link Link}s
+ */
+function toOpenTelemetryLinks(spanLinks = []) {
+    return spanLinks.reduce((acc, tracingSpanLink) => {
+        const spanContext = api_1.trace.getSpanContext(tracingSpanLink.tracingContext);
+        if (spanContext) {
+            acc.push({
+                context: spanContext,
+                attributes: (0, core_1.sanitizeAttributes)(tracingSpanLink.attributes),
+            });
+        }
+        return acc;
+    }, []);
+}
+/**
+ * Converts core-tracing span options to OpenTelemetry options.
+ *
+ * @param spanOptions - The {@link InstrumenterSpanOptions} to convert.
+ * @returns An OpenTelemetry {@link SpanOptions} that can be used when creating a span.
+ */
+function toSpanOptions(spanOptions) {
+    const { spanAttributes, spanLinks, spanKind } = spanOptions || {};
+    const attributes = (0, core_1.sanitizeAttributes)(spanAttributes);
+    const kind = toOpenTelemetrySpanKind(spanKind);
+    const links = toOpenTelemetryLinks(spanLinks);
+    return {
+        attributes,
+        kind,
+        links,
+    };
+}
+//# sourceMappingURL=transformations.js.map

package/dist/commonjs/transformations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformations.js","sourceRoot":"","sources":["../../src/transformations.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAalC,0DAKC;AAsCD,sCAYC;AAjED,4CAAwE;AACxE,8CAAyD;AAEzD;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,eAAmB;IAEnB,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,UAAU,CAAC,CAAC,WAAW,EAA2B,CAAC;IACnF,OAAO,cAAQ,CAAC,GAAG,CAAuB,CAAC;AAC7C,CAAC;AAaD;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,YAA+B,EAAE;IAC7D,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE;QAC/C,MAAM,WAAW,GAAG,WAAK,CAAC,cAAc,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QACzE,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC;gBACP,OAAO,EAAE,WAAW;gBACpB,UAAU,EAAE,IAAA,yBAAkB,EAAC,eAAe,CAAC,UAAU,CAAC;aAC3D,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAY,CAAC,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,WAAqC;IACjE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,IAAI,EAAE,CAAC;IAElE,MAAM,UAAU,GAAG,IAAA,yBAAkB,EAAC,cAAc,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO;QACL,UAAU;QACV,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { InstrumenterSpanOptions, TracingSpanKind, TracingSpanLink } from \"@azure/core-tracing\";\nimport { Link, SpanKind, SpanOptions, trace } from \"@opentelemetry/api\";\nimport { sanitizeAttributes } from \"@opentelemetry/core\";\n\n/**\n * Converts our TracingSpanKind to the corresponding OpenTelemetry SpanKind.\n *\n * By default it will return {@link SpanKind.INTERNAL}\n * @param tracingSpanKind - The core tracing {@link TracingSpanKind}\n * @returns - The OpenTelemetry {@link SpanKind}\n */\nexport function toOpenTelemetrySpanKind<K extends TracingSpanKind>(\n  tracingSpanKind?: K,\n): SpanKindMapping[K] {\n  const key = (tracingSpanKind || \"internal\").toUpperCase() as keyof typeof SpanKind;\n  return SpanKind[key] as SpanKindMapping[K];\n}\n\n/**\n * A mapping between our {@link TracingSpanKind} union type and OpenTelemetry's {@link SpanKind}.\n */\ntype SpanKindMapping = {\n  client: SpanKind.CLIENT;\n  server: SpanKind.SERVER;\n  producer: SpanKind.PRODUCER;\n  consumer: SpanKind.CONSUMER;\n  internal: SpanKind.INTERNAL;\n};\n\n/**\n * Converts core-tracing's TracingSpanLink to OpenTelemetry's Link\n *\n * @param spanLinks - The core tracing {@link TracingSpanLink} to convert\n * @returns A set of {@link Link}s\n */\nfunction toOpenTelemetryLinks(spanLinks: TracingSpanLink[] = []): Link[] {\n  return spanLinks.reduce((acc, tracingSpanLink) => {\n    const spanContext = trace.getSpanContext(tracingSpanLink.tracingContext);\n    if (spanContext) {\n      acc.push({\n        context: spanContext,\n        attributes: sanitizeAttributes(tracingSpanLink.attributes),\n      });\n    }\n    return acc;\n  }, [] as Link[]);\n}\n\n/**\n * Converts core-tracing span options to OpenTelemetry options.\n *\n * @param spanOptions - The {@link InstrumenterSpanOptions} to convert.\n * @returns An OpenTelemetry {@link SpanOptions} that can be used when creating a span.\n */\nexport function toSpanOptions(spanOptions?: InstrumenterSpanOptions): SpanOptions {\n  const { spanAttributes, spanLinks, spanKind } = spanOptions || {};\n\n  const attributes = sanitizeAttributes(spanAttributes);\n  const kind = toOpenTelemetrySpanKind(spanKind);\n  const links = toOpenTelemetryLinks(spanLinks);\n\n  return {\n    attributes,\n    kind,\n    links,\n  };\n}\n"]}

package/{types/latest → dist/commonjs}/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.36.4"
+      "packageVersion": "7.47.9"
     }
   ]
 }

package/dist/esm/configuration.d.ts

@@ -0,0 +1,21 @@
+export declare const SDK_VERSION: string;
+/**
+ * @internal
+ *
+ * Keys of known environment variables we look up.
+ */
+export type KnownEnvironmentKey = "AZURE_HTTP_TRACING_CHILDREN_DISABLED" | "AZURE_TRACING_DISABLED";
+/**
+ * @internal
+ *
+ * Cached values of environment variables that were fetched.
+ */
+export declare const environmentCache: Map<KnownEnvironmentKey, string | undefined>;
+/**
+ * Converts an environment variable to Boolean.
+ * the strings "false" and "0" are treated as falsy values.
+ *
+ * @internal
+ */
+export declare function envVarToBoolean(key: KnownEnvironmentKey): boolean;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/esm/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/configuration.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,EAAE,MAAuB,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,sCAAsC,GAAG,wBAAwB,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,8CAAqD,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAMjE"}

package/dist/esm/configuration.js

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export const SDK_VERSION = "1.0.0-beta.7";
+/**
+ * @internal
+ *
+ * Cached values of environment variables that were fetched.
+ */
+export const environmentCache = new Map();
+/**
+ * Converts an environment variable to Boolean.
+ * the strings "false" and "0" are treated as falsy values.
+ *
+ * @internal
+ */
+export function envVarToBoolean(key) {
+    var _a;
+    if (!environmentCache.has(key)) {
+        loadEnvironmentVariable(key);
+    }
+    const value = ((_a = environmentCache.get(key)) !== null && _a !== void 0 ? _a : "").toLowerCase();
+    return value !== "false" && value !== "0" && Boolean(value);
+}
+function loadEnvironmentVariable(key) {
+    var _a;
+    if (typeof process !== "undefined" && process.env) {
+        const rawValue = (_a = process.env[key]) !== null && _a !== void 0 ? _a : process.env[key.toLowerCase()];
+        environmentCache.set(key, rawValue);
+    }
+}
+//# sourceMappingURL=configuration.js.map

package/dist/esm/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/configuration.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,CAAC,MAAM,WAAW,GAAW,cAAc,CAAC;AASlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA2C,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAwB;;IACtD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,MAAA,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAwB;;IACvD,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAA,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport const SDK_VERSION: string = \"1.0.0-beta.7\";\n\n/**\n * @internal\n *\n * Keys of known environment variables we look up.\n */\nexport type KnownEnvironmentKey = \"AZURE_HTTP_TRACING_CHILDREN_DISABLED\" | \"AZURE_TRACING_DISABLED\";\n\n/**\n * @internal\n *\n * Cached values of environment variables that were fetched.\n */\nexport const environmentCache = new Map<KnownEnvironmentKey, string | undefined>();\n\n/**\n * Converts an environment variable to Boolean.\n * the strings \"false\" and \"0\" are treated as falsy values.\n *\n * @internal\n */\nexport function envVarToBoolean(key: KnownEnvironmentKey): boolean {\n  if (!environmentCache.has(key)) {\n    loadEnvironmentVariable(key);\n  }\n  const value = (environmentCache.get(key) ?? \"\").toLowerCase();\n  return value !== \"false\" && value !== \"0\" && Boolean(value);\n}\n\nfunction loadEnvironmentVariable(key: KnownEnvironmentKey): void {\n  if (typeof process !== \"undefined\" && process.env) {\n    const rawValue = process.env[key] ?? process.env[key.toLowerCase()];\n    environmentCache.set(key, rawValue);\n  }\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./logger.js";
+export * from "./instrumentation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export * from "./logger.js";
+export * from "./instrumentation.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport * from \"./logger.js\";\nexport * from \"./instrumentation.js\";\n"]}

package/dist/esm/instrumentation.d.ts

@@ -0,0 +1,39 @@
+import { Instrumentation, InstrumentationBase, InstrumentationConfig, InstrumentationModuleDefinition } from "@opentelemetry/instrumentation";
+/**
+ * Configuration options that can be passed to {@link createAzureSdkInstrumentation} function.
+ */
+export interface AzureSdkInstrumentationOptions extends InstrumentationConfig {
+}
+/**
+ * The instrumentation module for the Azure SDK. Implements OpenTelemetry's {@link Instrumentation}.
+ */
+export declare class AzureSdkInstrumentation extends InstrumentationBase {
+    constructor(options?: AzureSdkInstrumentationOptions);
+    /**
+     * Entrypoint for the module registration.
+     *
+     * @returns The patched \@azure/core-tracing module after setting its instrumenter.
+     */
+    protected init(): void | InstrumentationModuleDefinition | InstrumentationModuleDefinition[];
+}
+/**
+ * Enables Azure SDK Instrumentation using OpenTelemetry for Azure SDK client libraries.
+ *
+ * When registered, any Azure data plane package will begin emitting tracing spans for internal calls
+ * as well as network calls
+ *
+ * Example usage:
+ * ```ts
+ * const openTelemetryInstrumentation = require("@opentelemetry/instrumentation");
+ * openTelemetryInstrumentation.registerInstrumentations({
+ *   instrumentations: [createAzureSdkInstrumentation()],
+ * })
+ * ```
+ *
+ * @remarks
+ *
+ * As OpenTelemetry instrumentations rely on patching required modules, you should register
+ * this instrumentation as early as possible and before loading any Azure Client Libraries.
+ */
+export declare function createAzureSdkInstrumentation(options?: AzureSdkInstrumentationOptions): Instrumentation;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/esm/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,+BAA+B,EAEhC,MAAM,gCAAgC,CAAC;AAKxC;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,qBAAqB;CAAG;AAEhF;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;gBAClD,OAAO,GAAE,8BAAmC;IAOxD;;;;OAIG;IACH,SAAS,CAAC,IAAI,IAAI,IAAI,GAAG,+BAA+B,GAAG,+BAA+B,EAAE;CAgB7F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,eAAe,CAEjB"}

package/{dist-esm/src → dist/esm}/instrumentation.js

@@ -1,12 +1,12 @@
 // Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
+// Licensed under the MIT License.
 import { InstrumentationBase, InstrumentationNodeModuleDefinition, } from "@opentelemetry/instrumentation";
-import { OpenTelemetryInstrumenter } from "./instrumenter";
-import { SDK_VERSION } from "./configuration";
+import { OpenTelemetryInstrumenter } from "./instrumenter.js";
+import { SDK_VERSION } from "./configuration.js";
 /**
  * The instrumentation module for the Azure SDK. Implements OpenTelemetry's {@link Instrumentation}.
  */
-class AzureSdkInstrumentation extends InstrumentationBase {
+export class AzureSdkInstrumentation extends InstrumentationBase {
     constructor(options = {}) {
         super("@azure/opentelemetry-instrumentation-azure-sdk", SDK_VERSION, Object.assign({}, options));
     }

package/dist/esm/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAEL,mBAAmB,EAGnB,mCAAmC,GACpC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC9D,YAAY,UAA0C,EAAE;QACtD,KAAK,CACH,gDAAgD,EAChD,WAAW,EACX,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAC3B,CAAC;IACJ,CAAC;IACD;;;;OAIG;IACO,IAAI;QACZ,MAAM,MAAM,GAAoC,IAAI,mCAAmC,CACrF,qBAAqB,EACrB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC/B,CAAC,aAAa,EAAE,EAAE;YAChB,IAAI,OAAO,aAAa,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;gBACxD,aAAa,CAAC,eAAe,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,aAAa,CAAC;QACvB,CAAC,CACF,CAAC;QACF,qCAAqC;QACrC,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA0C,EAAE;IAE5C,OAAO,IAAI,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  Instrumentation,\n  InstrumentationBase,\n  InstrumentationConfig,\n  InstrumentationModuleDefinition,\n  InstrumentationNodeModuleDefinition,\n} from \"@opentelemetry/instrumentation\";\n\nimport { OpenTelemetryInstrumenter } from \"./instrumenter.js\";\nimport { SDK_VERSION } from \"./configuration.js\";\n\n/**\n * Configuration options that can be passed to {@link createAzureSdkInstrumentation} function.\n */\nexport interface AzureSdkInstrumentationOptions extends InstrumentationConfig {}\n\n/**\n * The instrumentation module for the Azure SDK. Implements OpenTelemetry's {@link Instrumentation}.\n */\nexport class AzureSdkInstrumentation extends InstrumentationBase {\n  constructor(options: AzureSdkInstrumentationOptions = {}) {\n    super(\n      \"@azure/opentelemetry-instrumentation-azure-sdk\",\n      SDK_VERSION,\n      Object.assign({}, options),\n    );\n  }\n  /**\n   * Entrypoint for the module registration.\n   *\n   * @returns The patched \\@azure/core-tracing module after setting its instrumenter.\n   */\n  protected init(): void | InstrumentationModuleDefinition | InstrumentationModuleDefinition[] {\n    const result: InstrumentationModuleDefinition = new InstrumentationNodeModuleDefinition(\n      \"@azure/core-tracing\",\n      [\"^1.0.0-preview.14\", \"^1.0.0\"],\n      (moduleExports) => {\n        if (typeof moduleExports.useInstrumenter === \"function\") {\n          moduleExports.useInstrumenter(new OpenTelemetryInstrumenter());\n        }\n\n        return moduleExports;\n      },\n    );\n    // Needed to support 1.0.0-preview.14\n    result.includePrerelease = true;\n    return result;\n  }\n}\n\n/**\n * Enables Azure SDK Instrumentation using OpenTelemetry for Azure SDK client libraries.\n *\n * When registered, any Azure data plane package will begin emitting tracing spans for internal calls\n * as well as network calls\n *\n * Example usage:\n * ```ts\n * const openTelemetryInstrumentation = require(\"@opentelemetry/instrumentation\");\n * openTelemetryInstrumentation.registerInstrumentations({\n *   instrumentations: [createAzureSdkInstrumentation()],\n * })\n * ```\n *\n * @remarks\n *\n * As OpenTelemetry instrumentations rely on patching required modules, you should register\n * this instrumentation as early as possible and before loading any Azure Client Libraries.\n */\nexport function createAzureSdkInstrumentation(\n  options: AzureSdkInstrumentationOptions = {},\n): Instrumentation {\n  return new AzureSdkInstrumentation(options);\n}\n"]}

package/dist/esm/instrumenter.d.ts

@@ -0,0 +1,13 @@
+import { Instrumenter, InstrumenterSpanOptions, TracingContext, TracingSpan } from "@azure/core-tracing";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+export declare const propagator: W3CTraceContextPropagator;
+export declare class OpenTelemetryInstrumenter implements Instrumenter {
+    startSpan(name: string, spanOptions: InstrumenterSpanOptions): {
+        span: TracingSpan;
+        tracingContext: TracingContext;
+    };
+    withContext<CallbackArgs extends unknown[], Callback extends (...args: CallbackArgs) => ReturnType<Callback>>(tracingContext: TracingContext, callback: Callback, ...callbackArgs: CallbackArgs): ReturnType<Callback>;
+    parseTraceparentHeader(traceparentHeader: string): TracingContext;
+    createRequestHeaders(tracingContext?: TracingContext): Record<string, string>;
+}
+//# sourceMappingURL=instrumenter.d.ts.map

package/dist/esm/instrumenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumenter.d.ts","sourceRoot":"","sources":["../../src/instrumenter.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAmB,MAAM,qBAAqB,CAAC;AAOjF,eAAO,MAAM,UAAU,2BAAkC,CAAC;AAE1D,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,uBAAuB,GACnC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,cAAc,EAAE,cAAc,CAAA;KAAE;IA2BxD,WAAW,CACT,YAAY,SAAS,OAAO,EAAE,EAC9B,QAAQ,SAAS,CAAC,GAAG,IAAI,EAAE,YAAY,KAAK,UAAU,CAAC,QAAQ,CAAC,EAEhE,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,GAAG,YAAY,EAAE,YAAY,GAC5B,UAAU,CAAC,QAAQ,CAAC;IASvB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,GAAG,cAAc;IAQjE,oBAAoB,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAK9E"}

package/dist/esm/instrumenter.js

@@ -0,0 +1,47 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { INVALID_SPAN_CONTEXT, context, defaultTextMapGetter, defaultTextMapSetter, trace, } from "@opentelemetry/api";
+import { W3CTraceContextPropagator, suppressTracing } from "@opentelemetry/core";
+import { OpenTelemetrySpanWrapper } from "./spanWrapper.js";
+import { envVarToBoolean } from "./configuration.js";
+import { toSpanOptions } from "./transformations.js";
+// While default propagation is user-configurable, Azure services always use the W3C implementation.
+export const propagator = new W3CTraceContextPropagator();
+export class OpenTelemetryInstrumenter {
+    startSpan(name, spanOptions) {
+        let ctx = (spanOptions === null || spanOptions === void 0 ? void 0 : spanOptions.tracingContext) || context.active();
+        let span;
+        if (envVarToBoolean("AZURE_TRACING_DISABLED")) {
+            // disable only our spans but not any downstream spans
+            span = trace.wrapSpanContext(INVALID_SPAN_CONTEXT);
+        }
+        else {
+            // Create our span
+            span = trace
+                .getTracer(spanOptions.packageName, spanOptions.packageVersion)
+                .startSpan(name, toSpanOptions(spanOptions), ctx);
+            if (envVarToBoolean("AZURE_HTTP_TRACING_CHILDREN_DISABLED") &&
+                name.toUpperCase().startsWith("HTTP")) {
+                // disable downstream spans
+                ctx = suppressTracing(ctx);
+            }
+        }
+        return {
+            span: new OpenTelemetrySpanWrapper(span),
+            tracingContext: trace.setSpan(ctx, span),
+        };
+    }
+    withContext(tracingContext, callback, ...callbackArgs) {
+        return context.with(tracingContext, callback, 
+        /** Assume caller will bind `this` or use arrow functions */ undefined, ...callbackArgs);
+    }
+    parseTraceparentHeader(traceparentHeader) {
+        return propagator.extract(context.active(), { traceparent: traceparentHeader }, defaultTextMapGetter);
+    }
+    createRequestHeaders(tracingContext) {
+        const headers = {};
+        propagator.inject(tracingContext || context.active(), headers, defaultTextMapSetter);
+        return headers;
+    }
+}
+//# sourceMappingURL=instrumenter.js.map

package/dist/esm/instrumenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumenter.js","sourceRoot":"","sources":["../../src/instrumenter.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EACL,oBAAoB,EAEpB,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,GACN,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oGAAoG;AACpG,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,yBAAyB,EAAE,CAAC;AAE1D,MAAM,OAAO,yBAAyB;IACpC,SAAS,CACP,IAAY,EACZ,WAAoC;QAEpC,IAAI,GAAG,GAAG,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,cAAc,KAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1D,IAAI,IAAU,CAAC;QAEf,IAAI,eAAe,CAAC,wBAAwB,CAAC,EAAE,CAAC;YAC9C,sDAAsD;YACtD,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,IAAI,GAAG,KAAK;iBACT,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,CAAC,cAAc,CAAC;iBAC9D,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;YAEpD,IACE,eAAe,CAAC,sCAAsC,CAAC;gBACvD,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EACrC,CAAC;gBACD,2BAA2B;gBAC3B,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,wBAAwB,CAAC,IAAI,CAAC;YACxC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC;SACzC,CAAC;IACJ,CAAC;IACD,WAAW,CAIT,cAA8B,EAC9B,QAAkB,EAClB,GAAG,YAA0B;QAE7B,OAAO,OAAO,CAAC,IAAI,CACjB,cAAc,EACd,QAAQ;QACR,4DAA4D,CAAC,SAAS,EACtE,GAAG,YAAY,CAChB,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,iBAAyB;QAC9C,OAAO,UAAU,CAAC,OAAO,CACvB,OAAO,CAAC,MAAM,EAAE,EAChB,EAAE,WAAW,EAAE,iBAAiB,EAAE,EAClC,oBAAoB,CACrB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,cAA+B;QAClD,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,UAAU,CAAC,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACrF,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  INVALID_SPAN_CONTEXT,\n  Span,\n  context,\n  defaultTextMapGetter,\n  defaultTextMapSetter,\n  trace,\n} from \"@opentelemetry/api\";\nimport {\n  Instrumenter,\n  InstrumenterSpanOptions,\n  TracingContext,\n  TracingSpan,\n} from \"@azure/core-tracing\";\nimport { W3CTraceContextPropagator, suppressTracing } from \"@opentelemetry/core\";\n\nimport { OpenTelemetrySpanWrapper } from \"./spanWrapper.js\";\nimport { envVarToBoolean } from \"./configuration.js\";\nimport { toSpanOptions } from \"./transformations.js\";\n\n// While default propagation is user-configurable, Azure services always use the W3C implementation.\nexport const propagator = new W3CTraceContextPropagator();\n\nexport class OpenTelemetryInstrumenter implements Instrumenter {\n  startSpan(\n    name: string,\n    spanOptions: InstrumenterSpanOptions,\n  ): { span: TracingSpan; tracingContext: TracingContext } {\n    let ctx = spanOptions?.tracingContext || context.active();\n    let span: Span;\n\n    if (envVarToBoolean(\"AZURE_TRACING_DISABLED\")) {\n      // disable only our spans but not any downstream spans\n      span = trace.wrapSpanContext(INVALID_SPAN_CONTEXT);\n    } else {\n      // Create our span\n      span = trace\n        .getTracer(spanOptions.packageName, spanOptions.packageVersion)\n        .startSpan(name, toSpanOptions(spanOptions), ctx);\n\n      if (\n        envVarToBoolean(\"AZURE_HTTP_TRACING_CHILDREN_DISABLED\") &&\n        name.toUpperCase().startsWith(\"HTTP\")\n      ) {\n        // disable downstream spans\n        ctx = suppressTracing(ctx);\n      }\n    }\n\n    return {\n      span: new OpenTelemetrySpanWrapper(span),\n      tracingContext: trace.setSpan(ctx, span),\n    };\n  }\n  withContext<\n    CallbackArgs extends unknown[],\n    Callback extends (...args: CallbackArgs) => ReturnType<Callback>,\n  >(\n    tracingContext: TracingContext,\n    callback: Callback,\n    ...callbackArgs: CallbackArgs\n  ): ReturnType<Callback> {\n    return context.with(\n      tracingContext,\n      callback,\n      /** Assume caller will bind `this` or use arrow functions */ undefined,\n      ...callbackArgs,\n    );\n  }\n\n  parseTraceparentHeader(traceparentHeader: string): TracingContext {\n    return propagator.extract(\n      context.active(),\n      { traceparent: traceparentHeader },\n      defaultTextMapGetter,\n    );\n  }\n\n  createRequestHeaders(tracingContext?: TracingContext): Record<string, string> {\n    const headers: Record<string, string> = {};\n    propagator.inject(tracingContext || context.active(), headers, defaultTextMapSetter);\n    return headers;\n  }\n}\n"]}

package/dist/esm/logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The \@azure/logger configuration for this package.
+ */
+export declare const logger: import("@azure/logger").AzureLogger;
+//# sourceMappingURL=logger.d.ts.map