@ohos-ports/datadog-pprof 5.17.0-1

package/out/src/otel-thread-ctx.js

@@ -0,0 +1,176 @@
+"use strict";
+/*
+ * Copyright 2026 Datadog, Inc
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._currentRecordBytes = exports.clearContext = exports.getContext = exports.ThreadContext = void 0;
+exports.getProcessContextAttributes = getProcessContextAttributes;
+// Vendored from https://github.com/polarsignals/custom-labels/tree/otel-thread-ctx-wip/js/
+// (originally js/index.js + js/index.d.ts, merged into TypeScript). Kept
+// as a near-verbatim copy: edits should ideally land upstream first and
+// be ported here, so the two stay in sync. We plan to drop this vendored
+// copy once the upstream package is suitable to depend on directly.
+// Node.js writer for the OpenTelemetry Thread Local Context Record
+// (OTEP-4947), discoverable from an out-of-process reader via the
+// `otel_thread_ctx_nodejs_v1` thread-local symbol exported by
+// `dd_pprof.node`.
+//
+// Linux only; on other platforms the exported functions degrade to no-ops.
+const path_1 = require("path");
+const node_async_hooks_1 = require("node:async_hooks");
+const SCHEMA_VERSION = 'nodejs_v1_dev';
+// V8 layout constants the addon captured from the V8 headers Node bundles.
+// On non-Linux these fall back to values matching Node's standard build
+// (no V8 pointer compression, no sandbox); the reader is Linux-only per
+// the OTEP anyway, so the fallbacks just keep processContextAttributes
+// consistent in shape.
+let WRAPPED_OBJECT_OFFSET = 24;
+let TAGGED_SIZE = 8;
+let NATIVE_WRAP_FIELDS_OFFSET = 24;
+let JS_MAP_TABLE_OFFSET = 0x18;
+let ORDERED_HASH_MAP_HEADER_SIZE = 0x10;
+// Debug accessor (not part of the stable API; for tests / reader dev).
+let _currentRecordBytes = () => undefined;
+exports._currentRecordBytes = _currentRecordBytes;
+if (process.platform === 'linux') {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const findBinding = require('node-gyp-build');
+    const addon = findBinding((0, path_1.join)(__dirname, '..', '..'));
+    WRAPPED_OBJECT_OFFSET = addon.otelThreadCtxWrappedObjectOffset;
+    TAGGED_SIZE = addon.otelThreadCtxTaggedSize;
+    NATIVE_WRAP_FIELDS_OFFSET = addon.otelThreadCtxNativeWrapFieldsOffset;
+    JS_MAP_TABLE_OFFSET = addon.otelThreadCtxJsMapTableOffset;
+    ORDERED_HASH_MAP_HEADER_SIZE = addon.otelThreadCtxOrderedHashMapHeaderSize;
+    exports.ThreadContext = addon.threadContext;
+    let als;
+    function asyncContextFrameError() {
+        const [major] = process.versions.node.split('.').map(Number);
+        if (process.execArgv.includes('--no-async-context-frame')) {
+            return 'Node explicitly launched with --no-async-context-frame';
+        }
+        if (major >= 24)
+            return undefined;
+        if (process.execArgv.includes('--experimental-async-context-frame')) {
+            return undefined;
+        }
+        if (major >= 22) {
+            return 'Node versions prior to v24 must be launched with --experimental-async-context-frame';
+        }
+        return 'Node major versions prior to v22 do not support the feature at all';
+    }
+    function ensureHook() {
+        if (als)
+            return als;
+        const err = asyncContextFrameError();
+        if (err) {
+            throw new Error(`otel thread-ctx writer requires async_context_frame support, which is unavailable: ${err}.`);
+        }
+        als = new node_async_hooks_1.AsyncLocalStorage();
+        addon.otelThreadCtxStoreAls(als);
+        return als;
+    }
+    exports.getContext = function () {
+        return als ? als.getStore() : undefined;
+    };
+    // Idempotent: clearing when the hook hasn't been installed (no prior
+    // enter / run on a ThreadContext) is a no-op.
+    exports.clearContext = function () {
+        if (!als)
+            return;
+        als.enterWith(undefined);
+    };
+    // Install the active-context channel on the ThreadContext prototype so
+    // the only way to push a ThreadContext into our AsyncLocalStorage is
+    // via the context itself — callers can't poison the ALS with an
+    // arbitrary object.
+    exports.ThreadContext.prototype.enter = function () {
+        ensureHook().enterWith(this);
+    };
+    exports.ThreadContext.prototype.run = function (fn) {
+        return ensureHook().run(this, fn);
+    };
+    exports._currentRecordBytes = function () {
+        if (!als)
+            return undefined;
+        const context = als.getStore();
+        return context ? context.debugBytes() : undefined;
+    };
+}
+else {
+    // Non-Linux degradation. The writer's reader contract is ELF-TLSDESC,
+    // meaningful only on Linux; on other platforms we still want the API
+    // to be callable so consumers don't have to gate every call site —
+    // construction succeeds but produces an inert context, and the
+    // enter/run/clearContext entry points don't wire anything into
+    // AsyncLocalStorage.
+    class NoopThreadContext {
+        appendAttributes() { }
+        isTruncated() {
+            return false;
+        }
+        debugBytes() {
+            return new Uint8Array(0);
+        }
+        enter() { }
+        run(fn) {
+            return fn();
+        }
+    }
+    exports.ThreadContext = NoopThreadContext;
+    exports.getContext = function () {
+        return undefined;
+    };
+    exports.clearContext = function () { };
+}
+/**
+ * Returns the OTEP-4719 process-context attributes the caller should
+ * publish so an out-of-process reader can decode the on-the-wire uint8
+ * key indexes back to attribute names. The supplied `keys` array is the
+ * same string list the caller writes into the positional `attributes`
+ * argument of {@link ThreadContext}: index N here is the uint8 key index
+ * N in each record.
+ *
+ * `keys` is validated: must be a string array of length ≤ 256 with no
+ * duplicates.
+ */
+function getProcessContextAttributes(keys) {
+    if (!Array.isArray(keys)) {
+        throw new TypeError('keys must be an array of attribute names');
+    }
+    if (keys.length > 256) {
+        throw new RangeError('keys array exceeds 256 entries');
+    }
+    const seen = new Set();
+    for (let i = 0; i < keys.length; ++i) {
+        const name = keys[i];
+        if (typeof name !== 'string') {
+            throw new TypeError('every key must be a string');
+        }
+        if (seen.has(name)) {
+            throw new Error(`duplicate key name at index ${i}: ${name}`);
+        }
+        seen.add(name);
+    }
+    return Object.freeze({
+        'threadlocal.schema_version': SCHEMA_VERSION,
+        'threadlocal.attribute_key_map': Object.freeze(keys.slice()),
+        'threadlocal.wrapped_object_offset': WRAPPED_OBJECT_OFFSET,
+        'threadlocal.tagged_size': TAGGED_SIZE,
+        'threadlocal.native_wrap_fields_offset': NATIVE_WRAP_FIELDS_OFFSET,
+        'threadlocal.js_map_table_offset': JS_MAP_TABLE_OFFSET,
+        'threadlocal.ordered_hash_map_header_size': ORDERED_HASH_MAP_HEADER_SIZE,
+    });
+}
+//# sourceMappingURL=otel-thread-ctx.js.map

