securenow 5.18.0 → 6.0.0

package/docs/LOGGING-QUICKSTART.md

@@ -1,234 +1,239 @@
-# SecureNow Logging - Quick Start
-
-Get logging set up in your Node.js app in under 2 minutes!
-
-**Since v5.6.0:** When `SECURENOW_LOGGING_ENABLED=1` is set, all `console.log` / `warn` / `error` / `info` / `debug` calls are automatically forwarded as OTLP log records. You only need `require('securenow/register')`—a separate `console-instrumentation` preload is no longer required.
-
----
-
-## 1. Install
-
-```bash
-npm install securenow
-```
-
----
-
-## 2. Configure Environment
-
-Create `.env` file or export variables:
-
-```bash
-SECURENOW_LOGGING_ENABLED=1
-SECURENOW_APPID=my-app
-SECURENOW_INSTANCE=http://your-otlp-backend:4318
-
-# For SecureNow / hosted OTLP (example):
-# SECURENOW_INSTANCE=https://freetrial.securenow.ai:4318
-# OTEL_EXPORTER_OTLP_HEADERS="x-api-key=<your-key>"
-```
-
----
-
-## 3. Add to Your App
-
-**Option A: Automatic Console Logging (Easiest)**
-
-Add this line at the top of your main file:
-
-```javascript
-// app.js, index.js, server.js, or main.ts
-require('securenow/register');
-
-// That's it! Now use console normally
-console.log('App started');
-console.error('An error occurred', { userId: 123 });
-```
-
-**Option B: Use NODE_OPTIONS (No code changes)**
-
-```bash
-NODE_OPTIONS="-r securenow/register" node app.js
-```
-
----
-
-## 4. Run Your App
-
-```bash
-node app.js
-# or
-npm start
-```
-
-You should see:
-
-```
-[securenow] OTel SDK started → http://your-otlp-backend:4318/v1/traces
-[securenow] 📋 Logging: ENABLED → http://your-otlp-backend:4318/v1/logs
-```
-
----
-
-## 5. View Logs in SecureNow
-
-1. Open your SecureNow dashboard
-2. Go to **Logs** section
-3. Filter by `service.name = my-app`
-4. See all your logs with automatic trace correlation!
-
----
-
-## Framework-Specific Examples
-
-### Express.js
-
-```javascript
-// app.js
-require('securenow/register');
-
-const express = require('express');
-const app = express();
-
-app.get('/', (req, res) => {
-  console.log('Request received');
-  res.send('Hello World');
-});
-
-app.listen(3000);
-```
-
-### Next.js
-
-```typescript
-// instrumentation.ts (in project root)
-export async function register() {
-  if (process.env.NEXT_RUNTIME === 'nodejs') {
-    process.env.SECURENOW_LOGGING_ENABLED = '1';
-    await import('securenow/register');
-  }
-}
-```
-
-```bash
-# .env.local
-SECURENOW_LOGGING_ENABLED=1
-SECURENOW_APPID=my-nextjs-app
-SECURENOW_INSTANCE=http://localhost:4318
-```
-
-### Fastify
-
-```javascript
-// server.js
-require('securenow/register');
-
-const fastify = require('fastify')();
-
-fastify.get('/', async () => {
-  console.log('Route called');
-  return { hello: 'world' };
-});
-
-fastify.listen({ port: 3000 });
-```
-
-### NestJS
-
-```typescript
-// main.ts
-require('securenow/register');
-
-import { NestFactory } from '@nestjs/core';
-import { AppModule } from './app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.create(AppModule);
-  console.log('App starting');
-  await app.listen(3000);
-}
-
-bootstrap();
-```
-
----
-
-## Troubleshooting
-
-**Logs not appearing?**
-
-1. Check `SECURENOW_LOGGING_ENABLED=1` is set
-2. Verify your OTLP / SecureNow endpoint is correct
-3. Enable debug: `OTEL_LOG_LEVEL=debug`
-
-**Console logs not forwarding?**
-
-Load `securenow/register` before other app code so logging hooks run first:
-
-```javascript
-// ✅ Correct
-require('securenow/register');  // First
-
-// ❌ Wrong
-require('express');
-require('securenow/register');  // Too late!
-```
-
----
-
-## What Gets Logged?
-
-All standard console methods:
-
-- `console.log()` → INFO
-- `console.info()` → INFO
-- `console.warn()` → WARN
-- `console.error()` → ERROR
-- `console.debug()` → DEBUG
-
-**Structured logging example:**
-
-```javascript
-console.log('User logged in', {
-  userId: 123,
-  email: 'user@example.com',
-  ip: '192.168.1.1'
-});
-```
-
-This creates a log with attributes you can filter/search in SecureNow!
-
----
-
-## Advanced Usage
-
-**Direct Logger API:**
-
-```javascript
-const { getLogger } = require('securenow/tracing');
-const logger = getLogger('my-module', '1.0.0');
-
-logger.emit({
-  severityNumber: 9,
-  severityText: 'INFO',
-  body: 'Custom log message',
-  attributes: {
-    customField: 'value',
-  },
-});
-```
-
----
-
-## Next Steps
-
-- [Complete Logging Guide](./LOGGING-GUIDE.md) - All features and options
-- [SecureNow](https://securenow.ai/)
-- [Documentation](./INDEX.md)
-- [Combine with Tracing](../README.md) - Full observability
-
----
-
-**That's it!** 🎉 Your app is now sending logs to SecureNow.
-
-Need help? Check the [full documentation](./LOGGING-GUIDE.md) or open an issue.
+# SecureNow Logging - Quick Start
+
+Get logging set up in your Node.js app in under 2 minutes!
+
+---
+
+## 1. Install
+
+```bash
+npm install securenow
+```
+
+---
+
+## 2. Configure Environment
+
+Create `.env` file or export variables:
+
+```bash
+SECURENOW_LOGGING_ENABLED=1
+SECURENOW_APPID=my-app
+SECURENOW_INSTANCE=http://your-signoz-server:4318
+
+# For SigNoz Cloud:
+# SECURENOW_INSTANCE=https://ingest.<region>.signoz.cloud:443
+# OTEL_EXPORTER_OTLP_HEADERS="signoz-ingestion-key=<your-key>"
+```
+
+---
+
+## 3. Add to Your App
+
+**Option A: Automatic Console Logging (Easiest)**
+
+Add these two lines at the top of your main file:
+
+```javascript
+// app.js, index.js, server.js, or main.ts
+require('securenow/register');
+require('securenow/console-instrumentation');
+
+// That's it! Now use console normally
+console.log('App started');
+console.error('An error occurred', { userId: 123 });
+```
+
+**Option B: Use NODE_OPTIONS (No code changes)**
+
+```bash
+NODE_OPTIONS="-r securenow/register -r securenow/console-instrumentation" node app.js
+```
+
+---
+
+## 4. Run Your App
+
+```bash
+node app.js
+# or
+npm start
+```
+
+You should see:
+
+```
+[securenow] OTel SDK started → http://your-signoz-server:4318/v1/traces
+[securenow] 📋 Logging: ENABLED → http://your-signoz-server:4318/v1/logs
+[securenow] Console instrumentation installed
+```
+
+---
+
+## 5. View Logs in SigNoz
+
+1. Open your SigNoz dashboard
+2. Go to **Logs** section
+3. Filter by `service.name = my-app`
+4. See all your logs with automatic trace correlation!
+
+---
+
+## Framework-Specific Examples
+
+### Express.js
+
+```javascript
+// app.js
+require('securenow/register');
+require('securenow/console-instrumentation');
+
+const express = require('express');
+const app = express();
+
+app.get('/', (req, res) => {
+  console.log('Request received');
+  res.send('Hello World');
+});
+
+app.listen(3000);
+```
+
+### Next.js
+
+```typescript
+// instrumentation.ts (in project root)
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs') {
+    process.env.SECURENOW_LOGGING_ENABLED = '1';
+    await import('securenow/register');
+    await import('securenow/console-instrumentation');
+  }
+}
+```
+
+```bash
+# .env.local
+SECURENOW_LOGGING_ENABLED=1
+SECURENOW_APPID=my-nextjs-app
+SECURENOW_INSTANCE=http://localhost:4318
+```
+
+### Fastify
+
+```javascript
+// server.js
+require('securenow/register');
+require('securenow/console-instrumentation');
+
+const fastify = require('fastify')();
+
+fastify.get('/', async () => {
+  console.log('Route called');
+  return { hello: 'world' };
+});
+
+fastify.listen({ port: 3000 });
+```
+
+### NestJS
+
+```typescript
+// main.ts
+require('securenow/register');
+require('securenow/console-instrumentation');
+
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  console.log('App starting');
+  await app.listen(3000);
+}
+
+bootstrap();
+```
+
+---
+
+## Troubleshooting
+
+**Logs not appearing?**
+
+1. Check `SECURENOW_LOGGING_ENABLED=1` is set
+2. Verify SigNoz endpoint is correct
+3. Enable debug: `OTEL_LOG_LEVEL=debug`
+
+**Console instrumentation not working?**
+
+Make sure require order is correct:
+
+```javascript
+// ✅ Correct
+require('securenow/register');           // First
+require('securenow/console-instrumentation');  // Second
+
+// ❌ Wrong
+require('express');
+require('securenow/register');  // Too late!
+```
+
+---
+
+## What Gets Logged?
+
+All standard console methods:
+
+- `console.log()` → INFO
+- `console.info()` → INFO
+- `console.warn()` → WARN
+- `console.error()` → ERROR
+- `console.debug()` → DEBUG
+
+**Structured logging example:**
+
+```javascript
+console.log('User logged in', {
+  userId: 123,
+  email: 'user@example.com',
+  ip: '192.168.1.1'
+});
+```
+
+This creates a log with attributes you can filter/search in SigNoz!
+
+---
+
+## Advanced Usage
+
+**Direct Logger API:**
+
+```javascript
+const { getLogger } = require('securenow/tracing');
+const logger = getLogger('my-module', '1.0.0');
+
+logger.emit({
+  severityNumber: 9,
+  severityText: 'INFO',
+  body: 'Custom log message',
+  attributes: {
+    customField: 'value',
+  },
+});
+```
+
+---
+
+## Next Steps
+
+- [Complete Logging Guide](./LOGGING-GUIDE.md) - All features and options
+- [View Logs in SigNoz](https://signoz.io/docs/logs-management/overview/)
+- [Set Up Log Alerts](https://signoz.io/docs/alerts-management/log-based-alerts/)
+- [Combine with Tracing](../README.md) - Full observability
+
+---
+
+**That's it!** 🎉 Your app is now sending logs to SigNoz.
+
+Need help? Check the [full documentation](./LOGGING-GUIDE.md) or open an issue.

package/docs/NEXTJS-BODY-CAPTURE.md

@@ -213,7 +213,7 @@ your-nextjs-app/
      -d '{"username":"test","password":"secret123"}'
    ```
 
-4. **Check SecureNow:**
+4. **Check SigNoz:**
    - Find the `/api/test` trace
    - Look for `http.request.body` attribute
    - Verify password shows `[REDACTED]`
@@ -259,7 +259,7 @@ export const config = {
 ```bash
 # Required
 SECURENOW_APPID=my-nextjs-app
-SECURENOW_INSTANCE=http://your-otlp-backend:4318
+SECURENOW_INSTANCE=http://your-signoz:4318
 
 # Optional: Enable body capture
 SECURENOW_CAPTURE_BODY=1

package/docs/NEXTJS-GUIDE.md

@@ -1,6 +1,6 @@
 # SecureNow for Next.js - Complete Integration Guide
 
-Send traces and logs from your Next.js app to SecureNow or any OTLP-compatible backend in under 2 minutes.
+Send traces and logs from your Next.js app to SigNoz (or any OpenTelemetry-compatible backend) in under 2 minutes.
 
 ## 🚀 Quick Start (2 Simple Steps!)
 
@@ -27,11 +27,11 @@ pnpm add securenow
 Edit the `.env.local` file that was created:
 
 ```bash
-# Required: Your app name (shows up in SecureNow)
+# Required: Your app name (shows up in SigNoz)
 SECURENOW_APPID=my-nextjs-app
 
-# Required: Your OTLP endpoint
-SECURENOW_INSTANCE=http://your-otlp-backend:4318
+# Required: Your SigNoz server endpoint
+SECURENOW_INSTANCE=http://your-signoz-server:4318
 
 # Optional: API key for authentication
 OTEL_EXPORTER_OTLP_HEADERS="x-api-key=your-api-key-here"
@@ -155,7 +155,7 @@ See [REQUEST-BODY-CAPTURE.md](./REQUEST-BODY-CAPTURE.md) for full details.
 SECURENOW_APPID=my-nextjs-app
 
 # Optional Configuration
-SECURENOW_INSTANCE=http://your-otlp-backend:4318
+SECURENOW_INSTANCE=http://your-signoz-server:4318
 SECURENOW_NO_UUID=1                         # Don't append UUID (useful for dev)
 OTEL_LOG_LEVEL=info                         # debug|info|warn|error
 SECURENOW_DISABLE_INSTRUMENTATIONS=fs,dns   # Disable specific instrumentations
@@ -178,7 +178,7 @@ import { registerSecureNow } from 'securenow/nextjs';
 export function register() {
   registerSecureNow({
     serviceName: 'my-nextjs-app',
-    endpoint: 'http://your-otlp-backend:4318',
+    endpoint: 'http://your-signoz-server:4318',
     noUuid: false,
     disableInstrumentations: ['fs', 'dns'],
     headers: {
@@ -243,7 +243,7 @@ COPY . .
 RUN npm run build
 
 ENV SECURENOW_APPID=my-nextjs-app
-ENV SECURENOW_INSTANCE=http://otel-collector:4318
+ENV SECURENOW_INSTANCE=http://signoz:4318
 
 EXPOSE 3000
 CMD ["npm", "start"]
@@ -255,7 +255,7 @@ Just set environment variables and run:
 
 ```bash
 export SECURENOW_APPID=my-nextjs-app
-export SECURENOW_INSTANCE=http://your-otlp-backend:4318
+export SECURENOW_INSTANCE=http://your-signoz-server:4318
 npm start
 ```
 
@@ -288,14 +288,14 @@ Make sure you're on the latest version:
 npm install securenow@latest
 ```
 
-### Traces not appearing in SecureNow
+### Traces not appearing in SigNoz
 
 1. **Check endpoint:**
    ```bash
-   curl http://your-otlp-backend:4318/v1/traces
+   curl http://your-signoz-server:4318/v1/traces
    ```
 
-2. **Verify connectivity:** Make sure your app can reach your OTLP backend (or SecureNow)
+2. **Verify connectivity:** Make sure your app can reach SigNoz
 
 3. **Check authentication:** If using API keys, verify headers
 
@@ -311,7 +311,7 @@ SECURENOW_DISABLE_INSTRUMENTATIONS=fs,dns,net
 ## 📖 Comparison with Other Solutions
 
 ### vs. `@vercel/otel`
-- ✅ **SecureNow**: Pre-configured for OTLP / SecureNow, includes auto-instrumentations
+- ✅ **SecureNow**: Pre-configured for SigNoz, includes auto-instrumentations
 - ⚠️ **@vercel/otel**: Requires manual instrumentation setup
 
 ### vs. Manual OpenTelemetry Setup
@@ -375,7 +375,7 @@ Check the `examples/` folder for:
 
 - **Issues:** [GitHub Issues](https://github.com/your-repo/securenow/issues)
 - **Documentation:** [Full Documentation](https://your-docs-site.com)
-- **SecureNow:** [securenow.ai](https://securenow.ai/)
+- **SigNoz Docs:** [SigNoz OpenTelemetry Docs](https://signoz.io/docs/)
 
 ---
 
@@ -385,5 +385,5 @@ ISC
 
 ---
 
-**Made with ❤️ for the Next.js and SecureNow community**
+**Made with ❤️ for the Next.js and SigNoz community**
 

package/docs/NEXTJS-QUICKSTART.md

@@ -59,7 +59,7 @@ Look for:
 [securenow] ✅ OpenTelemetry started for Next.js
 ```
 
-Open SecureNow → check for traces from `my-nextjs-app`
+Open SigNoz → check for traces from `my-nextjs-app`
 
 ---
 

package/docs/NEXTJS-WRAPPER-APPROACH.md

@@ -241,7 +241,7 @@ export function register() {
 ```bash
 # Required
 SECURENOW_APPID=my-nextjs-app
-SECURENOW_INSTANCE=http://otel-collector:4318
+SECURENOW_INSTANCE=http://signoz:4318
 
 # Optional: Enable body capture
 SECURENOW_CAPTURE_BODY=1

package/docs/QUICKSTART-BODY-CAPTURE.md

@@ -8,7 +8,7 @@ This approach **never interferes** with your middleware or routing.
 
 ```bash
 SECURENOW_APPID=my-app
-SECURENOW_INSTANCE=http://otel-collector:4318
+SECURENOW_INSTANCE=http://signoz:4318
 SECURENOW_CAPTURE_BODY=1
 ```
 
@@ -155,7 +155,7 @@ export async function GET() {
 ```bash
 # Required
 SECURENOW_APPID=my-nextjs-app
-SECURENOW_INSTANCE=http://your-otlp-backend:4318
+SECURENOW_INSTANCE=http://your-signoz:4318
 
 # Body capture
 SECURENOW_CAPTURE_BODY=1                    # Enable body capture

package/docs/REDACTION-EXAMPLES.md

@@ -439,7 +439,7 @@ If "token" is sensitive, these get redacted:
      -d '{"username":"test","password":"secret123"}'
    ```
 
-3. **Check SecureNow:**
+3. **Check SigNoz:**
    - Find the trace
    - Look for `http.request.body`
    - Verify password shows `[REDACTED]`