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

# qovery log

> Log viewing commands

## Overview

View and stream logs from any service — application, container, database, or job — running on Qovery.

## Commands

### Stream Logs

Stream real-time logs:

```bash theme={null}
qovery log
```

Stream logs for a specific service (regardless of its type):

```bash theme={null}
qovery log --service "httpbin"
```

Stream logs for a specific application:

```bash theme={null}
qovery log --application "my-api"
```

Stream logs in raw JSON format:

```bash theme={null}
qovery log --service "httpbin" --raw
```

## Options

| Flag             | Short | Description                                                                                   |
| ---------------- | ----- | --------------------------------------------------------------------------------------------- |
| `--organization` |       | Organization Name                                                                             |
| `--project`      |       | Project Name                                                                                  |
| `--environment`  |       | Environment Name                                                                              |
| `--service`      | `-s`  | Service name — tries application, container, database, and job APIs until a match is found    |
| `--service-id`   |       | Service UUID — directly stream logs by ID, skips name lookup (use with IDs from console URLs) |
| `--application`  | `-a`  | Application Name                                                                              |
| `--container`    | `-n`  | Container Name                                                                                |
| `--database`     | `-d`  | Database Name                                                                                 |
| `--job`          | `-j`  | Job Name                                                                                      |
| `--raw`          | `-r`  | Display logs in raw format (json)                                                             |
| `--help`         |       | Show help                                                                                     |

## Examples

### Stream Logs by Service Name

```bash theme={null}
# Stream logs — works for any service type
qovery log --service "httpbin"

# Stream logs for a specific application
qovery log --application "my-api"

# Stream logs for a specific database
qovery log --database "postgres-main"

# Stream logs for a specific job
qovery log --job "backup-job"
```

### Use Service ID from Console URL

When you have a Qovery console URL, you can use the service ID directly:

```bash theme={null}
# Extract the ID from a URL like:
# .../service/2c69dfd4-1c5a-44c3-ac65-8c6399cfbf31/service-logs
qovery log --service-id "2c69dfd4-1c5a-44c3-ac65-8c6399cfbf31"
```

### Raw Log Output

```bash theme={null}
# Display logs as raw JSON
qovery log --service "my-api" --raw
```

### Specify Context Explicitly

```bash theme={null}
# Provide full context to skip interactive prompts
qovery log \
  --organization "My Org" \
  --project "Backend" \
  --environment "production" \
  --service "my-api"
```

## Tips

<Tip>
  Use `--service-id` with the UUID from your Qovery console URL to stream logs
  without needing to know the service name. The ID is visible in the URL when
  you navigate to a service in the console.
</Tip>

<Tip>
  Use `--service` when you don't know (or don't want to specify) the type of
  your service. Qovery will try each API (application, container, database, job)
  until it finds a match. Use a specific flag (`--application`, `--database`,
  etc.) if you want to target a precise service type.
</Tip>

<Tip>
  Use `--raw` / `-r` to get logs in JSON format, which is useful for piping
  output to tools like `jq` for further processing.
</Tip>

## Related Commands

* [`qovery shell`](/cli/commands/shell) - Execute commands in container
* [`qovery status`](/cli/commands/status) - Check service status