Live tail¶
Stream new events as they arrive with Live Tail.
| Function | AWS operation | Notes |
|---|---|---|
startLiveTail({groups, streams?, streamPrefixes?, pattern?}, onEvent, {onUpdate?, onError?}) |
StartLiveTail (event stream) |
1–10 groups (names are turned into ARNs, see logGroupArn); streams / streamPrefixes need exactly one group. Returns after the sessionStart frame with a handle (sessionId, close() / stop(), done signal, last error). onUpdate gets each sessionUpdate (count, sampled flag); stream exceptions (SessionStreamingException, SessionTimeoutException) go to onError and end the session |
On AWS a session lasts up to 3 hours and sends keep-alive updates; the per-attempt
requestTimeout does not apply to it. client.close() stops every open session. The AWS SDKs use
the endpoint host prefix streaming- (botocore, aws-sdk-rust) or stream-; set url to a host
that resolves with either prefix when you use an emulator.