securenow 4.0.12 → 5.0.0

package/README.md

@@ -1,6 +1,6 @@
 # SecureNow
 
-OpenTelemetry instrumentation for Node.js and Next.js applications - send traces to SigNoz or any OTLP-compatible backend.
+OpenTelemetry instrumentation for Node.js and Next.js applications - send **traces and logs** to SigNoz or any OTLP-compatible backend.
 
 **Official npm package:** [securenow](http://securenow.ai/)
 
@@ -42,6 +42,8 @@ npx securenow init
 
 ### For Node.js Applications (Express, Fastify, NestJS, etc.)
 
+#### Tracing Only
+
 ```bash
 # 1. Install
 npm install securenow
@@ -56,6 +58,23 @@ NODE_OPTIONS="-r securenow/register" node app.js
 NODE_OPTIONS="-r securenow/register" npm start
 ```
 
+#### Tracing + Logging (Recommended)
+
+```bash
+# 1. Install
+npm install securenow
+
+# 2. Set environment variables
+export SECURENOW_APPID=my-app
+export SECURENOW_INSTANCE=http://your-signoz-server:4318
+export SECURENOW_LOGGING_ENABLED=1
+
+# 3. Run with preload (adds logging)
+NODE_OPTIONS="-r securenow/register -r securenow/console-instrumentation" node app.js
+
+# Now all console.log/info/warn/error automatically go to SigNoz!
+```
+
 ---
 
 ## 📦 Installation
@@ -82,11 +101,19 @@ SECURENOW_APPID=my-app-name
 # Default: http://46.62.173.237:4318
 SECURENOW_INSTANCE=http://your-signoz-server:4318
 
+# Optional: Enable Logging
+SECURENOW_LOGGING_ENABLED=1                 # Enable automatic log collection
+
 # Optional: Additional configuration
 SECURENOW_NO_UUID=1                         # Don't append UUID to service name
 OTEL_LOG_LEVEL=info                         # debug|info|warn|error
 SECURENOW_DISABLE_INSTRUMENTATIONS=fs,dns   # Disable specific instrumentations
 OTEL_EXPORTER_OTLP_HEADERS="x-api-key=..."  # Authentication headers
+
+# Optional: Request body capture (for debugging)
+SECURENOW_CAPTURE_BODY=1                    # Capture request bodies in traces
+SECURENOW_MAX_BODY_SIZE=10240               # Max body size in bytes
+SECURENOW_SENSITIVE_FIELDS="field1,field2"  # Additional fields to redact
 ```
 
 ### Legacy Environment Variables (still supported)
@@ -116,6 +143,12 @@ SecureNow automatically instruments:
 - ✅ MongoDB
 - ✅ Redis
 
+### Logging
+- ✅ Automatic console logging (console.log, info, warn, error)
+- ✅ Structured logging with OpenTelemetry
+- ✅ Automatic trace-log correlation
+- ✅ Works with all frameworks
+
 ### Other
 - ✅ HTTP/HTTPS requests
 - ✅ GraphQL
@@ -126,10 +159,17 @@ SecureNow automatically instruments:
 
 ## 📚 Documentation
 
+### Quick Starts
 - **[Next.js Quick Start](./docs/NEXTJS-QUICKSTART.md)** - Get started in 30 seconds
+- **[Logging Quick Start](./docs/LOGGING-QUICKSTART.md)** - Add logging in 2 minutes
+
+### Complete Guides
 - **[Next.js Complete Guide](./docs/NEXTJS-GUIDE.md)** - Full Next.js integration guide
+- **[Logging Complete Guide](./docs/LOGGING-GUIDE.md)** - Full logging setup for all frameworks
 - **[📚 Complete Documentation](./docs/INDEX.md)** - All guides and references
-- **[Examples](./examples/)** - Code examples for different setups
+
+### Examples
+- **[Code Examples](./examples/)** - Ready-to-use examples for different setups
 
 ---
 

package/console-instrumentation.js

@@ -0,0 +1,136 @@
+'use strict';
+
+/**
+ * Console instrumentation helper for securenow
+ * 
+ * This module wraps the default console methods (log, info, warn, error, debug)
+ * to automatically send logs to OpenTelemetry/SigNoz.
+ * 
+ * Usage:
+ *   1. Enable logging: SECURENOW_LOGGING_ENABLED=1
+ *   2. Import this file AFTER securenow is initialized
+ *   3. Use console.log/info/warn/error as normal
+ * 
+ * Example:
+ *   // At the top of your app.js or index.js
+ *   require('securenow/register'); // or use NODE_OPTIONS
+ *   require('securenow/console-instrumentation');
+ *   
+ *   // Now all console calls are captured
+ *   console.log('Application started');
+ *   console.error('An error occurred');
+ */
+
+const tracing = require('./tracing');
+
+if (!tracing.isLoggingEnabled()) {
+  console.warn('[securenow] Console instrumentation loaded but logging is not enabled. Set SECURENOW_LOGGING_ENABLED=1 to enable.');
+}
+
+// Get a logger instance
+const logger = tracing.getLogger('console', '1.0.0');
+
+if (!logger) {
+  console.warn('[securenow] Console instrumentation: No logger available. Logging will not work.');
+  module.exports = {};
+  return;
+}
+
+// Store original console methods
+const originalConsole = {
+  log: console.log,
+  info: console.info,
+  warn: console.warn,
+  error: console.error,
+  debug: console.debug,
+};
+
+// Map severity levels (OpenTelemetry standard)
+const SeverityNumber = {
+  DEBUG: 5,
+  INFO: 9,
+  WARN: 13,
+  ERROR: 17,
+};
+
+/**
+ * Format arguments into a log message
+ */
+function formatMessage(args) {
+  return args
+    .map((arg) => {
+      if (typeof arg === 'object' && arg !== null) {
+        try {
+          return JSON.stringify(arg);
+        } catch (e) {
+          return String(arg);
+        }
+      }
+      return String(arg);
+    })
+    .join(' ');
+}
+
+/**
+ * Emit a log record
+ */
+function emitLog(severityNumber, severityText, args) {
+  const message = formatMessage(args);
+  
+  try {
+    logger.emit({
+      severityNumber,
+      severityText,
+      body: message,
+      attributes: {
+        'log.source': 'console',
+        'log.method': severityText.toLowerCase(),
+      },
+    });
+  } catch (e) {
+    // Silently fail to avoid breaking the application
+  }
+}
+
+// Override console.log
+console.log = function (...args) {
+  emitLog(SeverityNumber.INFO, 'INFO', args);
+  originalConsole.log.apply(console, args);
+};
+
+// Override console.info
+console.info = function (...args) {
+  emitLog(SeverityNumber.INFO, 'INFO', args);
+  originalConsole.info.apply(console, args);
+};
+
+// Override console.warn
+console.warn = function (...args) {
+  emitLog(SeverityNumber.WARN, 'WARN', args);
+  originalConsole.warn.apply(console, args);
+};
+
+// Override console.error
+console.error = function (...args) {
+  emitLog(SeverityNumber.ERROR, 'ERROR', args);
+  originalConsole.error.apply(console, args);
+};
+
+// Override console.debug
+console.debug = function (...args) {
+  emitLog(SeverityNumber.DEBUG, 'DEBUG', args);
+  originalConsole.debug.apply(console, args);
+};
+
+console.log('[securenow] Console instrumentation installed - all console logs will be sent to SigNoz');
+
+module.exports = {
+  originalConsole,
+  restoreConsole: () => {
+    console.log = originalConsole.log;
+    console.info = originalConsole.info;
+    console.warn = originalConsole.warn;
+    console.error = originalConsole.error;
+    console.debug = originalConsole.debug;
+  },
+};

package/docs/INDEX.md

@@ -1,6 +1,6 @@
 # SecureNow Documentation
 
-Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js and Next.js.
+Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js and Next.js with tracing and logging.
 
 ## 📚 Table of Contents
 
@@ -10,6 +10,17 @@ Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js
 - **[Auto Setup](AUTO-SETUP.md)** - Automated setup instructions
 - **[Auto Setup Summary](AUTO-SETUP-SUMMARY.md)** - Summary of auto-setup features
 
+### 📋 Logging
+
+- **[Logging Quick Start](LOGGING-QUICKSTART.md)** - Add logging to your app in 2 minutes
+- **[Logging Complete Guide](LOGGING-GUIDE.md)** - Full logging setup for all frameworks
+  - Express.js logging examples
+  - Next.js logging examples
+  - Fastify logging examples
+  - NestJS logging examples
+  - Console instrumentation
+  - Direct logger API usage
+
 ### 📦 Next.js Integration
 
 - **[Next.js Guide](NEXTJS-GUIDE.md)** - Complete Next.js integration guide
@@ -57,6 +68,11 @@ Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js
 
 ## 🎯 Quick Links by Use Case
 
+### "I want to add logging to my app"
+1. Start with [Logging Quick Start](LOGGING-QUICKSTART.md)
+2. For complete guide: [Logging Complete Guide](LOGGING-GUIDE.md)
+3. Works with Express, Next.js, Fastify, NestJS, and all Node.js frameworks
+
 ### "I want to add tracing to my Next.js app"
 1. Start with [Next.js Quickstart](NEXTJS-QUICKSTART.md)
 2. For automatic setup: [Auto Setup](AUTO-SETUP.md)
@@ -86,10 +102,12 @@ Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js
 
 ### Complete Guides (Read First)
 - Customer Guide
+- Logging Complete Guide
 - Next.js Guide
 - Express Body Capture
 
 ### Quick References
+- Logging Quick Start
 - Next.js Quickstart
 - Body Capture Quickstart
 - Easiest Setup
@@ -125,5 +143,5 @@ Complete documentation for SecureNow - OpenTelemetry instrumentation for Node.js
 
 ---
 
-**Last Updated:** January 11, 2026  
-**Package Version:** 4.0.9
+**Last Updated:** March 18, 2026  
+**Package Version:** 4.0.12