record_exception() | Respan Docs

Signature

1 record_exception(
2     exception: Exception,
3     attributes: Dict = None,
4     timestamp: int = None,
5     escaped: bool = False,
6 ) -> bool

Returns True if the exception was recorded successfully.

Parameters

Parameter	Type	Description
`exception`	`Exception`	The exception to record.
`attributes`	`Dict \| None`	Additional attributes for the exception event.
`timestamp`	`int \| None`	Unix timestamp in nanoseconds. Defaults to current time.
`escaped`	`bool`	Whether the exception escaped the span’s scope.

Example

1 from respan import Respan, task, get_client
2 
3 respan = Respan(api_key="your-api-key")
4 
5 @task(name="validate_input")
6 def validate_input(data):
7     client = get_client()
8     try:
9         if not data:
10             raise ValueError("Input data is empty")
11         return data
12     except Exception as e:
13         client.record_exception(e, {"phase": "validation"})
14         return None
15 
16 validate_input("")

Decorators automatically record unhandled exceptions. Use record_exception() when you catch and handle exceptions but still want them visible in the trace.