Skip to content

Graphorin API reference v0.15.1


Graphorin API reference / @graphorin/core / / Logger

Interface: Logger ​

Defined in: packages/core/src/contracts/logger.ts:32

Stable

Pluggable logger contract consumed by every @graphorin/* runtime package. The concrete implementation lives in @graphorin/observability

  • declaring the interface here keeps level-zero packages free of an observability dependency.

Loggers are intentionally structured and side-effect-free in the type contract: the info(msg, fields?) signature is a hint, not a mandate to actually emit anything. Implementations may sample, drop, or batch.

Methods ​

child() ​

ts
child(fields): Logger;

Defined in: packages/core/src/contracts/logger.ts:43

Return a child logger with fields merged into every record's structured payload. Useful for binding runId / sessionId / agentId once at the top of a request.

Parameters ​

ParameterType
fieldsLogFields

Returns ​

Logger


debug() ​

ts
debug(message, fields?): void;

Defined in: packages/core/src/contracts/logger.ts:34

Parameters ​

ParameterType
messagestring
fields?Readonly<Record&lt;string, unknown&gt;>

Returns ​

void


error() ​

ts
error(message, fields?): void;

Defined in: packages/core/src/contracts/logger.ts:37

Parameters ​

ParameterType
messagestring
fields?Readonly<Record&lt;string, unknown&gt;>

Returns ​

void


info() ​

ts
info(message, fields?): void;

Defined in: packages/core/src/contracts/logger.ts:35

Parameters ​

ParameterType
messagestring
fields?Readonly<Record&lt;string, unknown&gt;>

Returns ​

void


trace() ​

ts
trace(message, fields?): void;

Defined in: packages/core/src/contracts/logger.ts:33

Parameters ​

ParameterType
messagestring
fields?Readonly<Record&lt;string, unknown&gt;>

Returns ​

void


warn() ​

ts
warn(message, fields?): void;

Defined in: packages/core/src/contracts/logger.ts:36

Parameters ​

ParameterType
messagestring
fields?Readonly<Record&lt;string, unknown&gt;>

Returns ​

void