Skip to content

Commit

Permalink
Clarify the relationship between --quiet and --log-level (#4850)
Browse files Browse the repository at this point in the history
Resolves #4822

adds info about dbt list command and log level warn and quiet to the log
page per issue above.


[preview](https://docs-getdbt-pflps5eie-dbt-labs.vercel.app/reference/global-configs/logs#dbt-list-logging)

---------

Co-authored-by: Leona B. Campbell <3880403+runleonarun@users.noreply.github.com>
  • Loading branch information
mirnawong1 and runleonarun authored Feb 2, 2024
1 parent 33cf3aa commit 092c74a
Showing 1 changed file with 11 additions and 1 deletion.
12 changes: 11 additions & 1 deletion website/docs/reference/global-configs/logs.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,9 +118,19 @@ Supply the `-q` or `--quiet` flag to `dbt run` to show only error logs and suppr
```text
dbt --quiet run
...
```

### dbt list logging

In [dbt version 1.5](/docs/dbt-versions/core-upgrade/upgrading-to-v1.5#behavior-changes), we updated the logging behavior of the [dbt list](/reference/commands/list) command to include `INFO` level logs by default.


You can use either of these parameters to ensure clean output that's compatible with downstream processes, such as piping results to [`jq`](https://jqlang.github.io/jq/manual/), a file, or another process:

- `dbt --log-level warn list` (recommended; equivalent to previous default)
- `dbt --quiet list` (suppresses all logging less than ERROR level, except for "printed" messages and list output)


### Logging relational cache events

The `LOG_CACHE_EVENTS` config allows detailed logging for [relational cache](reference/global-configs/cache) events, which are disabled by default.
Expand Down

0 comments on commit 092c74a

Please sign in to comment.