@nativescript-community/sentry 3.1.5 → 4.6.1

package/tracing/nativeframes.d.ts

@@ -0,0 +1,68 @@
+import { Transaction } from '@sentry/tracing';
+import { EventProcessor, MeasurementUnit, Measurements } from '@sentry/types';
+export interface NativeFramesResponse {
+    totalFrames: number;
+    slowFrames: number;
+    frozenFrames: number;
+}
+export interface FramesMeasurements extends Measurements {
+    'frames_total': {
+        value: number;
+        unit: MeasurementUnit;
+    };
+    'frames_slow': {
+        value: number;
+        unit: MeasurementUnit;
+    };
+    'frames_frozen': {
+        value: number;
+        unit: MeasurementUnit;
+    };
+}
+/**
+ * Instrumentation to add native slow/frozen frames measurements onto transactions.
+ */
+export declare class NativeFramesInstrumentation {
+    /** The native frames at the transaction finish time, keyed by traceId. */
+    private _finishFrames;
+    /** The listeners for each native frames response, keyed by traceId */
+    private _framesListeners;
+    /** The native frames at the finish time of the most recent span. */
+    private _lastSpanFinishFrames?;
+    constructor(addGlobalEventProcessor: (e: EventProcessor) => void, doesExist: () => boolean);
+    /**
+   * To be called when a transaction is started.
+   * Logs the native frames at this start point and instruments child span finishes.
+   */
+    onTransactionStart(transaction: Transaction): void;
+    /**
+   * To be called when a transaction is finished
+   */
+    onTransactionFinish(transaction: Transaction): void;
+    /**
+   * Called on a span finish to fetch native frames to support transactions with trimEnd.
+   * Only to be called when a span does not have an end timestamp.
+   */
+    private _onSpanFinish;
+    /**
+   * Returns the computed frames measurements and awaits for them if they are not ready yet.
+   */
+    private _getFramesMeasurements;
+    /**
+   * Returns the computed frames measurements given ready data
+   */
+    private _prepareMeasurements;
+    /**
+   * Fetch finish frames for a transaction at the current time. Calls any awaiting listeners.
+   */
+    private _fetchFramesForTransaction;
+    /**
+   * On a finish frames failure, we cancel the await.
+   */
+    private _cancelFinishFrames;
+    /**
+   * Adds frames measurements to an event. Called from a valid event processor.
+   * Awaits for finish frames if needed.
+   */
+    private _processEvent;
+}

package/tracing/nativeframes.js

