feat: disable error logging stacktrace in message

spec/logger.spec.ts

@@ -1,6 +1,8 @@
 import { expect } from "chai";
 
 import * as logger from "../src/logger";
+import { setGlobalOptions } from "../src/v2";
+import { getGlobalOptions } from "../src/v2/options";
 
 describe("logger", () => {
   const stdoutWrite = process.stdout.write.bind(process.stdout);
@@ -218,4 +220,47 @@ describe("logger", () => {
       });
     });
   });
+
+  describe("error logging stacktrace", () => {
+    const defaultOptions = getGlobalOptions();
+
+    beforeEach(() => {
+      setGlobalOptions(defaultOptions);
+    });
+
+    afterEach(() => {
+      setGlobalOptions(defaultOptions);
+    });
+
+    it("default behavior is to include stacktrace in error logs", () => {
+      // If this test fails, it means there's a breaking change.
+      const message = "Test error with stacktrace";
+      logger.error(message);
+      const messageOutput = JSON.parse(lastErr.trim()).message;
+      expect(messageOutput).to.include(`Error: ${message}`);
+    });
+
+    it("when disableErrorLoggingStacktrace is set to false, should include stacktrace in error logs", () => {
+      const message = "Test error with stacktrace";
+      setGlobalOptions({
+        disableErrorLoggingStacktrace: false,
+      });
+      logger.error(message);
+      const messageOutput = JSON.parse(lastErr.trim()).message;
+
+      expect(messageOutput).to.include(`Error: ${message}`);
+    });
+
+    it("when disableErrorLoggingStacktrace is set to true, should not include stacktrace in error logs", () => {
+      const message = "Test error with stacktrace disabled";
+      setGlobalOptions({
+        disableErrorLoggingStacktrace: true,
+      });
+      logger.error(message);
+      expectStderr({
+        severity: "ERROR",
+        message: message,
+      });
+    });
+  });
 });

src/logger/index.ts

@@ -24,6 +24,7 @@ import { format } from "util";
 import { traceContext } from "../common/trace";
 
 import { CONSOLE_SEVERITY, UNPATCHED_CONSOLE } from "./common";
+import { getGlobalOptions } from "../v2/options";
 
 /**
  * `LogSeverity` indicates the detailed severity of the log entry. See [LogSeverity](https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#logseverity).
@@ -158,7 +159,11 @@ function entryFromArgs(severity: LogSeverity, args: any[]): LogEntry {
 
   // mimic `console.*` behavior, see https://nodejs.org/api/console.html#console_console_log_data_args
   let message = format(...args);
-  if (severity === "ERROR" && !args.find((arg) => arg instanceof Error)) {
+  if (
+    severity === "ERROR" &&
+    !getGlobalOptions().disableErrorLoggingStacktrace &&
+    !args.find((arg) => arg instanceof Error)
+  ) {
     message = new Error(message).stack || message;
   }
   const out: LogEntry = {

src/v2/options.ts

@@ -232,6 +232,15 @@ export interface GlobalOptions {
    * may inadvertently be wiped out.
    */
   preserveExternalChanges?: boolean;
+
+  /**
+   * Controls whether error logging should include the stacktrace of the error automatically.
+   * Defaults to false.
+   *
+   * @remarks
+   * When true, the error message will not include the stacktrace of the error.
+   */
+  disableErrorLoggingStacktrace?: boolean;
 }
 
 let globalOptions: GlobalOptions | undefined;