orkes.graph.TracesSchema

pydantic model orkes.graph.TracesSchema

Represents the complete execution trace of a graph run.

This schema aggregates all node and edge traces for a single graph execution, along with execution metadata such as timing and status. It provides a comprehensive, ordered record of how the graph was executed.

graph_name

The name of the executed graph.

Type:

str

graph_description

A description of the executed graph.

Type:

str

run_id

The unique identifier for this execution run.

Type:

str

start_time

The Unix timestamp (in seconds) indicating when the execution started.

Type:

float

elapsed_time

Total execution duration in seconds.

Type:

float

status

Final execution status (e.g., “SUCCESS”, “FAILED”).

Type:

str

nodes_trace

Traces for all nodes executed during the run.

Type:

list[NodeTrace]

edges_trace

Traces for all edges traversed during the run.

Type:

list[EdgeTrace]

Fields:

• edges_trace (list[orkes.graph.schema.EdgeTrace])

• elapsed_time (float)

• graph_description (str)

• graph_name (str)

• nodes_trace (list[orkes.graph.schema.NodeTrace])

• run_id (str)

• start_time (float)

• status (str)

field edges_trace: list[EdgeTrace] [Required]

field elapsed_time: float = 0.0

field graph_description: str [Required]

field graph_name: str [Required]

field nodes_trace: list[NodeTrace] [Required]

field run_id: str [Required]

field start_time: float = 0.0

field status: str = 'FAILED'