Detailed Error Tracing

When issues arise, IdentityFlow provides detailed error traces to help you quickly diagnose and resolve problems in your workflows.

Example Trace Log Format:

(Actual format may vary based on your logger configuration)

[2025-02-11T22:02:53.211Z] › c6b9a8fd01498c146cbbcb565c91a062
│
└ +0.000s / 0.018s ✓ workflow.scheduler.processing
   • workflow.scheduler.processing.count: 1
   • workflow.scheduler.scheduled.id: AZT3CVsve923tR4CjdPcfw
   • workflow.scheduler.scheduled.kind: step.timeout
   • workflow.instance.id: AZT3CVsLf7OSK6dzkBf0aA
   • workflow.step.id: AZT3CVsockidGYJPUSnu8Q
   • workflow.instance.status: active
   • workflow.definition.id: AZT3CVr4cdesZRJlu5O7SA
   • workflow.definition.name: 1344092612_0_2_1

Information Captured in Traces Often Includes:

• Timestamps for each event and step.
• Unique identifiers for workflow instances, steps, and definitions.
• Workflow status at various points.
• Relevant context or error messages.
• Correlation IDs for tracking across services (when using OpenTelemetry).

Benefits of Detailed Tracing:

• Rapid Diagnosis: Quickly understand the sequence of events leading to an error.
• Reduced Debugging Time: Pinpoint the exact step and context where a failure occurred.
• Improved System Understanding: Gain better insight into how your workflows are executing.

Combined with OpenTelemetry integration, error tracing in IdentityFlow provides powerful tools for maintaining healthy and reliable automations.

Learn more about Error Handling in our Deep Dive.