record_exception() | Respan Docs

Signature

record_exception(
    exception: Exception,
    attributes: Dict = None,
    timestamp: int = None,
    escaped: bool = False,
) -> 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

from respan import Respan, task, get_client
respan = Respan(api_key="your-api-key")
@task(name="validate_input")
def validate_input(data):
    client = get_client()
    try:
        if not data:
            raise ValueError("Input data is empty")
        return data
    except Exception as e:
        client.record_exception(e, {"phase": "validation"})
        return None
validate_input("")

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