Skip to content
TradeX Documentation

Debugging

This guide covers debugging techniques and tools for TradeX services.

Go Services

Section titled “Go Services”

Delve Debugger

Section titled “Delve Debugger”
Terminal window
# Install Delve
go install github.com/go-delve/delve/cmd/dlv@latest


# Debug service
dlv debug ./cmd/marketdata/main.go


# Attach to running process
dlv attach <pid>

Logging

Section titled “Logging”
logger.Info("Processing order",
    zap.String("order_id", orderID),
    zap.String("symbol", symbol),
    zap.Float64("price", price),
)

TypeScript Services

Section titled “TypeScript Services”

Node.js Debugger

Section titled “Node.js Debugger”
Terminal window
# Run with debugger
node --inspect-brk index.ts


# Or with Bun
bun --inspect index.ts

VS Code Debugging

Section titled “VS Code Debugging”
{
  "type": "node",
  "request": "launch",
  "name": "Debug Service",
  "runtimeExecutable": "bun",
  "runtimeArgs": ["run", "dev"],
  "console": "integratedTerminal"
}

Python Services

Section titled “Python Services”

Python Debugger

Section titled “Python Debugger”
Terminal window
# Run with debugger
python -m pdb -m uvicorn app.main:app


# Or use debugpy
python -m debugpy --listen 5678 -m uvicorn app.main:app

Distributed Tracing

Section titled “Distributed Tracing”

OpenTelemetry

Section titled “OpenTelemetry”

View traces in your observability platform:

import { trace } from '@opentelemetry/api';


const tracer = trace.getTracer('my-service');
const span = tracer.startSpan('process-order');
// ... code ...
span.end();

Logging

Section titled “Logging”

Structured Logging

Section titled “Structured Logging”

All services use structured logging:

logger.info('Order processed', {
  orderId: order.id,
  symbol: order.symbol,
  price: order.price
});

Log Aggregation

Section titled “Log Aggregation”

View logs in centralized logging system or:

Terminal window
# View service logs
docker logs tradex-marketdata-service-dev


# Follow logs
docker logs -f tradex-marketdata-service-dev

Common Issues

Section titled “Common Issues”

Service Not Starting

Section titled “Service Not Starting”
  1. Check port availability
  2. Verify environment variables
  3. Check database connectivity
  4. Review service logs

Performance Issues

Section titled “Performance Issues”
  1. Check metrics (Prometheus)
  2. Review slow queries
  3. Check Kafka lag
  4. Monitor resource usage
Section titled “Related Documentation”