@@ -0,0 +1,175 @@
+import { logger, timestampInSeconds } from '@sentry/utils';
+import { NATIVE } from '../wrapper';
+import { instrumentChildSpanFinish } from './utils';
+/**
+ * A margin of error of 50ms is allowed for the async native bridge call.
+ * Anything larger would reduce the accuracy of our frames measurements.
+ */
+const MARGIN_OF_ERROR_SECONDS = 0.05;
+/**
+ * Instrumentation to add native slow/frozen frames measurements onto transactions.
+ */
+export class NativeFramesInstrumentation {
+    constructor(addGlobalEventProcessor, doesExist) {
+        /** The native frames at the transaction finish time, keyed by traceId. */
+        this._finishFrames = new Map();
+        /** The listeners for each native frames response, keyed by traceId */
+        this._framesListeners = new Map();
+        logger.log('[ReactNativeTracing] Native frames instrumentation initialized.');
+        addGlobalEventProcessor((event) => this._processEvent(event, doesExist));
+    }
+    /**
+   * To be called when a transaction is started.
+   * Logs the native frames at this start point and instruments child span finishes.
+   */
+    onTransactionStart(transaction) {
+        void NATIVE.fetchNativeFrames().then((framesMetrics) => {
+            if (framesMetrics) {
+                transaction.setData('__startFrames', framesMetrics);
+            }
+        });
+        instrumentChildSpanFinish(transaction, (_, endTimestamp) => {
+            if (!endTimestamp) {
+                this._onSpanFinish();
+            }
+        });
+    }
+    /**
+   * To be called when a transaction is finished
+   */
+    onTransactionFinish(transaction) {
+        void this._fetchFramesForTransaction(transaction);
+    }
+    /**
+   * Called on a span finish to fetch native frames to support transactions with trimEnd.
+   * Only to be called when a span does not have an end timestamp.
+   */
+    _onSpanFinish() {
+        const timestamp = timestampInSeconds();
+        void NATIVE.fetchNativeFrames().then((nativeFrames) => {
+            if (nativeFrames) {
+                this._lastSpanFinishFrames = {
+                    timestamp,
+                    nativeFrames,
+                };
+            }
+        });
+    }
+    /**
+   * Returns the computed frames measurements and awaits for them if they are not ready yet.
+   */
+    async _getFramesMeasurements(traceId, finalEndTimestamp, startFrames) {
+        if (this._finishFrames.has(traceId)) {
+            return this._prepareMeasurements(traceId, finalEndTimestamp, startFrames);
+        }
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                this._framesListeners.delete(traceId);
+                resolve(null);
+            }, 2000);
+            this._framesListeners.set(traceId, () => {
+                resolve(this._prepareMeasurements(traceId, finalEndTimestamp, startFrames));
+                clearTimeout(timeout);
+                this._framesListeners.delete(traceId);
+            });
+        });
+    }
+    /**
+   * Returns the computed frames measurements given ready data
+   */
+    _prepareMeasurements(traceId, finalEndTimestamp, // The actual transaction finish time.
+    startFrames) {
+        let finalFinishFrames;
+        const finish = this._finishFrames.get(traceId);
+        if (finish &&
+            finish.nativeFrames &&
+            // Must be in the margin of error of the actual transaction finish time (finalEndTimestamp)
+            Math.abs(finish.timestamp - finalEndTimestamp) < MARGIN_OF_ERROR_SECONDS) {
+            finalFinishFrames = finish.nativeFrames;
+        }
+        else if (this._lastSpanFinishFrames &&
+            Math.abs(this._lastSpanFinishFrames.timestamp - finalEndTimestamp) <
+                MARGIN_OF_ERROR_SECONDS) {
+            // Fallback to the last span finish if it is within the margin of error of the actual finish timestamp.
+            // This should be the case for trimEnd.
+            finalFinishFrames = this._lastSpanFinishFrames.nativeFrames;
+        }
+        else {
+            return null;
+        }
+        const measurements = {
+            frames_total: {
+                value: finalFinishFrames.totalFrames - startFrames.totalFrames,
+                unit: 'none'
+            },
+            frames_frozen: {
+                value: finalFinishFrames.frozenFrames - startFrames.frozenFrames,
+                unit: 'none'
+            },
+            frames_slow: {
+                value: finalFinishFrames.slowFrames - startFrames.slowFrames,
+                unit: 'none'
+            },
+        };
+        return measurements;
+    }
+    /**
+   * Fetch finish frames for a transaction at the current time. Calls any awaiting listeners.
+   */
+    async _fetchFramesForTransaction(transaction) {
+        var _a;
+        const startFrames = transaction.data.__startFrames;
+        // This timestamp marks when the finish frames were retrieved. It should be pretty close to the transaction finish.
+        const timestamp = timestampInSeconds();
+        let finishFrames = null;
+        if (startFrames) {
+            finishFrames = await NATIVE.fetchNativeFrames();
+        }
+        this._finishFrames.set(transaction.traceId, {
+            nativeFrames: finishFrames,
+            timestamp,
+        });
+        (_a = this._framesListeners.get(transaction.traceId)) === null || _a === void 0 ? void 0 : _a();
+        setTimeout(() => this._cancelFinishFrames(transaction), 2000);
+    }
+    /**
+   * On a finish frames failure, we cancel the await.
+   */
+    _cancelFinishFrames(transaction) {
+        if (this._finishFrames.has(transaction.traceId)) {
+            this._finishFrames.delete(transaction.traceId);
+            logger.log(`[NativeFrames] Native frames timed out for ${transaction.op} transaction ${transaction.name}. Not adding native frames measurements.`);
+        }
+    }
+    /**
+   * Adds frames measurements to an event. Called from a valid event processor.
+   * Awaits for finish frames if needed.
+   */
+    async _processEvent(event, doesExist) {
+        var _a, _b;
+        if (!doesExist()) {
+            return event;
+        }
+        if (event.type === 'transaction' &&
+            event.transaction &&
+            event.contexts &&
+            event.contexts.trace) {
+            const traceContext = event.contexts.trace;
+            const traceId = traceContext.trace_id;
+            if (traceId && ((_a = traceContext.data) === null || _a === void 0 ? void 0 : _a.__startFrames) && event.timestamp) {
+                const measurements = await this._getFramesMeasurements(traceId, event.timestamp, traceContext.data.__startFrames);
+                if (!measurements) {
+                    logger.log(`[NativeFrames] Could not fetch native frames for ${traceContext.op} transaction ${event.transaction}. Not adding native frames measurements.`);
+                }
+                else {
+                    logger.log(`[Measurements] Adding measurements to ${traceContext.op} transaction ${event.transaction}: ${JSON.stringify(measurements, undefined, 2)}`);
+                    event.measurements = Object.assign(Object.assign({}, ((_b = event.measurements) !== null && _b !== void 0 ? _b : {})), measurements);
+                    this._finishFrames.delete(traceId);
+                }
+                delete traceContext.data.__startFrames;
+            }
+        }
+        return event;
+    }
+}
+//# sourceMappingURL=nativeframes.js.map

