feat(logs): Add experimental user-callable logging methods

.size-limit.js

@@ -8,14 +8,14 @@ module.exports = [
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init'),
     gzip: true,
-    limit: '24 KB',
+    limit: '25 KB',
   },
   {
     name: '@sentry/browser - with treeshaking flags',
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init'),
     gzip: true,
-    limit: '24.1 KB',
+    limit: '24.5 KB',
     modifyWebpackConfig: function (config) {
       const webpack = require('webpack');
       const TerserPlugin = require('terser-webpack-plugin');
@@ -40,14 +40,14 @@ module.exports = [
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init', 'browserTracingIntegration'),
     gzip: true,
-    limit: '37.5 KB',
+    limit: '38 KB',
   },
   {
     name: '@sentry/browser (incl. Tracing, Replay)',
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init', 'browserTracingIntegration', 'replayIntegration'),
     gzip: true,
-    limit: '75.2 KB',
+    limit: '77 KB',
   },
   {
     name: '@sentry/browser (incl. Tracing, Replay) - with treeshaking flags',
@@ -79,7 +79,7 @@ module.exports = [
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init', 'browserTracingIntegration', 'replayIntegration', 'replayCanvasIntegration'),
     gzip: true,
-    limit: '80 KB',
+    limit: '82 KB',
   },
   {
     name: '@sentry/browser (incl. Tracing, Replay, Feedback)',
@@ -100,14 +100,14 @@ module.exports = [
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init', 'sendFeedback'),
     gzip: true,
-    limit: '29 KB',
+    limit: '30 KB',
   },
   {
     name: '@sentry/browser (incl. FeedbackAsync)',
     path: 'packages/browser/build/npm/esm/index.js',
     import: createImport('init', 'feedbackAsyncIntegration'),
     gzip: true,
-    limit: '34 KB',
+    limit: '34.5 KB',
   },
   // React SDK (ESM)
   {
@@ -210,7 +210,7 @@ module.exports = [
     import: createImport('init'),
     ignore: ['next/router', 'next/constants'],
     gzip: true,
-    limit: '41 KB',
+    limit: '43 KB',
   },
   // SvelteKit SDK (ESM)
   {
@@ -219,7 +219,7 @@ module.exports = [
     import: createImport('init'),
     ignore: ['$app/stores'],
     gzip: true,
-    limit: '38 KB',
+    limit: '39 KB',
   },
   // Node SDK (ESM)
   {

packages/astro/src/index.server.ts

@@ -127,6 +127,7 @@ export {
   withScope,
   zodErrorsIntegration,
   profiler,
+  _experiment_log,
 } from '@sentry/node';
 
 export { init } from './server/sdk';

packages/aws-serverless/src/index.ts

@@ -113,6 +113,7 @@ export {
   profiler,
   amqplibIntegration,
   vercelAIIntegration,
+  _experiment_log,
 } from '@sentry/node';
 
 export {

packages/browser/src/index.ts

@@ -10,6 +10,7 @@ export {
   extraErrorDataIntegration,
   rewriteFramesIntegration,
   captureFeedback,
+  _experiment_log,
 } from '@sentry/core';
 
 export { replayIntegration, getReplay } from '@sentry-internal/replay';

packages/bun/src/index.ts

@@ -132,6 +132,7 @@ export {
   profiler,
   amqplibIntegration,
   vercelAIIntegration,
+  _experiment_log,
 } from '@sentry/node';
 
 export {

packages/cloudflare/src/index.ts

@@ -85,6 +85,7 @@ export {
   spanToTraceHeader,
   spanToBaggageHeader,
   updateSpanName,
+  _experiment_log,
 } from '@sentry/core';
 
 export { withSentry } from './handler';

packages/core/src/exports.ts

@@ -1,5 +1,6 @@
 import { getClient, getCurrentScope, getIsolationScope, withIsolationScope } from './currentScopes';
 import { DEBUG_BUILD } from './debug-build';
+import { captureLog, sendLog } from './log';
 import type { CaptureContext } from './scope';
 import { closeSession, makeSession, updateSession } from './session';
 import type {
@@ -22,6 +23,7 @@ import { logger } from './utils-hoist/logger';
 import { uuid4 } from './utils-hoist/misc';
 import { timestampInSeconds } from './utils-hoist/time';
 import { GLOBAL_OBJ } from './utils-hoist/worldwide';
+import { parameterizeStringTemplate } from './utils/parameterize';
 import type { ExclusiveEventHintOrCaptureContext } from './utils/prepareEvent';
 import { parseEventHintOrCaptureContext } from './utils/prepareEvent';
 
@@ -334,3 +336,117 @@ export function captureSession(end: boolean = false): void {
   // only send the update
   _sendSessionUpdate();
 }
+
+/**
+ * A namespace for experimental logging functions.
+ *
+ * @experimental Will be removed in future versions. Use with caution.
+ */
+export const _experiment_log = {
+  /**
+   * A utility to record a log with level 'TRACE' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { trace, fmt } = Sentry._experiment_log;
+   * trace(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  trace: sendLog('trace'),
+  /**
+   * A utility to record a log with level 'DEBUG' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { debug, fmt } = Sentry._experiment_log;
+   * debug(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  debug: sendLog('debug'),
+  /**
+   * A utility to record a log with level 'INFO' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { info, fmt } = Sentry._experiment_log;
+   * info(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  info: sendLog('info'),
+  /**
+   * A utility to record a log with level 'INFO' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { log, fmt } = Sentry._experiment_log;
+   * log(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  log: sendLog('info', 10),
+  /**
+   * A utility to record a log with level 'ERROR' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { error, fmt } = Sentry._experiment_log;
+   * error(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  error: sendLog('error'),
+  /**
+   * A utility to record a log with level 'WARN' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { warn, fmt } = Sentry._experiment_log;
+   * warn(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  warn: sendLog('warn'),
+  /**
+   * A utility to record a log with level 'FATAL' and send it to sentry.
+   *
+   * Logs represent a message and some parameters which provide context for a trace or error.
+   *
+   * @example
+   * ```js
+   * const { fatal, fmt } = Sentry._experiment_log;
+   * fatal(fmt`user ${username} just bought ${item}!`);
+   * ```
+   */
+  fatal: sendLog('fatal'),
+
+  /**
+   * Tagged template function which returns parameterized representation of the message
+   *
+   * @example
+   * ```js
+   * Sentry._experiment_log.fmt`This is a log statement with ${x} and ${y} params`
+   * ```
+   */
+  fmt: parameterizeStringTemplate,
+
+  /**
+   * A flexible utility to record a log with a custom level and send it to sentry.
+   *
+   * You can optionally pass in custom attributes and a custom severity number to be attached to the log.
+   *
+   * @example
+   * ```js
+   * Sentry._experiment_log.emit({ level: 'info', message: Sentry._experiment_log.fmt`user ${username }just bought ${item}`, attributes: { extra: 123 } })
+   * ```
+   */
+  emit: captureLog,
+};

packages/core/src/index.ts

@@ -29,6 +29,7 @@ export {
   endSession,
   captureSession,
   addEventProcessor,
+  _experiment_log,
 } from './exports';
 export {
   getCurrentScope,