Documentation

Everything you need to integrate TraceStack into your applications.

1. Quick Start

TraceStack provides a zero-dependency Node.js SDK that makes logging extremely fast and entirely asynchronous. First, install the package using your preferred package manager:

npm install @trace-stack/node

Next, initialize the logger at the entry point of your application:

import { logger } from "@trace-stack/node";

logger.init({
  apiKey: "your_project_api_key",
  service: "api-server",
  flushIntervalMs: 2000, // Optional: defaults to 3000ms
});

2. Logging Events

Once initialized, you can log events from anywhere in your codebase. The SDK supports five log levels: debug, info, warn, error, and fatal.

logger.info("User signed in", {
  userId: "usr_123",
  method: "oauth",
  provider: "github"
});

try {
  await chargeStripe(userId, amount);
}  catch (err) {
  logger.error("Payment failed", {
    userId,
    amount,
    error: err.message
  });
}

Zero Performance Penalty. The SDK batches all logs in memory and sends them asynchronously. Your application's response time is completely unaffected by logging.

3. REST API (Advanced)

If you are using a language other than Node.js, you can send logs directly to the Ingestion API.

POST https://ingest.tracestack.dev/api/v1/logs/batch
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{\n  "logs": [\n    {\n      "level": "info",\n      "message": "User signed up",\n      "service": "api-server",\n      "timestamp": "2026-06-20T12:00:00.000Z",\n      "metadata": { ... }\n    }\n  ]\n}