# CloudWatch Logs

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.

<figure class="doc-video">
<video controls playsinline preload="none" poster="/media/docs/logs/logs-explainer.webp?v=1" aria-label="CloudWatch Logs in ARNscope: a narrated tour of about a minute and a quarter">
<source src="/media/docs/logs/logs-explainer.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-explainer.mp4?v=1" type="video/mp4">
<track kind="captions" srclang="en" label="English" src="/media/docs/logs/logs-explainer.vtt?v=1" default>
</video>
<figcaption>A narrated tour, with captions: finding groups, search, streams, live tail, Logs Insights, favourites and memory limits. Sample data.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-find.webp?v=1" aria-label="Typing to filter the loaded log groups, then /ecs/ and Enter to search CloudWatch by name prefix.">
<source src="/media/docs/logs/logs-find.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-find.mp4?v=1" type="video/mp4">
</video>
<figcaption>Type to filter what is loaded; Enter searches CloudWatch.</figcaption>
</figure>

## 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** |

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-search.webp?v=1" aria-label="Searching a log group with the Errors and Warnings quick filters, newest events first.">
<source src="/media/docs/logs/logs-search.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-search.mp4?v=1" type="video/mp4">
</video>
<figcaption>Search, newest first, with quick filters for errors and warnings.</figcaption>
</figure>

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-streams.webp?v=1" aria-label="Opening a log stream, loading older events, and the button that tails just that stream.">
<source src="/media/docs/logs/logs-streams.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-streams.mp4?v=1" type="video/mp4">
</video>
<figcaption>A stream, read older or newer, or tailed on its own.</figcaption>
</figure>

### 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-insights.webp?v=1" aria-label="A Logs Insights query over three groups: it runs on Run, shows records and bytes scanned, and Cancel stops it.">
<source src="/media/docs/logs/logs-insights.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-insights.mp4?v=1" type="video/mp4">
</video>
<figcaption>Nothing runs until Run; the status bar counts the bytes scanned.</figcaption>
</figure>

### 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-multi-tail.webp?v=1" aria-label="Checking two more log groups and starting one live tail over all three; lines from each group arrive.">
<source src="/media/docs/logs/logs-multi-tail.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-multi-tail.mp4?v=1" type="video/mp4">
</video>
<figcaption>One tail over three groups. It stops when you leave.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-favourites.webp?v=1" aria-label="Saving an Insights query as a favourite for these log groups, then opening it: the query fills in and waits for Run.">
<source src="/media/docs/logs/logs-favourites.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-favourites.mp4?v=1" type="video/mp4">
</video>
<figcaption>A favourite fills the query in; it still waits for Run.</figcaption>
</figure>

## 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.

<figure class="doc-clip">
<video data-clip controls muted loop playsinline preload="none" poster="/media/docs/logs/logs-memory.webp?v=1" aria-label="A flooding load-test log group tailed live: the status shows the newest 2,000 lines kept and the count dropped.">
<source src="/media/docs/logs/logs-memory.webm?v=1" type="video/webm">
<source src="/media/docs/logs/logs-memory.mp4?v=1" type="video/mp4">
</video>
<figcaption>A noisy tail keeps the newest 2,000 lines and counts what it dropped.</figcaption>
</figure>

## 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.

Source: https://arnscope.com/docs/logs
