Requires CLI v0.5.8 or newer; --tail requires CLI v0.5.10 or newer.
telnyx-edge actors logs <type> prints a StatefulActor type’s recent logs, oldest line first. It reads a window of history and exits — it does not stay attached. Without --type, both log streams print interleaved by time:
Runtime logs
Runtime logs are theconsole.log/error output your method bodies write — your actor’s own logging, nothing else:
[timestamp] [level] message.
Invocation logs
Invocation logs are one platform-recorded record per method call — auto-RPC,fetch(), or alarm(): which instance handled it, the method, the outcome (ok/error), and how long it took. Invocation logs report traffic even for a type that logs nothing:
[timestamp] instance method outcome <duration>ms.
Unlike a function, whose invocations are HTTP requests, an actor’s invocations are method calls routed through the actor runtime — a function calling env.COUNTER.increment(1) produces one invocation record per call, attributed to the instance that handled it.
Following live logs
Pass--tail to switch to live mode: instead of reading a window of history and exiting,
the command stays attached and streams new log lines as they arrive. Ctrl-C stops cleanly.
--type and --instance filter it the same way as history mode. --since and --last are
ignored in live mode — there is no history to page through.
With --json, live mode emits one JSON object per line instead of the single object history
mode produces, since the stream has no end.
Live mode has no replay: a session is severed roughly every 10 minutes by the API edge proxy.
The CLI reconnects automatically (with backoff, reporting each retry), but lines emitted during
the gap are lost — use history mode when completeness matters.
Flags
--since and --last are clamped rather than refused when they exceed the maximum. To watch logs as they arrive instead of reading a window, use --tail (see Following live logs).
Full command reference: CLI reference.