Operations

Creating Spans


The orcher-monitoring crate provides typed span helpers for each component:

Workflow Spans

1
use orcher_monitoring::tracing::create_workflow_span;
2
3
// Track workflow execution
4
let span = create_workflow_span("start", &workflow_id, Some("order_fulfillment"));
5
let _guard = span.enter();
6
7
tracing::info!(
8
workflow_id = %workflow_id,
9
order_count = input.orders.len(),
10
"Starting order fulfillment"
11
);
12
13
// Track individual steps
14
{
15
let step_span = create_workflow_span("step", &workflow_id, Some("validate_orders"));
16
let _step_guard = step_span.enter();
17
18
let validation = ctx.execute_task(validate_orders, input.clone()).await?;
19
tracing::info!("Orders validated");
20
}
21
22
{
23
let step_span = create_workflow_span("step", &workflow_id, Some("process_payment"));
24
let _step_guard = step_span.enter();
25
26
let payment = ctx.execute_task(charge_payment, input.amount).await?;
27
tracing::info!("Payment processed");
28
}

Task Spans

1
use orcher_monitoring::tracing::create_task_span;
2
3
let span = create_task_span("execute", &task_id, Some("charge_payment"));
4
let _guard = span.enter();
5
6
tracing::info!(amount = %amount, "Processing payment");
7
8
let result = payment_gateway.charge(amount).await?;
9
10
tracing::info!(transaction_id = %result.id, "Payment completed");

Storage Spans

1
use orcher_monitoring::tracing::create_storage_span;
2
3
let span = create_storage_span("read", "workflow_executions", Some(1));
4
let _guard = span.enter();
5
6
let execution = repo.find_by_id(execution_id).await?;

Worker Spans

1
use orcher_monitoring::tracing::create_worker_span;
2
3
let span = create_worker_span("process", &worker_id, Some(&node_id));
4
let _guard = span.enter();
5
6
tracing::info!(worker_id = %worker_id, "Worker starting poll loop");

Next Steps