package/out/src/otel-thread-ctx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-thread-ctx.js","sourceRoot":"","sources":["../../ts/src/otel-thread-ctx.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAiPH,kEA6BC;AA5QD,2FAA2F;AAC3F,yEAAyE;AACzE,wEAAwE;AACxE,yEAAyE;AACzE,oEAAoE;AAEpE,mEAAmE;AACnE,kEAAkE;AAClE,8DAA8D;AAC9D,mBAAmB;AACnB,EAAE;AACF,2EAA2E;AAE3E,+BAA0B;AAC1B,uDAAmD;AAmFnD,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,2EAA2E;AAC3E,wEAAwE;AACxE,wEAAwE;AACxE,uEAAuE;AACvE,uBAAuB;AACvB,IAAI,qBAAqB,GAAG,EAAE,CAAC;AAC/B,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,yBAAyB,GAAG,EAAE,CAAC;AACnC,IAAI,mBAAmB,GAAG,IAAI,CAAC;AAC/B,IAAI,4BAA4B,GAAG,IAAI,CAAC;AAkBxC,uEAAuE;AAChE,IAAI,mBAAmB,GAAiC,GAAG,EAAE,CAAC,SAAS,CAAC;AAApE,QAAA,mBAAmB,uBAAiD;AAE/E,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;IACjC,iEAAiE;IACjE,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAU,WAAW,CAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,qBAAqB,GAAG,KAAK,CAAC,gCAAgC,CAAC;IAC/D,WAAW,GAAG,KAAK,CAAC,uBAAuB,CAAC;IAC5C,yBAAyB,GAAG,KAAK,CAAC,mCAAmC,CAAC;IACtE,mBAAmB,GAAG,KAAK,CAAC,6BAA6B,CAAC;IAC1D,4BAA4B,GAAG,KAAK,CAAC,qCAAqC,CAAC;IAE3E,qBAAa,GAAG,KAAK,CAAC,aAAa,CAAC;IAEpC,IAAI,GAAiD,CAAC;IAEtD,SAAS,sBAAsB;QAC7B,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;YAC1D,OAAO,wDAAwD,CAAC;QAClE,CAAC;QACD,IAAI,KAAK,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;QAClC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAAE,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,qFAAqF,CAAC;QAC/F,CAAC;QACD,OAAO,oEAAoE,CAAC;IAC9E,CAAC;IAED,SAAS,UAAU;QACjB,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,sBAAsB,EAAE,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,sFAAsF,GAAG,GAAG,CAC7F,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,IAAI,oCAAiB,EAAiB,CAAC;QAC7C,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kBAAU,GAAG;QACX,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC,CAAC;IAEF,qEAAqE;IACrE,8CAA8C;IAC9C,oBAAY,GAAG;QACb,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,GAAG,CAAC,SAAS,CAAC,SAAqC,CAAC,CAAC;IACvD,CAAC,CAAC;IAEF,uEAAuE;IACvE,qEAAqE;IACrE,gEAAgE;IAChE,oBAAoB;IACpB,qBAAa,CAAC,SAAS,CAAC,KAAK,GAAG;QAC9B,UAAU,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,qBAAa,CAAC,SAAS,CAAC,GAAG,GAAG,UAE5B,EAAW;QAEX,OAAO,UAAU,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;IAEF,2BAAmB,GAAG;QACpB,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC;KAAM,CAAC;IACN,sEAAsE;IACtE,qEAAqE;IACrE,mEAAmE;IACnE,+DAA+D;IAC/D,+DAA+D;IAC/D,qBAAqB;IACrB,MAAM,iBAAiB;QACrB,gBAAgB,KAAU,CAAC;QAC3B,WAAW;YACT,OAAO,KAAK,CAAC;QACf,CAAC;QACD,UAAU;YACR,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,KAAK,KAAU,CAAC;QAChB,GAAG,CAAI,EAAW;YAChB,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;KACF;IACD,qBAAa,GAAG,iBAAsC,CAAC;IACvD,kBAAU,GAAG;QACX,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,oBAAY,GAAG,cAAmB,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,2BAA2B,CACzC,IAAc;IAEd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,4BAA4B,EAAE,cAAc;QAC5C,+BAA+B,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5D,mCAAmC,EAAE,qBAAqB;QAC1D,yBAAyB,EAAE,WAAW;QACtC,uCAAuC,EAAE,yBAAyB;QAClE,iCAAiC,EAAE,mBAAmB;QACtD,0CAA0C,EAAE,4BAA4B;KACzE,CAA6B,CAAC;AACjC,CAAC"}

