Juncture Tracing

OpenTelemetry integration and structured tracing for Juncture graph execution.

Features

• Structured Spacing: Consistent span naming (juncture.{component}.{action})
• OpenTelemetry Export: OTLP export for distributed tracing (feature otel)
• Metrics Collection: OpenTelemetry metrics for graph execution
• Graph Callbacks: Event handlers for graph lifecycle

Usage

Basic Tracing (No OTel)

use juncture_tracing::init_tracing;

// Initialize tracing subscriber with env filter
init_tracing();

OpenTelemetry Integration

use juncture_tracing::init;

// Configure and install OTel tracing
init()
    .with_service_name("my-juncture-app")
    .install()
    .await?;

Span Hierarchy

juncture.graph.invoke
  juncture.superstep
    juncture.node.execute
      juncture.llm.call
      juncture.tool.call
      juncture.checkpoint.put

Feature Flags

License

Licensed under Apache License, Version 2.0. See LICENSE for details.