Quick start

This guide gets you from zero to live job monitoring in under five minutes.

Before you begin

You’ll need a TraceStax account — sign up free, no credit card required.

Once you’re in, create a project and copy your API key from the project settings page.

---

1. Install the SDK for your stack

   Python / Celery

   pip install tracestax-celery

   Node.js / BullMQ

   npm install @tracestax/bullmq

   Ruby / Sidekiq

   gem install tracestax-sidekiq

   Go

   go get github.com/tracestax/tracestax-go

2. Wrap your worker

   Python / Celery

   from celery import Celery
   from tracestax_celery import TraceStaxMonitor
   
   app = Celery("tasks", broker="redis://localhost:6379/0")
   
   TraceStaxMonitor(
       app=app,
       api_key="ts_live_xxxxxxxxxxxx",
   ).install()

   Node.js / BullMQ

   import { Queue, Worker } from "bullmq";
   import { TraceStaxPlugin } from "@tracestax/bullmq";
   
   const worker = new Worker("orders", processJob, { connection });
   
   TraceStaxPlugin.attach(worker, {
     apiKey: "ts_live_xxxxxxxxxxxx",
   });

   Ruby / Sidekiq

   config/initializers/tracestax.rb

   TraceStax::Sidekiq.configure do |c|
     c.api_key = "ts_live_xxxxxxxxxxxx"
   end

3. Deploy and verify

   Run your worker as normal. Within 30 seconds you should see events flowing in the TraceStax dashboard.

   If events aren’t appearing, check the troubleshooting guide.

Tip

Replace ts_live_xxxxxxxxxxxx with your actual API key from the project settings page. Keep this secret — treat it like a password.

---

Next steps

• Set up alerting — connect PagerDuty, Slack, or another on-call tool
• Understand anomaly detection — learn how TraceStax detects problems without manual thresholds
• Read the SDK docs for your stack — full configuration options for Python, Node.js, Ruby, and more