> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bioptimus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bioptimus.observability

Public observability helpers for logging, errors, context, and diagnostics.

A dependency-light, standard-library-only foundation shared by the SDK, the in-process local backend, and the FastAPI server. The package root exposes only the stable user-facing entry points:

* [`ErrorCode`](/sdk-reference/observability/errors#errorcode) / [`BioptimusError`](/sdk-reference/observability/errors#bioptimuserror) — typed, coded errors;
* correlation-context helpers ([`bind_context`](/sdk-reference/observability/context#bind_context), [`get_context`](/sdk-reference/observability/context#get_context), [`new_trace_id`](/sdk-reference/observability/context#new_trace_id));
* structured logging helpers ([`configure_logging`](/sdk-reference/observability/logging#configure_logging), [`default_log_file`](/sdk-reference/observability/logging#default_log_file), [`log_event`](/sdk-reference/observability/logging#log_event), [`log_failures`](/sdk-reference/observability/logging#log_failures), [`read_recent_logs`](/sdk-reference/observability/log_export#read_recent_logs), [`read_usage_records`](/sdk-reference/observability/log_export#read_usage_records)).

Lower-level formatters, anonymizers, and diagnostic probes are available from their implementation modules for internal composition, but they are not re-exported here as top-level SDK API. Endpoint verification (`bioptimus.observability.healthcheck.verify_endpoint`) is likewise imported from its module: unlike the helpers above it needs the model stack, so re-exporting it would pull those imports into every consumer of this package.