Documentation

Getting Started

Add a few lines of code, point at your ingest URL, and start shipping errors, events, and sessions to the dashboard.

What is this?

Telemetry Tracker is a small, self-hostable pipeline for errors, product events, and sessions. You send JSON payloads from your apps via our SDKs; the API stores and aggregates them; the web dashboard is where you triage issues, scan trends, and drill into stacks and context—without running a full APM suite.

Quick start

Install @tacko/telemetry-core (or a platform package below). Replace ingestUrl with your API base and app with a logical name for filters in the UI. Use Copy to paste into your project.

Minimal init
import { init } from "@tacko/telemetry-core";

init({
  ingestUrl: "https://your-api.example.com",
  app: "my-app",
});

After init(), browsers report uncaught errors and unhandled rejections automatically. See SDK for trackEvent, identity, batching, and the app string.

How it fits together

  • Ingest — Your services POST events, errors, and sessions to the API (e.g. POST /ingest/event).
  • SDKs — Packages such as @tacko/telemetry-next and @tacko/telemetry-core handle init, batching, and sending.
  • Dashboard — Overview, errors, events, and sessions with filters by app and time. Using the dashboard.

Choose a platform

Same data model everywhere—pick the guide that matches your stack.

  • Next.js— Provider, error boundary, page tracking, and global browser error handlers.
  • Nuxt— Plugin + middleware using @tacko/telemetry-core.
  • Node.js— Global error handlers, optional request middleware.
  • React Native— Global error handler, session and screen tracking.