CloudWatch Logs
Last updated 16 October 2026
The Logs page lists every CloudWatch log group in a profile and region. Open one to search it, read its streams, tail it live or query it with Logs Insights. Check several groups to tail or query them together. Everything is read-only: ARNscope never creates or deletes log groups, changes retention or saves queries in your account.
Finding a log group
The list loads 50 groups at a time (Load more, up to 5,000). Typing filters the loaded groups on your Mac. Press Enter to search AWS instead:
- Text starting with
/searches by name prefix (for example/ecs/). Rows show size, retention and the log class. - Any other text is a case-sensitive match anywhere in the name (for example
user-api). AWS returns only the name for these rows; ARNscope reads the details when you open one.
Searching on every keystroke would spend the account’s shared DescribeLogGroups quota (10 requests a second per region), so the server search runs only on Enter.
Search, streams, live tail and Insights
| Tab | What it does | AWS call | Billing |
|---|---|---|---|
| Search | Filter-pattern search over the open group, newest events first, up to 30 days per search | FilterLogEvents |
Standard API pricing |
| Streams | The group’s streams by latest activity, or by name under a prefix; open one to read it newest first, with Load older and Load newer | DescribeLogStreams, GetLogEvents |
Standard API pricing |
| Live tail | New events from up to 10 groups as they are written, optionally narrowed by a filter pattern and, for one group, by stream names or prefixes | StartLiveTail |
Per minute while running |
| Insights | A Logs Insights query over up to 50 checked groups, with the rows in a grid you can export as CSV | StartQuery, GetQueryResults, StopQuery |
Per GB scanned |
Logs Insights is billed per GB scanned
A query runs only when you press Run (or ⌘/Ctrl+Enter in the editor). Opening the page, opening a favourite, switching tabs and auto-refresh never run one. While it runs you see its status, the records matched and scanned and the bytes scanned, and Cancel stops it in CloudWatch. ARNscope stops a query that is still running after 15 minutes, and stops any running query when you close its view or change profile or region. Results are capped at 10,000 rows.
Live Tail is billed per minute
A tail starts only from Start tail (or a “Live tail” action) and stops when you leave the page or tab, change what it targets, or close the view. ARNscope runs at most 5 tails at once; AWS allows 15 concurrent Live Tail sessions per account and region, shared with everyone using it. Starting a sixth shows “Live tail limit reached. Stop another live tail first.” Pause holds the display while new lines keep arriving in memory.
When an update is too busy, CloudWatch samples it and ARNscope says so.
Favourite queries and filters
The ☆ next to the Insights editor and the Search and Live tail filters saves what you typed. Choose where it applies:
- Only these log groups: tied to the checked groups in this profile and region. Opening it from anywhere switches to that profile and region, checks its groups and fills it in. This is the default for Insights queries.
- Any log group: not tied to a profile or region. Opening it applies it to the groups checked now; with none checked, ARNscope asks you to select some. This is the default for filters.
A favourite remembers its time range when it was a preset (Last hour, Last 24 hours, …). Opening an Insights favourite fills the query in; it runs only when you press Run. Opening a Search filter runs the search. Rename and remove favourites from their ⋯ menu, which also opens one in a new tab or beside the current view (⌘/Ctrl-click opens beside).
Favourites, the Insights query and the search filter you were typing (per profile and region) are stored on your Mac only.
ECS task logs
On the ECS page, a task’s Logs tab reads the task’s own awslogs stream (<prefix>/<container>/<task-id>), newest first, 200 events at a time, with Load older. A filter pattern (press Enter) searches the stream on the server across the task’s lifetime. The warning button searches warnings and errors. For a running task, the live tail button tails just that container’s stream. Open in Logs opens the group and stream on the Logs page in a tab pinned to that profile and region.
A service’s header has Open logs, which opens its containers’ log group (or offers a choice when containers log to different groups).
Containers that use another log driver, or awslogs without a stream prefix, show why their stream cannot be found.
Memory limits
Logs stay in memory, never on disk:
- A live tail keeps the newest 2,000 lines or 8 MiB per view; older lines are dropped and the count shows how many.
- Search and stream reads keep up to 10,000 events loaded (this also caps Load more on the Lambda page).
- Insights keeps up to 10,000 rows.
- A row shows the first 16 KiB of a message; Show all opens the rest, and JSON messages open pretty-printed.
Permissions
| Action | Used for |
|---|---|
logs:DescribeLogGroups |
The list, server search and group details |
logs:DescribeLogStreams |
The Streams tab |
logs:GetLogEvents |
Reading a stream (also ECS task logs) |
logs:FilterLogEvents |
Search (also ECS task log filters) |
logs:StartLiveTail |
Live tail |
logs:StartQuery, logs:GetQueryResults, logs:StopQuery |
Logs Insights |
Log groups encrypted with a customer-managed KMS key also need kms:Decrypt on that key. Log groups shared from other accounts are not listed.