@newrelic/browser-agent 1.260.1 → 1.261.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.261.0](https://github.com/newrelic/newrelic-browser-agent/compare/v1.260.1...v1.261.0) (2024-06-26)
+
+
+### Features
+
+* Add Logging API entry points and central handler ([#1052](https://github.com/newrelic/newrelic-browser-agent/issues/1052)) ([face445](https://github.com/newrelic/newrelic-browser-agent/commit/face4457f2ec29699b610cb096864ee3a16aafdc))
+* Add Logging Configurations ([#1058](https://github.com/newrelic/newrelic-browser-agent/issues/1058)) ([3c4ea26](https://github.com/newrelic/newrelic-browser-agent/commit/3c4ea262b30b48afc434f8ccdce867b1a5acb874))
+* Add wrapLogger API method for wrapping 3rd party loggers ([#1054](https://github.com/newrelic/newrelic-browser-agent/issues/1054)) ([3713d73](https://github.com/newrelic/newrelic-browser-agent/commit/3713d73716f24c9bfb4154a664c2696296f7150e))
+* Create logging feature ([#1059](https://github.com/newrelic/newrelic-browser-agent/issues/1059)) ([c573e33](https://github.com/newrelic/newrelic-browser-agent/commit/c573e330ea5e7dd97e7293b0f95785cb738cf3f2))
+* Logging feature harvesting and optimizations ([#1064](https://github.com/newrelic/newrelic-browser-agent/issues/1064)) ([9a9fad5](https://github.com/newrelic/newrelic-browser-agent/commit/9a9fad5fe10536e72d5b55374363f727b6ae0c43))
+* Pass logging API args as object for better extensibility ([#1074](https://github.com/newrelic/newrelic-browser-agent/issues/1074)) ([8fbd25a](https://github.com/newrelic/newrelic-browser-agent/commit/8fbd25a6de3e5c48869f9cae564d86cf36cc364c))
+
+
+### Bug Fixes
+
+* dedup pre-load ajax requests ([#1081](https://github.com/newrelic/newrelic-browser-agent/issues/1081)) ([9f95b33](https://github.com/newrelic/newrelic-browser-agent/commit/9f95b339248d7597ce489546e9f04d68053fe7d1))
+* Prevent session reset triggers from harvesting session trace data ([#1050](https://github.com/newrelic/newrelic-browser-agent/issues/1050)) ([bec022b](https://github.com/newrelic/newrelic-browser-agent/commit/bec022b57ffa2cb23353272b667727f631e76b63))
+* Reading finish of null in SPA ([#1085](https://github.com/newrelic/newrelic-browser-agent/issues/1085)) ([df874f7](https://github.com/newrelic/newrelic-browser-agent/commit/df874f72c1a7668098c855eea718b1d0ceda7a7c))
+
 ## [1.260.1](https://github.com/newrelic/newrelic-browser-agent/compare/v1.260.0...v1.260.1) (2024-05-16)
 
 

package/dist/cjs/cdn/experimental.js

@@ -10,6 +10,7 @@ var _instrument6 = require("../features/session_trace/instrument");
 var _instrument7 = require("../features/session_replay/instrument");
 var _instrument8 = require("../features/soft_navigations/instrument");
 var _instrument9 = require("../features/page_action/instrument");
+var _instrument10 = require("../features/logging/instrument");
 /*
  * Copyright 2023 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
@@ -24,7 +25,7 @@ var _instrument9 = require("../features/page_action/instrument");
 // import { Instrument as InstrumentSpa } from '../features/spa/instrument'
 
 new _agent.Agent({
-  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument3.Instrument, _instrument9.Instrument, _instrument4.Instrument,
+  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument3.Instrument, _instrument9.Instrument, _instrument4.Instrument, _instrument10.Instrument,
   // InstrumentSpa,
   _instrument8.Instrument],
   loaderType: 'experimental'

package/dist/cjs/cdn/polyfills/pro.js

@@ -9,12 +9,13 @@ var _instrument4 = require("../../features/jserrors/instrument");
 var _instrument5 = require("../../features/ajax/instrument");
 var _instrument6 = require("../../features/session_trace/instrument");
 var _instrument7 = require("../../features/page_action/instrument");
+var _instrument8 = require("../../features/logging/instrument");
 /**
  * @file Creates a version of the "PRO" agent loader with [core-js]{@link https://github.com/zloirock/core-js}
  * polyfills for pre-ES6 browsers and IE 11.
  */
 
 new _agent.Agent({
-  features: [_instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument5.Instrument, _instrument3.Instrument, _instrument7.Instrument, _instrument4.Instrument],
+  features: [_instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument5.Instrument, _instrument3.Instrument, _instrument7.Instrument, _instrument4.Instrument, _instrument8.Instrument],
   loaderType: 'pro-polyfills'
 });

package/dist/cjs/cdn/polyfills/spa.js

@@ -10,12 +10,13 @@ var _instrument5 = require("../../features/ajax/instrument");
 var _instrument6 = require("../../features/session_trace/instrument");
 var _instrument7 = require("../../features/spa/instrument");
 var _instrument8 = require("../../features/page_action/instrument");
+var _instrument9 = require("../../features/logging/instrument");
 /**
  * @file Creates a version of the "SPA" agent loader with [core-js]{@link https://github.com/zloirock/core-js}
  * polyfills for pre-ES6 browsers and IE 11.
  */
 
 new _agent.Agent({
-  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument3.Instrument, _instrument8.Instrument, _instrument4.Instrument, _instrument7.Instrument],
+  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument3.Instrument, _instrument8.Instrument, _instrument4.Instrument, _instrument9.Instrument, _instrument7.Instrument],
   loaderType: 'spa-polyfills'
 });

package/dist/cjs/cdn/pro.js

@@ -9,12 +9,13 @@ var _instrument5 = require("../features/ajax/instrument");
 var _instrument6 = require("../features/session_trace/instrument");
 var _instrument7 = require("../features/session_replay/instrument");
 var _instrument8 = require("../features/page_action/instrument");
+var _instrument9 = require("../features/logging/instrument");
 /**
  * @file Creates a "Pro" agent loader bundle composed of the core Agent and all available feature modules except `spa`.
  * This excludes collection of BrowserInteraction and BrowserTiming events.
  */
 
 new _agent.Agent({
-  features: [_instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument5.Instrument, _instrument3.Instrument, _instrument8.Instrument, _instrument4.Instrument],
+  features: [_instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument5.Instrument, _instrument3.Instrument, _instrument8.Instrument, _instrument4.Instrument, _instrument9.Instrument],
   loaderType: 'pro'
 });

package/dist/cjs/cdn/spa.js

@@ -11,12 +11,13 @@ var _instrument7 = require("../features/session_replay/instrument");
 var _instrument8 = require("../features/soft_navigations/instrument");
 var _instrument9 = require("../features/spa/instrument");
 var _instrument10 = require("../features/page_action/instrument");
+var _instrument11 = require("../features/logging/instrument");
 /**
  * @file Creates a "SPA" agent loader bundle composed of the core agent and all available feature modules.
  */
 
 new _agent.Agent({
-  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument3.Instrument, _instrument10.Instrument, _instrument4.Instrument, _instrument8.Instrument, _instrument9.Instrument // either the softnav or the old spa will be used (not both), but we still need to pack both to avoid dynamic import for instrument files
+  features: [_instrument5.Instrument, _instrument.Instrument, _instrument2.Instrument, _instrument6.Instrument, _instrument7.Instrument, _instrument3.Instrument, _instrument10.Instrument, _instrument4.Instrument, _instrument11.Instrument, _instrument8.Instrument, _instrument9.Instrument // either the softnav or the old spa will be used (not both), but we still need to pack both to avoid dynamic import for instrument files
   ],
   loaderType: 'spa'
 });

package/dist/cjs/common/config/state/init.js

@@ -6,8 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.getConfiguration = getConfiguration;
 exports.getConfigurationValue = getConfigurationValue;
 exports.setConfiguration = setConfiguration;
+var _constants = require("../../../features/logging/constants");
 var _querySelector = require("../../dom/query-selector");
-var _constants = require("../../session/constants");
+var _constants2 = require("../../session/constants");
 var _console = require("../../util/console");
 var _nreum = require("../../window/nreum");
 var _configurable = require("./configurable");
@@ -37,16 +38,6 @@ const model = () => {
     }
   };
   return {
-    feature_flags: [],
-    proxy: {
-      assets: undefined,
-      // if this value is set, it will be used to overwrite the webpack asset path used to fetch assets
-      beacon: undefined // likewise for the url to which we send analytics
-    },
-    privacy: {
-      cookies_enabled: true
-    },
-    // *cli - per discussion, default should be true
     ajax: {
       deny_list: undefined,
       block_internal: true,
@@ -61,21 +52,26 @@ const model = () => {
       cors_use_tracecontext_headers: undefined,
       allowed_origins: undefined
     },
-    session: {
-      expiresMs: _constants.DEFAULT_EXPIRES_MS,
-      inactiveMs: _constants.DEFAULT_INACTIVE_MS
+    feature_flags: [],
+    harvest: {
+      tooManyRequestsDelay: 60
     },
-    ssl: undefined,
-    obfuscate: undefined,
     jserrors: {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
     },
+    logging: {
+      enabled: true,
+      harvestTimeSeconds: 10,
+      autoStart: true,
+      level: _constants.LOG_LEVELS.INFO
+    },
     metrics: {
       enabled: true,
       autoStart: true
     },
+    obfuscate: undefined,
     page_action: {
       enabled: true,
       harvestTimeSeconds: 30,
@@ -91,13 +87,18 @@ const model = () => {
       long_task: false,
       autoStart: true
     },
-    session_trace: {
-      enabled: true,
-      harvestTimeSeconds: 10,
-      autoStart: true
+    privacy: {
+      cookies_enabled: true
     },
-    harvest: {
-      tooManyRequestsDelay: 60
+    // *cli - per discussion, default should be true
+    proxy: {
+      assets: undefined,
+      // if this value is set, it will be used to overwrite the webpack asset path used to fetch assets
+      beacon: undefined // likewise for the url to which we send analytics
+    },
+    session: {
+      expiresMs: _constants2.DEFAULT_EXPIRES_MS,
+      inactiveMs: _constants2.DEFAULT_INACTIVE_MS
     },
     session_replay: {
       // feature settings
@@ -154,7 +155,7 @@ const model = () => {
         };else (0, _console.warn)('An invalid session_replay.mask_input_option was provided and will not be used', val);
       }
     },
-    spa: {
+    session_trace: {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
@@ -163,7 +164,13 @@ const model = () => {
       enabled: true,
       harvestTimeSeconds: 10,
       autoStart: true
-    }
+    },
+    spa: {
+      enabled: true,
+      harvestTimeSeconds: 10,
+      autoStart: true
+    },
+    ssl: undefined
   };
 };
 const _cache = {};

package/dist/cjs/common/constants/env.cdn.js

@@ -12,7 +12,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.260.1";
+const VERSION = exports.VERSION = "1.261.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/constants/env.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_ENV = void 0;
 var _package = _interopRequireDefault(require("../../../package.json"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * @file This file exposes build time environment variables that will be included in the
  * build output of the agent. This file specifically contains the normal environment variables

package/dist/cjs/common/constants/env.npm.js

@@ -12,7 +12,7 @@ exports.VERSION = exports.RRWEB_VERSION = exports.DIST_METHOD = exports.BUILD_EN
 /**
  * Exposes the version of the agent
  */
-const VERSION = exports.VERSION = "1.260.1";
+const VERSION = exports.VERSION = "1.261.0";
 
 /**
  * Exposes the build type of the agent

package/dist/cjs/common/deny-list/deny-list.js

@@ -18,7 +18,7 @@ var denyList = [];
  * @returns {boolean} `true` if request does not match any entries of {@link denyList|deny list}; else `false`
  */
 function shouldCollectEvent(params) {
-  if (hasUndefinedHostname(params)) return false;
+  if (!params || hasUndefinedHostname(params)) return false;
   if (denyList.length === 0) return true;
   for (var i = 0; i < denyList.length; i++) {
     var parsed = denyList[i];

package/dist/cjs/common/harvest/harvest-scheduler.js

@@ -10,7 +10,7 @@ var _harvest = require("./harvest");
 var _eol = require("../unload/eol");
 var _constants = require("../session/constants");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /*
  * Copyright 2020 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0

package/dist/cjs/common/harvest/harvest.js

@@ -19,7 +19,7 @@ var _runtime = require("../constants/runtime");
 var _console = require("../util/console");
 var _now = require("../timing/now");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /*
  * Copyright 2020 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0

package/dist/cjs/common/session/session-entity.js

@@ -58,7 +58,13 @@ class SessionEntity {
     this.ee = _contextualEe.ee.get(agentIdentifier);
     (0, _wrap.wrapEvents)(this.ee);
     this.setup(opts);
-    if (_runtime.isBrowserScope) {
+
+    /**
+     * Do not emit session storage events for IE11, because IE11 is unable to determine
+     * if the event was spawned on the current page or an adjacent page, and the behavior tied
+     * to storage events is critical to apply only to cross-tab behavior
+     * */
+    if (_runtime.isBrowserScope && !_runtime.isIE) {
       (0, _eventListenerOpts.windowAddEventListener)('storage', event => {
         if (event.key === this.lookupKey) {
           const obj = typeof event.newValue === 'string' ? JSON.parse(event.newValue) : event.newValue;

package/dist/cjs/common/wrap/wrap-logger.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.scopedEE = scopedEE;
+exports.wrapLogger = wrapLogger;
+var _contextualEe = require("../event-emitter/contextual-ee");
+var _eventContext = require("../event-emitter/event-context");
+var _wrapFunction = require("./wrap-function");
+/*
+ * Copyright 2020 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @file Wraps native timeout and interval methods for instrumentation.
+ * This module is used by: jserrors, spa.
+ */
+
+/**
+ * Wraps a supplied function and adds emitter events under the `-wrap-logger-` prefix
+ * @param {Object} sharedEE - The shared event emitter on which a new scoped event emitter will be based.
+ * @param {Object} parent - The parent object housing the logger function
+ * @param {string} loggerFn - The name of the function in the parent object to wrap
+ * @returns {Object} Scoped event emitter with a debug ID of `logger`.
+ */
+// eslint-disable-next-line
+function wrapLogger(sharedEE, parent, loggerFn, context) {
+  const ee = scopedEE(sharedEE);
+  const wrapFn = (0, _wrapFunction.createWrapperWithEmitter)(ee);
+
+  /**
+   * This section contains the context that will be shared across all invoked calls of the wrapped function,
+   * which will be used to decorate the log data later at agg time
+  */
+  const ctx = new _eventContext.EventContext(_contextualEe.contextId);
+  ctx.level = context.level;
+  ctx.customAttributes = context.customAttributes;
+
+  /** observe calls to <loggerFn> and emit events prefixed with `wrap-logger-` */
+  wrapFn.inPlace(parent, [loggerFn], 'wrap-logger-', ctx);
+  return ee;
+}
+
+/**
+ * Returns an event emitter scoped specifically for the `logger` context. This scoping is a remnant from when all the
+ * features shared the same group in the event, to isolate events between features. It will likely be revisited.
+ * @param {Object} sharedEE - Optional event emitter on which to base the scoped emitter.
+ *     Uses `ee` on the global scope if undefined).
+ * @returns {Object} Scoped event emitter with a debug ID of 'logger'.
+ */
+function scopedEE(sharedEE) {
+  return (sharedEE || _contextualEe.ee).get('logger');
+}

package/dist/cjs/features/ajax/aggregate/index.js

@@ -17,7 +17,7 @@ var _aggregateBase = require("../../utils/aggregate-base");
 var _gql = require("./gql");
 var _nreum = require("../../../common/window/nreum");
 var _chunk = _interopRequireDefault(require("./chunk"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /*
  * Copyright 2020 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0

package/dist/cjs/features/logging/aggregate/index.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Aggregate = void 0;
+var _config = require("../../../common/config/config");
+var _handle = require("../../../common/event-emitter/handle");
+var _registerHandler = require("../../../common/event-emitter/register-handler");
+var _harvestScheduler = require("../../../common/harvest/harvest-scheduler");
+var _console = require("../../../common/util/console");
+var _stringify = require("../../../common/util/stringify");
+var _constants = require("../../metrics/constants");
+var _aggregateBase = require("../../utils/aggregate-base");
+var _constants2 = require("../constants");
+var _log = require("../shared/log");
+class Aggregate extends _aggregateBase.AggregateBase {
+  static featureName = _constants2.FEATURE_NAME;
+  #agentRuntime;
+  #agentInfo;
+  constructor(agentIdentifier, aggregator) {
+    super(agentIdentifier, aggregator, _constants2.FEATURE_NAME);
+
+    /** held logs before sending */
+    this.bufferedLogs = [];
+    /** held logs during sending, for retries */
+    this.outgoingLogs = [];
+    /** the estimated bytes of log data waiting to be sent -- triggers a harvest if adding a new log will exceed limit  */
+    this.estimatedBytes = 0;
+    this.#agentRuntime = (0, _config.getRuntime)(this.agentIdentifier);
+    this.#agentInfo = (0, _config.getInfo)(this.agentIdentifier);
+    this.harvestTimeSeconds = (0, _config.getConfigurationValue)(this.agentIdentifier, 'logging.harvestTimeSeconds');
+    this.waitForFlags([]).then(() => {
+      this.scheduler = new _harvestScheduler.HarvestScheduler('browser/logs', {
+        onFinished: this.onHarvestFinished.bind(this),
+        retryDelay: this.harvestTimeSeconds,
+        getPayload: this.prepareHarvest.bind(this),
+        raw: true
+      }, this);
+      /** harvest immediately once started to purge pre-load logs collected */
+      this.scheduler.startTimer(this.harvestTimeSeconds, 0);
+      /** emitted by instrument class (wrapped loggers) or the api methods directly */
+      (0, _registerHandler.registerHandler)(_constants2.LOGGING_EVENT_EMITTER_CHANNEL, this.handleLog.bind(this), this.featureName, this.ee);
+      this.drain();
+    });
+  }
+  handleLog(timestamp, message, attributes, level) {
+    if (this.blocked) return;
+    const log = new _log.Log(this.#agentRuntime.timeKeeper.convertRelativeTimestamp(timestamp), message, attributes, level);
+    const logBytes = log.message.length + (0, _stringify.stringify)(log.attributes).length + log.level.length + 10; // timestamp == 10 chars
+    if (logBytes > _constants2.MAX_PAYLOAD_SIZE) {
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Failed/Seen', logBytes]);
+      return (0, _console.warn)(_constants2.LOGGING_IGNORED + '> ' + _constants2.MAX_PAYLOAD_SIZE + ' bytes', log.message.slice(0, 25) + '...');
+    }
+    if (this.estimatedBytes + logBytes >= _constants2.MAX_PAYLOAD_SIZE) {
+      (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ['Logging/Harvest/Early/Seen', this.estimatedBytes + logBytes]);
+      this.scheduler.runHarvest({});
+    }
+    this.estimatedBytes += logBytes;
+    this.bufferedLogs.push(log);
+  }
+  prepareHarvest() {
+    if (this.blocked || !(this.bufferedLogs.length || this.outgoingLogs.length)) return;
+    /** populate outgoing array while also clearing main buffer */
+    this.outgoingLogs.push(...this.bufferedLogs.splice(0));
+    this.estimatedBytes = 0;
+    /** see https://source.datanerd.us/agents/rum-specs/blob/main/browser/Log for logging spec */
+    return {
+      qs: {
+        browser_monitoring_key: this.#agentInfo.licenseKey
+      },
+      body: [{
+        common: {
+          /** Attributes in the `common` section are added to `all` logs generated in the payload */
+          attributes: {
+            'entity.guid': this.#agentRuntime.appMetadata?.agents?.[0]?.entityGuid,
+            // browser entity guid as provided from RUM response
+            session: this.#agentRuntime?.session?.state.value || '0',
+            // The session ID that we generate and keep across page loads
+            hasReplay: this.#agentRuntime?.session?.state.sessionReplayMode === 1,
+            // True if a session replay recording is running
+            hasTrace: this.#agentRuntime?.session?.state.sessionTraceMode === 1,
+            // True if a session trace recording is running
+            ptid: this.#agentRuntime.ptid,
+            // page trace id
+            appId: this.#agentInfo.applicationID,
+            // Application ID from info object,
+            standalone: Boolean(this.#agentInfo.sa),
+            // copy paste (true) vs APM (false)
+            agentVersion: this.#agentRuntime.version // browser agent version
+          }
+        },
+        /** logs section contains individual unique log entries */
+        logs: this.outgoingLogs
+      }]
+    };
+  }
+  onHarvestFinished(result) {
+    if (!result.retry) this.outgoingLogs = [];
+  }
+}
+exports.Aggregate = Aggregate;

package/dist/cjs/features/logging/constants.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MAX_PAYLOAD_SIZE = exports.LOG_LEVELS = exports.LOGGING_LEVEL_FAILURE_MESSAGE = exports.LOGGING_IGNORED = exports.LOGGING_FAILURE_MESSAGE = exports.LOGGING_EVENT_EMITTER_CHANNEL = exports.FEATURE_NAME = void 0;
+var _features = require("../../loaders/features/features");
+const LOG_LEVELS = exports.LOG_LEVELS = {
+  ERROR: 'ERROR',
+  WARN: 'WARN',
+  INFO: 'INFO',
+  DEBUG: 'DEBUG',
+  TRACE: 'TRACE'
+};
+const LOGGING_EVENT_EMITTER_CHANNEL = exports.LOGGING_EVENT_EMITTER_CHANNEL = 'log';
+const FEATURE_NAME = exports.FEATURE_NAME = _features.FEATURE_NAMES.logging;
+const MAX_PAYLOAD_SIZE = exports.MAX_PAYLOAD_SIZE = 1000000;
+const LOGGING_FAILURE_MESSAGE = exports.LOGGING_FAILURE_MESSAGE = 'failed to wrap logger: ';
+const LOGGING_LEVEL_FAILURE_MESSAGE = exports.LOGGING_LEVEL_FAILURE_MESSAGE = 'invalid log level: ';
+const LOGGING_IGNORED = exports.LOGGING_IGNORED = 'ignored log: ';

package/dist/cjs/features/logging/index.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Logging", {
+  enumerable: true,
+  get: function () {
+    return _index.Instrument;
+  }
+});
+var _index = require("./instrument/index");

package/dist/cjs/features/logging/instrument/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Instrument = void 0;
+var _instrumentBase = require("../../utils/instrument-base");
+var _constants = require("../constants");
+var _utils = require("../shared/utils");
+class Instrument extends _instrumentBase.InstrumentBase {
+  static featureName = _constants.FEATURE_NAME;
+  constructor(agentIdentifier, aggregator) {
+    let auto = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+    super(agentIdentifier, aggregator, _constants.FEATURE_NAME, auto);
+    const instanceEE = this.ee;
+    /** emitted by wrap-logger function */
+    this.ee.on('wrap-logger-end', function handleLog(_ref) {
+      let [message] = _ref;
+      const {
+        level,
+        customAttributes
+      } = this;
+      (0, _utils.bufferLog)(instanceEE, message, customAttributes, level);
+    });
+    this.importAggregator();
+  }
+}
+exports.Instrument = Instrument;

package/dist/cjs/features/logging/shared/log.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Log = void 0;
+var _runtime = require("../../../common/constants/runtime");
+var _cleanUrl = require("../../../common/url/clean-url");
+var _constants = require("../constants");
+class Log {
+  /** @type {long} the unix timestamp of the log event */
+  timestamp;
+  /** @type {string} the log message */
+  message;
+  /** @type {object} the object of attributes to be parsed by logging ingest into top-level properties */
+  attributes;
+  /** @type {'ERROR'|'TRACE'|'DEBUG'|'INFO'|'WARN'} the log type of the log */
+  level;
+
+  /**
+   * @param {number} timestamp - Unix timestamp
+   * @param {string} message - message string
+   * @param {object} attributes - other log event attributes
+   * @param {enum} level - Log level
+   */
+  constructor(timestamp, message) {
+    let attributes = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+    let level = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : _constants.LOG_LEVELS.INFO;
+    /** @type {long} */
+    this.timestamp = timestamp;
+    this.message = message;
+    this.attributes = {
+      ...attributes,
+      pageUrl: (0, _cleanUrl.cleanURL)('' + _runtime.globalScope.location)
+    };
+    this.level = level.toUpperCase();
+  }
+}
+exports.Log = Log;

package/dist/cjs/features/logging/shared/utils.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bufferLog = bufferLog;
+exports.isValidLogLevel = isValidLogLevel;
+var _handle = require("../../../common/event-emitter/handle");
+var _now = require("../../../common/timing/now");
+var _console = require("../../../common/util/console");
+var _stringify = require("../../../common/util/stringify");
+var _features = require("../../../loaders/features/features");
+var _constants = require("../../metrics/constants");
+var _constants2 = require("../constants");
+/**
+   * @param {ContextualEE} ee - The contextual ee tied to the instance
+   * @param {string} message - the log message string
+   * @param {{[key: string]: *}} customAttributes - The log's custom attributes if any
+   * @param {enum} level - the log level enum
+   */
+function bufferLog(ee, message) {
+  let customAttributes = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  let level = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : _constants2.LOG_LEVELS.INFO;
+  try {
+    if (typeof message !== 'string') {
+      const stringified = (0, _stringify.stringify)(message);
+      /**
+       * Error instances convert to `{}` when stringified
+       * Symbol converts to '' when stringified
+       * other cases tbd
+       * */
+      if (!!stringified && stringified !== '{}') message = stringified;else message = String(message);
+    }
+  } catch (err) {
+    (0, _console.warn)('could not cast log message to string', message);
+    return;
+  }
+  (0, _handle.handle)(_constants.SUPPORTABILITY_METRIC_CHANNEL, ["API/logging/".concat(level.toLowerCase(), "/called")], undefined, _features.FEATURE_NAMES.metrics, ee);
+  (0, _handle.handle)(_constants2.LOGGING_EVENT_EMITTER_CHANNEL, [(0, _now.now)(), message, customAttributes, level], undefined, _features.FEATURE_NAMES.logging, ee);
+}
+
+/**
+ * Checks if a supplied log level is acceptable for use in generating a log event
+ * @param {string} level
+ * @returns {boolean}
+ */
+function isValidLogLevel(level) {
+  if (typeof level !== 'string') return false;
+  return Object.values(_constants2.LOG_LEVELS).some(logLevel => logLevel.toUpperCase() === level.toUpperCase());
+}

package/dist/cjs/features/page_view_event/aggregate/index.js

@@ -24,7 +24,7 @@ var _constants2 = require("../../metrics/constants");
 var _now = require("../../../common/timing/now");
 var _timeKeeper = require("../../../common/timing/time-keeper");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 class Aggregate extends _aggregateBase.AggregateBase {
   static featureName = CONSTANTS.FEATURE_NAME;
   constructor(agentIdentifier, aggregator) {