package/tracing/nativeframes.js.map

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

package/tracing/nstracing.d.ts

@@ -1,65 +1,116 @@
-import { RequestInstrumentationOptions } from '@sentry/tracing';
-import { EventProcessor, Hub, Integration, TransactionContext } from '@sentry/types';
-export interface NSTracingOptions extends RequestInstrumentationOptions {
-    /**
-     * The time to wait in ms until the transaction will be finished. The transaction will use the end timestamp of
-     * the last finished span as the endtime for the transaction.
-     * Time is in ms.
-     *
-     * Default: 1000
-     */
+import { Hub } from '@sentry/hub';
+import { RequestInstrumentationOptions, Transaction } from '@sentry/tracing';
+import { EventProcessor, Integration } from '@sentry/types';
+import { RoutingInstrumentationInstance } from '../tracing/routingInstrumentation';
+import { NativeFramesInstrumentation } from './nativeframes';
+import { StallTrackingInstrumentation } from './stalltracking';
+import { BeforeNavigate } from './types';
+export interface NativescriptTracingOptions extends RequestInstrumentationOptions {
+    /**
+   * The time to wait in ms until the transaction will be finished. The transaction will use the end timestamp of
+   * the last finished span as the endtime for the transaction.
+   * Time is in ms.
+   *
+   * Default: 1000
+   */
     idleTimeout: number;
     /**
-     * The maximum duration of a transaction before it will be marked as "deadline_exceeded".
-     * If you never want to mark a transaction set it to 0.
-     * Time is in seconds.
-     *
-     * Default: 600
-     */
+   * The maximum duration of a transaction before it will be marked as "deadline_exceeded".
+   * If you never want to mark a transaction set it to 0.
+   * Time is in seconds.
+   *
+   * Default: 600
+   */
     maxTransactionDuration: number;
     /**
-     * The routing instrumentation to be used with the tracing integration.
-     * There is no routing instrumentation if nothing is passed.
-     */
-    /**
-     * Does not sample transactions that are from routes that have been seen any more and don't have any spans.
-     * This removes a lot of the clutter as most back navigation transactions are now ignored.
-     *
-     * Default: true
-     */
-    ignoreEmptyBackNavigationTransactions?: boolean;
-    /**
-     * beforeNavigate is called before a navigation transaction is created and allows users to modify transaction
-     * context data, or drop the transaction entirely (by setting `sampled = false` in the context).
-     *
-     * @param context: The context data which will be passed to `startTransaction` by default
-     *
-     * @returns A (potentially) modified context object, with `sampled = false` if the transaction should be dropped.
-     */
-    beforeNavigate?(context: TransactionContext): TransactionContext;
+   * The routing instrumentation to be used with the tracing integration.
+   * There is no routing instrumentation if nothing is passed.
+   */
+    routingInstrumentation?: RoutingInstrumentationInstance;
+    /**
+   * Does not sample transactions that are from routes that have been seen any more and don't have any spans.
+   * This removes a lot of the clutter as most back navigation transactions are now ignored.
+   *
+   * Default: true
+   */
+    ignoreEmptyBackNavigationTransactions: boolean;
+    /**
+   * beforeNavigate is called before a navigation transaction is created and allows users to modify transaction
+   * context data, or drop the transaction entirely (by setting `sampled = false` in the context).
+   *
+   * @param context: The context data which will be passed to `startTransaction` by default
+   *
+   * @returns A (potentially) modified context object, with `sampled = false` if the transaction should be dropped.
+   */
+    beforeNavigate: BeforeNavigate;
+    /**
+   * Track the app start time by adding measurements to the first route transaction. If there is no routing instrumentation
+   * an app start transaction will be started.
+   *
+   * Default: true
+   */
+    enableAppStartTracking: boolean;
+    /**
+   * Track slow/frozen frames from the native layer and adds them as measurements to all transactions.
+   */
+    enableNativeFramesTracking: boolean;
+    /**
+   * Track when and how long the JS event loop stalls for. Adds stalls as measurements to all transactions.
+   */
+    enableStallTracking: boolean;
 }
 /**
-   * Tracing integration for React Native.
-   */
-export declare class NSTracing implements Integration {
+ * Tracing integration for React Native.
+ */
+export declare class NativescriptTracing implements Integration {
     /**
-     * @inheritDoc
-     */
+   * @inheritDoc
+   */
     static id: string;
     /**
-     * @inheritDoc
-     */
+   * @inheritDoc
+   */
     name: string;
-    /** NSTracing options */
-    options: NSTracingOptions;
+    /** NativescriptTracing options */
+    options: NativescriptTracingOptions;
+    nativeFramesInstrumentation?: NativeFramesInstrumentation;
+    stallTrackingInstrumentation?: StallTrackingInstrumentation;
+    useAppStartWithProfiler: boolean;
     private _getCurrentHub?;
-    constructor(options?: Partial<NSTracingOptions>);
+    private _awaitingAppStartData?;
+    private _appStartFinishTimestamp?;
+    constructor(options?: Partial<NativescriptTracingOptions>);
     /**
-     *  Registers routing and request instrumentation.
-     */
+   *  Registers routing and request instrumentation.
+   */
     setupOnce(addGlobalEventProcessor: (callback: EventProcessor) => void, getCurrentHub: () => Hub): void;
+    /**
+   * To be called on a transaction start. Can have async methods
+   */
+    onTransactionStart(transaction: Transaction): void;
+    /**
+   * To be called on a transaction finish. Cannot have async methods.
+   */
+    onTransactionFinish(transaction: Transaction, endTimestamp?: number): void;
+    /**
+   * Called by the NativescriptProfiler component on first component mount.
+   */
+    onAppStartFinish(endTimestamp: number): void;
+    /**
+   * Instruments the app start measurements on the first route transaction.
+   * Starts a route transaction if there isn't routing instrumentation.
+   */
+    private _instrumentAppStart;
+    /**
+   * Adds app start measurements and starts a child span on a transaction.
+   */
+    private _addAppStartData;
     /** To be called when the route changes, but BEFORE the components of the new route mount. */
     private _onRouteWillChange;
+    /**
+   * Creates a breadcrumb and sets the current route as a tag.
+   */
+    private _onConfirmRoute;
     /** Create routing idle transaction. */
     private _createRouteTransaction;
 }