> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# logs

> View function logs

View logs from your [backend functions](/developers/backend/resources/backend-functions/overview) in the terminal. By default the command returns the 50 most recent log entries across all functions for the target app. Use flags to filter by function name, time range, or adjust the number of results.

## Usage

```bash theme={null}
base44 logs
```

Run from a linked project directory to fetch logs for the app in `.app.jsonc`, or target any app on your account by passing [`--app-id`](/developers/references/cli/commands/introduction#select-a-target-app) or setting the `BASE44_APP_ID` environment variable. With an explicit app id, you can run `logs` from anywhere on your machine, including against apps you built in the Base44 online app editor and never linked locally.

## Flags

| Flag                 | Description                                                                                                                                                                   |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--app-id <id>`      | Target the specified app. Defaults to the app linked in the current project. See [Select a target app](/developers/references/cli/commands/introduction#select-a-target-app). |
| `--function <names>` | Filter by function name. Accepts a comma-separated list. If omitted, fetches logs for all functions.                                                                          |
| `--since <datetime>` | Show logs from this time onward. Accepts [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.                                                                           |
| `--until <datetime>` | Show logs up to this time. Accepts [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.                                                                                 |
| `-n, --limit <n>`    | Maximum number of results to return, between `1` and `1000`. Defaults to `50`.                                                                                                |
| `--order <order>`    | Sort order: `asc` or `desc`. Defaults to `desc`.                                                                                                                              |

## Output format

The output is a list of log entries sorted by time.

Each entry shows the timestamp, level, function name in brackets, and log message. For example:

```
Showing 4 function log entries

2026-02-24 08:23:37 ERROR [send-email] Failed to deliver to user@example.com: connection timed out
2026-02-24 08:23:37 INFO  [send-email] Sending welcome email to user@example.com
2026-02-24 08:23:36 INFO  [process-order] Order #1042 processed successfully
2026-02-24 08:23:36 DEBUG [process-order] isolate start time: 350.47 ms (user time: 69.32 ms)
```

The log level reflects the console method used in your function code:

| Console method  | Log level |
| --------------- | --------- |
| `console.log`   | `INFO`    |
| `console.info`  | `INFO`    |
| `console.error` | `ERROR`   |
| `console.warn`  | `WARNING` |
| `console.debug` | `DEBUG`   |

The output also includes system-level entries from Deno Deploy, such as isolate startup times. The log level for these entries is assigned by Deno Deploy.

<Tip>
  The [base44-troubleshooter](/developers/backend/overview/skills#base44-troubleshooter) skill teaches your agent to fetch and analyze logs for you. Try asking it to "show me all errors from the last hour."
</Tip>

## See also

* [Backend Functions](/developers/backend/resources/backend-functions/overview): Learn about serverless functions
* [`deploy`](/developers/references/cli/commands/deploy): Deploy all project resources to Base44
* [`functions deploy`](/developers/references/cli/commands/functions-deploy): Deploy local functions to Base44
* [`functions list`](/developers/references/cli/commands/functions-list): List all deployed functions