> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cli/reference/logs.md).

# norbix logs

Read project logs.

Read project logs.

3 commands (`@norbix.ai/cli` 1.16.0):

* [`norbix logs list`](#norbix-logs-list) — Read project logs, newest first
* [`norbix logs settings`](#norbix-logs-settings) — Show project log settings
* [`norbix logs trail`](#norbix-logs-trail) — Show the full request trail for one correlation ID

## `norbix logs list`

Read project logs, newest first

```sh
norbix logs list [flags]
```

| Flag                      | Description                              |
| ------------------------- | ---------------------------------------- |
| `--level` `<value>`       | Severity: Information, Warning or Error  |
| `--module` `<value>`      | Module: Database, Email, Membership, ... |
| `--search` `<value>`      | Free-text search over title and message  |
| `--event-code` `<value>`  | Exact event code (e.g. db:record:insert) |
| `--correlation` `<value>` | Correlation ID filter                    |
| `--from` `<value>`        | From timestamp (UTC, ISO 8601)           |
| `--to` `<value>`          | To timestamp (UTC, ISO 8601)             |
| `--page-size` `<value>`   | Records per page — default: `50`         |
| `--after` `<value>`       | Cursor: fetch the page after this item   |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix logs list
norbix logs list --level Error --module Database
norbix logs list --search "timeout" --page-size 100 --json
```

## `norbix logs settings`

Show project log settings

```sh
norbix logs settings
```

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix logs settings
```

## `norbix logs trail`

Show the full request trail for one correlation ID

```sh
norbix logs trail CORRELATIONID
```

| Argument        | Required | Description    |
| --------------- | -------- | -------------- |
| `CORRELATIONID` | yes      | Correlation ID |

Also takes the [global flags](/codemash/cli/reference.md#global-flags): `--json`, `--project`, `--env`, `--region`, `--api-key`, `--account`, `--profile`.

Examples:

```sh
norbix logs trail 8f2c1b4d-9e3a-4f7b-a1c2-d3e4f5a6b7c8
```