N/log Module in NetSuite: Complete Logging Guide for SuiteScript

The N/log module is used to write log entries to the NetSuite Script Execution Log. It is an indispensable debugging and monitoring tool for every SuiteScript developer. Logs are viewable at Customization > Scripting > Script Execution Logs.

Log Levels

Using N/log

define(["N/log"], (log) => {
  log.debug({ title: "Script Started", details: "User event triggered" });
  log.audit({ title: "Record Saved", details: "Customer ID: 12345" });
  log.error({ title: "Error occurred", details: JSON.stringify(error) });
  log.emergency({ title: "CRITICAL", details: "Unexpected failure in sync process" });
  return {};
});

Best Practices

Set the log level on your Script Deployment to DEBUG during development and AUDIT in production. Each log call costs 10 governance units, so avoid logging inside high-frequency loops. Use log.audit() in production as it is the least disruptive level that still records key milestones. Always include meaningful titles and detailed messages to make debugging easier.

Back to All NetSuite Modules