Documentation / @tenancy-node/core / Observer

Class: Observer

Defined in: core/src/observability/observer.ts:41

Punto único de observabilidad del núcleo. Todos los logs usan los mismos campos:

campo	contenido
tenantId	id del tenant o null (central)
operation	'tenants.create', 'http.request', ...
outcome	'success' o 'error'
durationMs	duración de la operación
code	código estable del error (TENANCY_*)
errorId	id del error en el ErrorTracker
err	el error (con stack)

Constructors

Constructor

new Observer(deps): Observer

Defined in: core/src/observability/observer.ts:45

Parameters

deps

ObserverDeps

Returns

Observer

Accessors

logger

Get Signature

get logger(): Logger

Defined in: core/src/observability/observer.ts:84

Returns

Logger

Methods

correlation()

correlation(): Record<string, unknown>

Defined in: core/src/observability/observer.ts:80

Campos de correlación (traceId...) para logs escritos fuera del observer.

Returns

Record<string, unknown>

---

recordRequest()

recordRequest(sample): void

Defined in: core/src/observability/observer.ts:71

Lo usan los adaptadores al terminar cada petición.

Parameters

sample

RequestSample

Returns

void

---

reportError()

reportError(operation, error, context?, expected?): TrackedError

Defined in: core/src/observability/observer.ts:92

Registra un error: lo escribe en el log (nivel error, o warn si expected) y lo guarda en el tracker del tenant. Devuelve el registro.

Parameters

operation

string

error

unknown

context?

ReportContext = {}

expected?

boolean = false

Returns

TrackedError

---

tenantResolved()

tenantResolved(tenantId): void

Defined in: core/src/observability/observer.ts:75

Parameters

tenantId

string | null

Returns

void

---

trace()

trace<T>(operation, context, fn, options?): Promise<T>

Defined in: core/src/observability/observer.ts:137

Ejecuta una operación y la deja registrada: info al terminar bien, error al fallar. El error se vuelve a lanzar sin cambios.

Type Parameters

T

T

Parameters

operation

string

context

ReportContext

fn

() => Promise<T>

options?

isExpected?

(error) => boolean

successLevel?

"info" | "debug"

Returns

Promise<T>