2e712d367a
* Add OpenTelemetry workflow instrumentation * Fix workflow telemetry metric tags * Tighten telemetry test listeners * Refine workflow telemetry boundaries * Address telemetry review feedback * Complete workflow telemetry coverage * Address telemetry instrumentation review feedback * Handle cancelled workflow telemetry * Refine workflow activity telemetry tags * Address telemetry review feedback * Document OpenTelemetry extension coexistence Agent-Logs-Url: https://github.com/elsa-workflows/elsa-core/sessions/33211c71-c3c9-424c-b7eb-a13ebd4713a3 Co-authored-by: sfmskywalker <938393+sfmskywalker@users.noreply.github.com> * Address telemetry PR review comments * Address telemetry review follow-ups * Preserve workflow executing status transition order * Address telemetry review feedback * Refine workflow telemetry review fixes * Address telemetry review feedback * Address workflow instrumentation review feedback * Fix faulted workflow telemetry tags * Restrict workflow exception mutation * Fix canceled activity telemetry status * Clarify workflow exception access * Cover HTTP trace context propagation * Report cancelled workflow telemetry consistently * Refine telemetry cancellation classification * Record thrown workflow exceptions on context * Tighten workflow telemetry exception handling * Preserve first workflow exception * Handle workflow cancellation separately * Clarify workflow telemetry enum references --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: sfmskywalker <938393+sfmskywalker@users.noreply.github.com>
2.2 KiB
OpenTelemetry Workflow Instrumentation
Elsa emits first-party OpenTelemetry-compatible workflow and activity instrumentation through System.Diagnostics.
To collect workflow traces, configure OpenTelemetry to listen to the Elsa.Workflows activity source. To collect workflow metrics, configure it to listen to the Elsa.Workflows meter.
services.AddOpenTelemetry()
.WithTracing(builder => builder.AddSource("Elsa.Workflows"))
.WithMetrics(builder => builder.AddMeter("Elsa.Workflows"));
If you previously enabled workflow tracing through the Elsa.OpenTelemetry extension package, avoid enabling both the extension tracing middleware and the first-party workflow spans for the same host unless duplicate workflow and activity spans are acceptable. Both integrations publish to the Elsa.Workflows activity source so existing collectors can keep the same source configuration.
Traces
Elsa creates spans around workflow execution cycles and activity execution. The spans include workflow and activity identifiers, definition metadata, status, tenant ID when available, and fault status. Workflow input, activity input, output payloads, headers, and variable values are not added as span attributes.
Faulted workflow and activity spans use ActivityStatusCode.Error and record the exception type as exception.type when an exception is available. Exception messages and stack traces are not added to spans or exception events by Elsa workflow instrumentation.
Outbound SendHttpRequest and FlowSendHttpRequest calls inject the current W3C trace context headers when an active workflow/activity span exists, so downstream services can continue the same trace without Elsa-specific middleware. Enable standard .NET HTTP client instrumentation in your OpenTelemetry setup when you want outbound HTTP spans for these calls.
Metrics
The Elsa.Workflows meter emits:
elsa.workflow.startedelsa.workflow.completedelsa.workflow.faultedelsa.activity.durationin seconds
Metric tags use the same low-cardinality workflow and activity metadata as the spans where practical. The started counter omits execution status tags because it records the pre-execution boundary; completed and faulted counters include terminal workflow status tags.