Interface: AppLogEvent

One entry of an application’s own log, published on the session timeline.

Two sources feed this event and they carry different payloads: a followed file yields line, an instrumented adapter yields a structured record. Exactly one of them is present.

Properties

label?

readonly optional label?: string

Defined in: driver/src/api.ts:944

line?

readonly optional line?: string

Defined in: driver/src/api.ts:951

Raw line, for a followed file. Truncated lines end with an ellipsis.

path?

readonly optional path?: string

Defined in: driver/src/api.ts:949

Path of the followed file, for source: 'file'. A label can be short and shared between sources; the path is what a reader opens.

record?

readonly optional record?: LogRecord

Defined in: driver/src/api.ts:953

Structured record, for an adapter that negotiated the logs capability.

source

readonly source: "file" | "adapter"

Defined in: driver/src/api.ts:943

timeMs

readonly timeMs: number

Defined in: driver/src/api.ts:962

Milliseconds since session start, on the same clock as every other event.

For a file this is when the driver read the line, not when the program wrote it: the two differ by up to one poll interval, so treat it as an upper bound rather than as the write timestamp. A record carries the adapter’s own timestamp inside it.