Creating Spans
The orcher-monitoring crate provides typed span helpers for each component:
Workflow Spans
1use orcher_monitoring::tracing::create_workflow_span;23// Track workflow execution4let span = create_workflow_span("start", &workflow_id, Some("order_fulfillment"));5let _guard = span.enter();67tracing::info!(8 workflow_id = %workflow_id,9 order_count = input.orders.len(),10 "Starting order fulfillment"11);1213// Track individual steps14{15 let step_span = create_workflow_span("step", &workflow_id, Some("validate_orders"));16 let _step_guard = step_span.enter();1718 let validation = ctx.execute_task(validate_orders, input.clone()).await?;19 tracing::info!("Orders validated");20}2122{23 let step_span = create_workflow_span("step", &workflow_id, Some("process_payment"));24 let _step_guard = step_span.enter();2526 let payment = ctx.execute_task(charge_payment, input.amount).await?;27 tracing::info!("Payment processed");28}Task Spans
1use orcher_monitoring::tracing::create_task_span;23let span = create_task_span("execute", &task_id, Some("charge_payment"));4let _guard = span.enter();56tracing::info!(amount = %amount, "Processing payment");78let result = payment_gateway.charge(amount).await?;910tracing::info!(transaction_id = %result.id, "Payment completed");Storage Spans
1use orcher_monitoring::tracing::create_storage_span;23let span = create_storage_span("read", "workflow_executions", Some(1));4let _guard = span.enter();56let execution = repo.find_by_id(execution_id).await?;Worker Spans
1use orcher_monitoring::tracing::create_worker_span;23let span = create_worker_span("process", &worker_id, Some(&node_id));4let _guard = span.enter();56tracing::info!(worker_id = %worker_id, "Worker starting poll loop");Next Steps
- Context Propagation — Propagate trace context across service boundaries
- Best Practices — Sampling, visualization, and troubleshooting
- Tracing Overview — Setup and exporter configuration