SecureNow

SecureNow

面向 Node.js 和 Next.js 应用的 OpenTelemetry 插桩——将追踪和日志发送到 SigNoz 或任何兼容 OTLP 的后端。

官方 npm 包： securenow

---

🚀 快速开始

适用于 Next.js 应用

为 Next.js 添加可观测性的最简单方式！

# Just install - setup is automatic!
npm install securenow

🎉 安装程序将自动：

• 检测你的 Next.js 项目
• 创建 instrumentation.ts（或 .js）
• 创建 .env.local 模板

出现提示时只需回答“Y”！

然后配置你的 .env.local：

SECURENOW_APPID=my-nextjs-app
SECURENOW_INSTANCE=http://your-signoz-server:4318

替代方式： 使用 CLI 命令

npx securenow init

完成！ 🎉 详情请参阅 Next.js 完整指南。

---

适用于 Node.js 应用（Express、Fastify、NestJS 等）

仅追踪

# 1. Install
npm install securenow

# 2. Set environment variables
export SECURENOW_APPID=my-app
export SECURENOW_INSTANCE=http://your-signoz-server:4318

# 3. Run with preload
NODE_OPTIONS="-r securenow/register" node app.js
# or
NODE_OPTIONS="-r securenow/register" npm start

追踪 + 日志（推荐）

# 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!

---

📦 安装

npm install securenow
# or
yarn add securenow
# or
pnpm add securenow

---

⚙️ 配置

环境变量

# Required: Your application identifier
SECURENOW_APPID=my-app-name

# Optional: Your SigNoz/OTLP collector endpoint
# Default: https://freetrial.securenow.ai: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

旧版环境变量（仍受支持）

export securenow=<API-KEY>
export securenow_instance='http://<dedicated_instance>:4318'

---

🎯 支持的框架和库

SecureNow 会自动插桩以下组件：

Web 框架

• ✅ Next.js（App Router 和 Pages Router）
• ✅ Express.js
• ✅ Fastify
• ✅ NestJS
• ✅ Koa
• ✅ Hapi

数据库

• ✅ PostgreSQL
• ✅ MySQL / MySQL2
• ✅ MongoDB
• ✅ Redis

日志记录

• ✅ 自动记录控制台日志（console.log、info、warn、error）
• ✅ 使用 OpenTelemetry 进行结构化日志记录
• ✅ 自动关联追踪与日志
• ✅ 适用于所有框架

其他

• ✅ HTTP/HTTPS 请求
• ✅ GraphQL
• ✅ gRPC
• ✅ 以及更多 OpenTelemetry 自动插桩支持的组件

---

📚 文档

快速开始

• Next.js 快速开始 - 30 秒即可开始
• 日志记录快速开始 - 2 分钟内添加日志记录

完整指南

• Next.js 完整指南 - 完整的 Next.js 集成指南
• 日志记录完整指南 - 适用于所有框架的完整日志配置
• 📚 完整文档 - 所有指南和参考资料

示例

• 代码示例 - 可直接使用的不同配置示例

---

🆘 支持

• 网站： securenow.ai
• 问题： 报告错误并申请新功能
• 文档： 完整文档和指南

---

📄 许可证

ISC