@coralogix/browser 3.7.0 → 3.8.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 3.8.0 (2026-04-27)
+
+### 🚀 Features
+
+- Add support for excluding specific instrumentations from session sampling
+
+## 3.7.1 (2026-04-26)
+
+### 🩹 Fixes
+
+- Support error logging for non-JSON-serializable error properties
+
 ## 3.7.0 (2026-04-19)
 
 ### 🚀 Features

package/README.md

@@ -9,7 +9,8 @@
 
    - [Basic Sampling](#1-basic-sampling---sample--of-all-sessions)
    - [Advanced Sampling](#2-advanced-sampling---sample--of-sessions-but-always-track-sessions-with-errors)
-   - [Only Sessions with Errors](#3-only-sessions-with-errors)
+   - [Exclude Specific Instrumentations from Sampling](#3-exclude-specific-instrumentations-from-sampling)
+   - [Only Sessions with Errors](#4-only-sessions-with-errors)
 
 6. [Sending Custom Logs](#sending-custom-logs)
 7. [Instrumentations](#instrumentations)
@@ -162,7 +163,21 @@ CoralogixRum.init({
 });
 ```
 
-#### 3. Only Sessions with Errors
+#### 3. Exclude Specific Instrumentations from Sampling
+
+Keep specific instrumentations running at 100% even when sessions are sampled out. This is useful when you want to reduce data volume with sampling but still capture all errors or custom logs.
+
+```javascript
+CoralogixRum.init({
+  // ...
+  sessionConfig: {
+    sessionSampleRate: 20, // Only 20% of sessions are fully tracked
+    excludeFromSampling: ['custom'], // These will run at 100% regardless of sampling
+  },
+});
+```
+
+#### 4. Only Sessions with Errors
 
 Track only sessions with errors, and send specific instrumentation data immediately even if error is not occurred.
 From Session recording perspective, the SDK will record approximately 10–60s(according to maxRecordTime property) before the error occurred.

package/index.esm2.js

@@ -220,6 +220,7 @@ var DEFAULT_SESSION_CONFIG = {
     onlyWithErrorConfig: {
         enable: false,
     },
+    excludeFromSampling: [],
 };
 var SESSION_IDLE_TIME = 15 * millisecondsPerMinute;
 var SESSION_EXPIRATION_TIME = MILLISECONDS_PER_HOUR;
@@ -555,7 +556,12 @@ var CoralogixErrorInstrumentation = (function (_super) {
         var _this = _super.call(this, ERROR_INSTRUMENTATION_NAME, ERROR_INSTRUMENTATION_VERSION, config) || this;
         _this.parseErrorObject = function (obj) {
             var _a;
-            return (_a = obj === null || obj === void 0 ? void 0 : obj.message) !== null && _a !== void 0 ? _a : JSON.stringify(obj, getCircularReplacer());
+            try {
+                return (_a = obj === null || obj === void 0 ? void 0 : obj.message) !== null && _a !== void 0 ? _a : JSON.stringify(obj, getCircularReplacer());
+            }
+            catch (_b) {
+                return obj === null || obj === void 0 ? void 0 : obj.toString();
+            }
         };
         if (getSdkConfig().supportMfe) {
             CxGlobal[CACHED_METADATA_KEY] = new Map();
@@ -3385,13 +3391,19 @@ var Request = (function () {
     return Request;
 }());
 
+var PROPAGATE_ONLY = { decision: SamplingDecision.RECORD };
+var EXPORT = { decision: SamplingDecision.RECORD_AND_SAMPLED };
 var CxCustomSampler = (function () {
     function CxCustomSampler() {
     }
-    CxCustomSampler.prototype.shouldSample = function () {
-        return {
-            decision: SamplingDecision.RECORD,
-        };
+    CxCustomSampler.prototype.shouldSample = function (_context, _traceId, _spanName, _spanKind, attributes) {
+        var _a, _b;
+        var excluded = (_b = (_a = getSdkConfig().sessionConfig) === null || _a === void 0 ? void 0 : _a.excludeFromSampling) !== null && _b !== void 0 ? _b : [];
+        var isHttpSpan = Boolean(attributes['http.method']);
+        if (isHttpSpan) {
+            return excluded.includes('fetch') || excluded.includes('xhr') ? EXPORT : PROPAGATE_ONLY;
+        }
+        return excluded.length > 0 ? EXPORT : PROPAGATE_ONLY;
     };
     return CxCustomSampler;
 }());
@@ -3441,28 +3453,61 @@ var isSessionWithError = function () {
     var _a = getSessionManager(), onlySessionWithErrorMode = _a.onlySessionWithErrorMode, cachedLogsSent = _a.cachedLogsSent;
     return onlySessionWithErrorMode && !cachedLogsSent;
 };
-function getResolvedSampler(resolvedOptions) {
-    var sampler = new AlwaysOnSampler();
-    var sessionSampleRate = resolvedOptions.sessionSampleRate, sessionConfig = resolvedOptions.sessionConfig, debug = resolvedOptions.debug, sessionRecordingConfig = resolvedOptions.sessionRecordingConfig;
+function getResolvedSampler() {
+    var config = getSdkConfig();
+    var sessionSampleRate = config.sessionSampleRate, sessionConfig = config.sessionConfig;
     var shouldNotTrackSession = !isSamplingOn(sessionSampleRate) ||
         !isSamplingOn(sessionConfig.sessionSampleRate);
     if (shouldNotTrackSession) {
-        var shouldAlwaysTrackSessionsWithErrors = sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.alwaysTrackSessionsWithErrors;
-        if (shouldAlwaysTrackSessionsWithErrors) {
-            sessionConfig.onlyWithErrorConfig = __assign(__assign({}, sessionConfig.onlyWithErrorConfig), { enable: true });
+        if (sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.alwaysTrackSessionsWithErrors) {
+            return enableErrorOnlyMode();
         }
-        else {
-            if (debug) {
-                console.debug('CoralogixRum: Session tracking is disabled due to sampling rate');
-            }
-            sampler = new CxCustomSampler();
-            if (sessionRecordingConfig) {
-                sessionRecordingConfig.enable = false;
-            }
-            resolvedOptions.instrumentations = __assign(__assign({}, resolvedOptions.instrumentations), { errors: false, custom: false, web_vitals: false, interactions: false, long_tasks: false, resources: false });
+        return handleDroppedSession();
+    }
+    return new AlwaysOnSampler();
+}
+function enableErrorOnlyMode() {
+    var sessionConfig = getSdkConfig().sessionConfig;
+    if (sessionConfig) {
+        sessionConfig.onlyWithErrorConfig = __assign(__assign({}, sessionConfig.onlyWithErrorConfig), { enable: true });
+    }
+    return new AlwaysOnSampler();
+}
+function handleDroppedSession() {
+    var e_1, _a;
+    var _b, _c;
+    var config = getSdkConfig();
+    var sessionRecordingConfig = config.sessionRecordingConfig, sessionConfig = config.sessionConfig, debug = config.debug;
+    if (debug) {
+        console.log('CoralogixRum: Session tracking is disabled due to sampling rate');
+    }
+    if (sessionRecordingConfig) {
+        sessionRecordingConfig.enable = false;
+    }
+    var excluded = (_b = sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.excludeFromSampling) !== null && _b !== void 0 ? _b : [];
+    var nonHttpInstrumentations = [
+        'errors',
+        'custom',
+        'web_vitals',
+        'interactions',
+        'long_tasks',
+        'resources',
+    ];
+    (_c = config.instrumentations) !== null && _c !== void 0 ? _c : (config.instrumentations = {});
+    try {
+        for (var nonHttpInstrumentations_1 = __values$1(nonHttpInstrumentations), nonHttpInstrumentations_1_1 = nonHttpInstrumentations_1.next(); !nonHttpInstrumentations_1_1.done; nonHttpInstrumentations_1_1 = nonHttpInstrumentations_1.next()) {
+            var key = nonHttpInstrumentations_1_1.value;
+            config.instrumentations[key] = excluded.includes(key);
         }
     }
-    return sampler;
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (nonHttpInstrumentations_1_1 && !nonHttpInstrumentations_1_1.done && (_a = nonHttpInstrumentations_1.return)) _a.call(nonHttpInstrumentations_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return new CxCustomSampler();
 }
 
 function isProcessorShouldStop(isActive) {
@@ -4225,7 +4270,7 @@ function resolveUrlBlueprinters(urlBlueprinters) {
     return resolvedUrlBlueprinters;
 }
 
-var SDK_VERSION = '3.7.0';
+var SDK_VERSION = '3.8.0';
 
 function shouldDropEvent(cxRumEvent, options) {
     if (isDocumentErrorWithoutMessage(cxRumEvent)) {
@@ -4841,7 +4886,7 @@ var CoralogixRum = {
             }
             CxGlobal[USER_AGENT_KEY] = parseUserAgent(navigator.userAgent);
             CxGlobal[SDK_CONFIG_KEY] = resolvedOptions_1;
-            var sampler = getResolvedSampler(resolvedOptions_1);
+            var sampler = getResolvedSampler();
             if (!resolvedOptions_1.debug && !resolvedOptions_1.public_key) {
                 console.warn('rumAuth will be required in the future');
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralogix/browser",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "description": "Official Coralogix SDK for browsers",
   "license": "Apache-2.0",
   "author": "Coralogix",

package/src/index.d.ts

@@ -3,3 +3,4 @@ export { CoralogixLogSeverity } from './types-external';
 export { UrlBasedLabelProvider } from './label-providers/url-based-label-provider';
 export * from './types';
 export { SessionRecordingEventType, type RecordEvent, type RecordPluginEvent, } from './session/session.model';
+export type { ExcludableInstrumentation } from './session/session.consts';

package/src/otel/custom-sampler.d.ts

@@ -1,4 +1,5 @@
+import { Attributes } from '@opentelemetry/api';
 import { Sampler, SamplingResult } from '@opentelemetry/sdk-trace-base';
 export declare class CxCustomSampler implements Sampler {
-    shouldSample(): SamplingResult;
+    shouldSample(_context: unknown, _traceId: string, _spanName: string, _spanKind: unknown, attributes: Attributes): SamplingResult;
 }

package/src/session/session.consts.d.ts

@@ -1,4 +1,5 @@
 import { SessionConfig } from './session.model';
+import { CoralogixOtelWebOptionsInstrumentations } from '../types';
 export declare const MAX_BATCH_TIME_MS: number;
 export declare const SESSION_RECORDING_DEFAULT_HEADERS: Record<string, string>;
 export declare const SESSION_RECORDING_DEFAULT_ERROR_MESSAGE: string;
@@ -9,6 +10,7 @@ export declare const SESSION_KEY: string;
 export declare const PREV_SESSION_KEY: string;
 export declare const MUTATION_LIMIT: number;
 export declare const DEFAULT_SESSION_CONFIG: SessionConfig;
+export type ExcludableInstrumentation = keyof CoralogixOtelWebOptionsInstrumentations;
 export declare const SESSION_IDLE_TIME: number;
 export declare const SESSION_EXPIRATION_TIME: number;
 export declare const SESSION_MANAGER_KEY = "rumSessionManager";

package/src/session/session.helper.d.ts

@@ -1,8 +1,7 @@
 import { SessionConfig, SessionRecordingConfig } from './session.model';
-import { CoralogixBrowserSdkConfig } from '../types';
 import { AlwaysOnSampler, Sampler } from '@opentelemetry/sdk-trace-base';
 export declare function resolveSessionConfig(config: SessionConfig | undefined): SessionConfig;
 export declare function resolveSessionRecordingConfig(config: SessionRecordingConfig | undefined): SessionRecordingConfig | undefined;
 export declare function isSamplingOn(threshold: number): boolean;
 export declare const isSessionWithError: () => boolean;
-export declare function getResolvedSampler(resolvedOptions: CoralogixBrowserSdkConfig): AlwaysOnSampler | Sampler;
+export declare function getResolvedSampler(): AlwaysOnSampler | Sampler;

package/src/session/session.model.d.ts

@@ -2,6 +2,7 @@ import { eventWithTime } from '../cx-rrweb/rrweb-types';
 import { SlimDOMOptions } from '../cx-rrweb/rrweb-snapshot';
 import { CoralogixEventType } from '../types';
 import { recordOptions } from '../cx-rrweb/rrweb';
+import type { ExcludableInstrumentation } from './session.consts';
 export interface SessionRecordingConfig extends Omit<recordOptions<eventWithTime>, 'emit' | 'packFn' | 'plugins' | 'hooks' | 'slimDOMOptions'> {
     enable: boolean;
     autoStartSessionRecording: boolean;
@@ -23,6 +24,7 @@ export interface SessionConfig {
     alwaysTrackSessionsWithErrors?: boolean;
     onlyWithErrorConfig?: SessionWithErrorConfig;
     keepSessionAfterReload?: boolean;
+    excludeFromSampling?: ExcludableInstrumentation[];
 }
 export type RecordEvent = eventWithTime;
 export type RecordPluginEvent<T = any> = {

package/src/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.7.0";
+export declare const SDK_VERSION = "3.8.0";