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