Traceability

Kind: quality-attribute

Layer: Observability

Record: architecture:traceability

Severity: mandatory

Scope: request, workflow, change

Canonical: Ontology

The degree to which a request, workflow or change can be followed end to end through correlated records.

Listed in Architecture principles, after Audit Logging and before Correlation ID.

Requires

• Correlation ID
• Logs/Traces

Reinforces

• Debuggability
• Auditability

Enables

• End-to-End Causality

Conflicts with

• Anonymous Flow

In tension with

• Metadata Propagation Overhead
• Dynamic Dispatch
• Choreography
• Polymorphism
• Chain of Responsibility Pattern
• Inversion of Control
• Dynamic Dispatch / Traceability
• Choreography / Traceability
• Polymorphism / Traceability
• Chain of Responsibility Pattern / Traceability
• Inversion of Control (IoC) / Traceability

Tensions

• Traceability / Metadata Propagation Overhead

Violated by

• Uncorrelated Events

Refactored by

• Correlation ID
• Distributed Tracing

Severity

• mandatory

Category

• Observability / Auditability / Traceability

Enforced by

• codemods/entrypoints/specifier.target.entrypoint.ts
• codemods/validators/reference.validator.ts
• runtime/entrypoints/template.entrypoint.ts
• runtime/entrypoints/invocation.entrypoint.ts

Reinforced by

• Causality
• Causal Dependency
• Architecture Decision Records
• Logging
• Audit Logging
• Dashboards

Required by

• Explainability

Linked from

• Documentation is code
• A system is a graph
• Runtime Discovery / Dynamic Binding
• Causality / Ordering / Distributed Time
• Control / Coordination / Centralization
• SOLID / Object-Oriented Design
• Architecture Review / Evolution / Governance Artifacts
• Model Architecture
• Observability / Auditability / Traceability
• Behavioral Patterns
• Plugin / Extensibility / IoC
• Observability / Auditability / Traceability
• Quality Attributes
• Severity levels
• The resolutions