package/out/src/profile-encoder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright 2019 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Profile } from 'pprof-format';
+export declare function encode(profile: Profile): Promise<Buffer>;
+export declare function encodeSync(profile: Profile): Buffer;

package/out/src/profile-encoder.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Copyright 2019 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encode = encode;
+exports.encodeSync = encodeSync;
+const util_1 = require("util");
+const zlib_1 = require("zlib");
+const gzipPromise = (0, util_1.promisify)(zlib_1.gzip);
+function encode(profile) {
+    return profile.encodeAsync().then(gzipPromise);
+}
+function encodeSync(profile) {
+    return (0, zlib_1.gzipSync)(profile.encode());
+}
+//# sourceMappingURL=profile-encoder.js.map

package/out/src/profile-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-encoder.js","sourceRoot":"","sources":["../../ts/src/profile-encoder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AASH,wBAEC;AAED,gCAEC;AAbD,+BAA+B;AAC/B,+BAAoC;AAIpC,MAAM,WAAW,GAAG,IAAA,gBAAS,EAAC,WAAI,CAAC,CAAC;AAEpC,SAAgB,MAAM,CAAC,OAAgB;IACrC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,UAAU,CAAC,OAAgB;IACzC,OAAO,IAAA,eAAQ,EAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/out/src/profile-serializer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Copyright 2017 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Profile } from 'pprof-format';
+import { SourceMapper } from './sourcemapper/sourcemapper';
+import { AllocationProfileNode, AllocationProfileNodeWithStats, GenerateAllocationLabelsFunction, GenerateTimeLabelsFunction, TimeProfile, TimeProfileNode } from './v8-types';
+export declare const NON_JS_THREADS_FUNCTION_NAME = "Non JS threads activity";
+export declare const GARBAGE_COLLECTION_FUNCTION_NAME = "Garbage Collection";
+/**
+ * Controls how a frame's column number is represented in the emitted profile.
+ * - `'drop'`: omit the column; only the line number is emitted. This is the
+ *   default and matches the historical behavior and standard pprof line
+ *   semantics, so existing consumers see unchanged line numbers.
+ * - `'pack'`: pack the column into the high 32 bits of the line field
+ *   (`column << 32 | line`) — the encoding the Datadog deobfuscation backend
+ *   decodes (the same one the Chrome profile intake uses). Required to
+ *   deobfuscate single-line (bundled/minified) frames, where the column is the
+ *   only discriminator between functions.
+ *
+ * The enum leaves room for a future `'emit'` mode that would populate a real
+ * pprof `Line.column` field once the backend consumes it.
+ */
+export type ColumnNumbers = 'drop' | 'pack';
+export declare const DEFAULT_COLUMN_NUMBERS: ColumnNumbers;
+export declare function computeTotalHitCount(root: TimeProfileNode): number;
+/**
+ * Converts v8 time profile into into a profile proto.
+ * (https://github.com/google/pprof/blob/master/proto/profile.proto)
+ *
+ * @param prof - profile to be converted.
+ * @param intervalMicros - average time (microseconds) between samples.
+ */
+export declare function serializeTimeProfile(prof: TimeProfile, intervalMicros: number, sourceMapper?: SourceMapper, recomputeSamplingInterval?: boolean, generateLabels?: GenerateTimeLabelsFunction, lowCardinalityLabels?: string[], columnNumbers?: ColumnNumbers): Profile;
+/**
+ * Converts v8 heap profile into into a profile proto.
+ * (https://github.com/google/pprof/blob/master/proto/profile.proto)
+ *
+ * @param prof - profile to be converted.
+ * @param startTimeNanos - start time of profile, in nanoseconds (POSIX time).
+ * @param durationsNanos - duration of the profile (wall clock time) in
+ * nanoseconds.
+ * @param intervalBytes - bytes allocated between samples.
+ */
+export declare function serializeHeapProfile(prof: AllocationProfileNode | AllocationProfileNodeWithStats, startTimeNanos: number, intervalBytes: number, ignoreSamplesPath?: string, sourceMapper?: SourceMapper, generateLabels?: GenerateAllocationLabelsFunction, allocations?: boolean, columnNumbers?: ColumnNumbers): Profile;