Module: LanguageOperator::Instrumentation::TaskTracer

Included in:
Agent::TaskExecutor
Defined in:
lib/language_operator/instrumentation/task_tracer.rb

Overview

OpenTelemetry instrumentation for task execution

Provides comprehensive tracing for DSL v1 task execution including:

  • Neural task execution (LLM calls with tool access)
  • Symbolic task execution (direct Ruby code)
  • Input/output validation
  • Retry attempts
  • Tool call tracking (when available)

Follows OpenTelemetry Semantic Conventions for GenAI: https://opentelemetry.io/docs/specs/semconv/gen-ai/

rubocop:disable Metrics/ModuleLength

Examples:

Enable full data capture

ENV['CAPTURE_TASK_INPUTS'] = 'true'
ENV['CAPTURE_TASK_OUTPUTS'] = 'true'
ENV['CAPTURE_TOOL_ARGS'] = 'true'

Performance overhead

Instrumentation adds <5% overhead with default settings
Overhead may increase to ~10% with full data capture enabled

Constant Summary collapse

MAX_CAPTURED_LENGTH =

Maximum length for captured data before truncation

1000