InfraWatch Node.js SDK

Node.js client library for the InfraWatch observability platform.

Installation

npm install @infrawatch/sdk

Quick Start

import { InfraWatchClient } from "@infrawatch/sdk";

const client = new InfraWatchClient({
  baseUrl: "https://infrawatch.example.com",     // Backend URL for queries
  collectorUrl: "https://collector.example.com",   // Collector URL for push
  apiKey: "iw_sk_a3f8b2c1...",                    // API key for push auth
  email: "[email protected]",                       // Backend login for queries
  password: "secret",                               // Backend login for queries
});

// Push traces (uses API key via X-InfraWatch-API-Key header)
await client.traces.push([
  {
    name: "http.request",
    start_time: "2026-01-01T00:00:00Z",
    end_time: "2026-01-01T00:00:01Z",
  },
]);

// Push metrics
await client.metrics.push([
  { name: "cpu.usage", value: 72.5, type: "gauge" },
]);

// Push logs
await client.logs.push([
  { body: "Request processed successfully", severity: "INFO" },
]);

// Query traces (uses email/password session)
const traces = await client.traces.search({ service: "api-gateway" });

// Health check
const status = await client.health();

Authentication

The SDK uses two authentication mechanisms:

• Push (to collector): API key via X-InfraWatch-API-Key header. Generate your API key in Admin > Observability in the InfraWatch UI.
• Query (from backend): Email/password session cookies. The SDK handles login automatically on the first query.

Requirements

• Node.js >= 18.0.0 (uses native fetch)

License

Proprietary. See LICENSE for details.