Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
5115b63
docs: add EdDSA/Ed25519 to allowed WebAuthn signature schemes
mraszyk May 13, 2026
603c136
feat: canister logs extensions
mraszyk May 13, 2026
e31e334
Revert "docs: add EdDSA/Ed25519 to allowed WebAuthn signature schemes"
mraszyk May 13, 2026
9d5b475
note
mraszyk May 13, 2026
f3919c0
Merge branch 'main' into mraszyk/canister-logs
mraszyk May 13, 2026
bfa60a5
reset log_memory_limit if canister out of cycles
mraszyk Jun 3, 2026
3665ee0
docs(logs): clarify canister log trimming direction
mraszyk Jul 17, 2026
92bd88e
docs(logs): drop fetch_canister_logs_cost (calls do not require cycles)
mraszyk Jul 17, 2026
9eb29f6
docs(logs): remove cycles-transfer note from fetch_canister_logs
mraszyk Jul 17, 2026
b3b765b
docs(logs): clarify returned-log size bound is the max response size
mraszyk Jul 17, 2026
9aef188
Merge branch 'main' into mraszyk/canister-logs
mraszyk Aug 11, 2026
99b8ef6
docs(logs): fix state field name in out-of-cycles rule
mraszyk Aug 11, 2026
aab9bb7
docs(logs): account for log memory store in canister memory usage
mraszyk Aug 11, 2026
8557682
docs(logs): reserve cycles for log memory limit changes
mraszyk Aug 11, 2026
c335515
docs(logs): model cycles consumed by log memory store resize
mraszyk Aug 11, 2026
254602a
docs(logs): restrict log_memory_limit to 0 or at least 4096 bytes
mraszyk Aug 17, 2026
d0e6239
docs(logs): return log_memory_limit from canister_status in the abstr…
mraszyk Aug 17, 2026
612cf51
docs(logs): return visibility settings from canister_status in the ab…
mraszyk Aug 17, 2026
daf217f
Merge remote-tracking branch 'origin/main' into mraszyk/canister-logs
mraszyk Aug 18, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/guides/canister-management/logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,8 @@ icp canister logs <canister-name> -e ic --since-index 100 --until-index 200

Timestamp and index filters cannot be combined with `--follow`.

Filtering also changes which records are dropped when the selected logs exceed the response size. An unfiltered read trims the oldest records, so it returns the most recent logs (the output ends with the newest record). A filtered read trims the newest records instead, so it returns the oldest records that match the filter (the output starts with the oldest matching record), which lets you page forward through a range by advancing the start of the filter.

To output logs as JSON for programmatic processing:

```bash
Expand Down Expand Up @@ -178,6 +180,8 @@ The default log buffer size is 4096 bytes. When the buffer fills up, older log e
icp canister settings update <canister-name> -e ic --log-memory-limit 2mib
```

The limit must be either 0 (no memory for logs) or at least 4096 bytes: values between 1 and 4095 are rejected.

Supported suffixes: `kb` (1,000 bytes), `kib` (1,024 bytes), `mb` (1,000,000 bytes), `mib` (1,048,576 bytes). In `icp.yaml`:

```yaml
Expand Down
4 changes: 1 addition & 3 deletions docs/guides/canister-management/settings.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -197,14 +197,12 @@ settings:

### Log memory limit

{/* Needs human verification: log_memory_limit is exposed by icp-cli but is absent from the canonical ic.did: verify whether this is a management canister setting or an icp-cli layer setting */}

Maximum memory for storing canister logs. Oldest logs are purged when usage exceeds this value.

| Property | Value |
|----------|-------|
| Type | Integer or string with suffix |
| Max | 2 MiB |
| Valid values | 0, or 4096 bytes up to 2 MiB (values between 1 and 4095 are rejected) |
| Default | 4096 bytes |
| icp.yaml key | `log_memory_limit` |

Expand Down
Loading
Loading