Skip to main content
GET
Stream CloudWatch logs (SSE)

Query Parameters

awsAccountId
string | null
required

Database ID of the AwsAccount to use for credentials

logGroupNames
string[]
required

CloudWatch log group names to stream from (e.g., /flightcontrol/runner). Usually a single group; the ECS task-detail drawer passes several because a single task's containers can log to different groups (a FireLens-routed app plus awslogs sidecars). Each group is queried with the same stream filter and the results are merged and deduped. At least one group is required.

logStreamPrefix
string | null

Log stream prefix to filter by (e.g., {commandId}/{instanceId}). Mutually exclusive with logStreamNames — pass exactly one.

logStreamNames
string[] | null

Explicit list of log stream names to filter by. When set, the handler uses FilterLogEvents with logStreamNames instead of logStreamNamePrefix, which lets the task-detail drawer scope its feed to the exact CloudWatch streams (//) owned by a single ECS task. Mutually exclusive with logStreamPrefix.

region
string | null
required

AWS region where logs are stored

startTime
string | null

Start time for historical logs (ISO 8601). Defaults to beginning of log stream.

endTime
string | null

End time for historical logs (ISO 8601). Defaults to now. Ignored if tail=true.

tail
boolean | null

If true, after fetching historical logs, switch to live tail mode for real-time streaming

filterPattern
string | null

Optional CloudWatch FilterPattern (e.g. "ERROR" or ""deploy_id":"abc"") applied to historical and live-tail events. Empty string disables filtering.

Response

200 - text/event-stream

SSE stream of CloudWatch log events

SSE event containing a batch of log events

events
object[]
required

Batch of log events

isFinal
boolean
required

Whether this is the final batch of historical logs