@owlmetry/node

Node.js SDK for Owlmetry — self-hosted metrics tracking for mobile and backend apps.

Zero runtime dependencies. Works with any Node.js framework.

Install

npm install @owlmetry/node

Quick Start

ESM:

import { Owl } from "@owlmetry/node";

CommonJS:

const { Owl } = require("@owlmetry/node");

Owl.configure({
  clientKey: "owl_client_...",
  endpoint: "https://ingest.owlmetry.com",
});

// Log events
Owl.info("User signed up", { screen: "onboarding" });
Owl.error("Payment failed", { orderId: "abc123" });

// Track metrics
const op = Owl.startOperation("api-request");
// ... do work ...
op.complete({ route: "/users" });

// Record funnel steps
Owl.step("signup-started");

// Serverless support
export default Owl.wrapHandler(async (req, res) => {
  Owl.info("Request received");
  res.json({ ok: true });
});

Example

A runnable demo server lives at Examples/Demo/. It exercises the full SDK surface (operations, feedback, user properties, wrapHandler) and is the backend the iOS SDK demo calls from its "Backend Demo" screen, so cross-SDK session correlation shows up in one place in the dashboard.

Links

• Website
• Docs
• Main repo — server, dashboard, CLI
• Claude Code skills — install with /plugin marketplace add owlmetry/owlmetry-skills to get AI agent instrumentation skills