SecureNow
OpenTelemetry instrumentation for Node.js and Next.js applications - send traces and logs to SigNoz or any OTLP-compatible backend.
Official npm package: securenow
๐ Quick Start
For Next.js Applications
The easiest way to add observability to Next.js!
๐ The installer will automatically:
- Detect your Next.js project
- Create
instrumentation.ts (or .js)
- Create
.env.local template
Just answer "Y" when prompted!
Then configure your .env.local:
SECURENOW_APPID=my-nextjs-app
SECURENOW_INSTANCE=http://your-signoz-server:4318
Alternative: Use the CLI command
Done! ๐ See Next.js Complete Guide for details.
For Node.js Applications (Express, Fastify, NestJS, etc.)
Tracing Only
npm install securenow
export SECURENOW_APPID=my-app
export SECURENOW_INSTANCE=http://your-signoz-server:4318
NODE_OPTIONS="-r securenow/register" node app.js
NODE_OPTIONS="-r securenow/register" npm start
Tracing + Logging (Recommended)
npm install securenow
export SECURENOW_APPID=my-app
export SECURENOW_INSTANCE=http://your-signoz-server:4318
export SECURENOW_LOGGING_ENABLED=1
NODE_OPTIONS="-r securenow/register -r securenow/console-instrumentation" node app.js
๐ฆ Installation
npm install securenow
yarn add securenow
pnpm add securenow
โ๏ธ Configuration
Environment Variables
SECURENOW_APPID=my-app-name
SECURENOW_INSTANCE=http://your-signoz-server:4318
SECURENOW_LOGGING_ENABLED=1
SECURENOW_NO_UUID=1
OTEL_LOG_LEVEL=info
SECURENOW_DISABLE_INSTRUMENTATIONS=fs,dns
OTEL_EXPORTER_OTLP_HEADERS="x-api-key=..."
SECURENOW_CAPTURE_BODY=1
SECURENOW_MAX_BODY_SIZE=10240
SECURENOW_SENSITIVE_FIELDS="field1,field2"
Legacy Environment Variables (still supported)
export securenow=<API-KEY>
export securenow_instance='http://<dedicated_instance>:4318'
๐ฏ Supported Frameworks & Libraries
SecureNow automatically instruments:
Web Frameworks
- โ
Next.js (App Router & Pages Router)
- โ
Express.js
- โ
Fastify
- โ
NestJS
- โ
Koa
- โ
Hapi
Databases
- โ
PostgreSQL
- โ
MySQL / MySQL2
- โ
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
- โ
gRPC
- โ
And many more via OpenTelemetry auto-instrumentation
๐ Documentation
Quick Starts
Complete Guides
Examples
๐ Support
- Website: securenow.ai
- Issues: Report bugs and request features
- Documentation: Full documentation and guides
๐ License
ISC