newttrace

Discord-native telemetry SDK for structured lifecycle analytics.

Overview

newttrace converts Discord runtime events into structured, exportable telemetry data. Track installs, activations, and attributions without managing infrastructure.

Documentation

Guides

• Getting Started — Installation, configuration, and first events
• Activation Tracking — Measure meaningful bot engagement
• Attribution — Track install sources with zero or minimal infrastructure
• TOPGG Conversion Tracking — Correlate listing clicks with actual installs

API Reference

• Exporters — Datadog, Webhook, File, Stream
• API — SDK methods and type definitions

Quick Start

import { Client, GatewayIntentBits } from "discord.js";
import { initNewttrace, DatadogExporter } from "newttrace";

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

const newttrace = initNewttrace({
  botId: "my-bot",
  exporters: [
    new DatadogExporter({
      apiKey: process.env.DD_API_KEY!,
      service: "my-bot",
    }),
  ],
  auto: true,
  client,
});

client.login(process.env.DISCORD_TOKEN);