Tsagko.Modules.Datadog.Trace 1.0.4

Tsagko Datadog Trace Module

A Tsagko module for Crosser that provides APM tracing with Datadog. Creates parent and child spans for detailed performance analysis of your flows.

Features

• Three Modes: Start, Checkpoint, and End for flexible tracing
• Parent/Child Spans: See exactly where time is spent in your flow
• Log Correlation: Works with Tsagko.Modules.Datadog.Logger for unified observability
• Multi-Region: Support for all Datadog datacenter regions
• Custom Tags: Add metadata to your spans for filtering and analysis

Installation

dotnet add package Tsagko.Modules.Datadog.Trace

How It Works

┌───────────────┐    ┌────────┐    ┌────────────────┐    ┌────────┐    ┌─────────────┐
│ Trace (Start) │───▶│ Module │───▶│ Trace (Check)  │───▶│ Module │───▶│ Trace (End) │
│               │    │   A    │    │                │    │   B    │    │             │
│ Creates trace │    │        │    │ Creates span   │    │        │    │ Sends to    │
│ context       │    │        │    │ for segment    │    │        │    │ Datadog     │
└───────────────┘    └────────┘    └────────────────┘    └────────┘    └─────────────┘

In Datadog APM

Trace: order-processing (500ms)
├── Parse Message ────────────── 150ms (30%)
├── Transform Data ───────────── 200ms (40%)  ← Bottleneck!
└── Validate Output ──────────── 100ms (20%)

Configuration

Start Mode

Checkpoint Mode

End Mode

Usage Example

Basic Flow (Start → End)

1. Add Datadog Trace module, set Mode: Start

   • Service: my-iot-service
   • Resource: sensor-processing

2. Add your processing modules...

3. Add Datadog Trace module, set Mode: End

   • API Key: your-api-key
   • Region: US1

With Checkpoints (Detailed Analysis)

1. Trace (Start): Service: order-service, Resource: process-order
2. Module A (parsing)
3. Trace (Checkpoint): Span Name: Parse Message
4. Module B (transformation)
5. Trace (Checkpoint): Span Name: Transform Data
6. Module C (validation)
7. Trace (End): Span Name: Validate Output, API Key: xxx

Log Correlation

When using with Tsagko.Modules.Datadog.Logger:

┌─────────────┐   ┌────────┐   ┌────────┐   ┌────────────────┐   ┌───────────┐
│Trace(Start) │──▶│ Module │──▶│ Logger │──▶│Trace(Checkpoint)│──▶│Trace(End) │
└─────────────┘   └────────┘   └────────┘   └────────────────┘   └───────────┘

The Logger automatically reads trace context and includes dd.trace_id and dd.span_id in logs. Datadog then correlates logs with traces in the APM view.

Datadog Regions

Building from Source

dotnet build -c Release
dotnet pack -c Release

License

MIT License