# События и логи

Во время выполнения dbt генерирует события. Наиболее распространенный способ увидеть эти события — это лог-сообщения, которые записываются в реальном времени в два места:

* Терминал командной строки (`stdout`), чтобы обеспечить интерактивную обратную связь во время выполнения dbt.
* Файл отладочного лога (`logs/dbt.log`), чтобы обеспечить детальное [отладку ошибок](https://docs.getdbt.tech/guides/debug-errors.md) при их возникновении. Лог-сообщения в текстовом формате в этом файле включают все события уровня `DEBUG`, а также контекстную информацию, такую как уровень лога и имя потока. Местоположение этого файла можно настроить с помощью [флага `log-path`](https://docs.getdbt.tech/reference/global-configs/logs.md).

CLI

```bash
21:35:48  6 of 7 OK created view model dbt_testing.name_list......................... [CREATE VIEW in 0.17s]
```

logs/dbt.log

```text
============================== 21:21:15.272780 | 48cef052-3819-4550-a83a-4a648aef5a31 ==============================
21:21:15.272780 [info ] [MainThread]: Running with dbt=1.5.0-b5
21:21:15.273802 [debug] [MainThread]: running dbt with arguments {'printer_width': '80', 'indirect_selection': 'eager', 'log_cache_events': 'False', 'write_json': 'True', 'partial_parse': 'True', 'cache_selected_only': 'False', 'warn_error': 'None', 'fail_fast': 'False', 'debug': 'False', 'log_path': '/Users/jerco/dev/scratch/testy/logs', 'profiles_dir': '/Users/jerco/.dbt', 'version_check': 'False', 'use_colors': 'False', 'use_experimental_parser': 'False', 'no_print': 'None', 'quiet': 'False', 'log_format': 'default', 'static_parser': 'True', 'introspect': 'True', 'warn_error_options': 'WarnErrorOptions(include=[], exclude=[])', 'target_path': 'None', 'send_anonymous_usage_stats': 'True'}
21:21:16.190990 [debug] [MainThread]: Partial parsing enabled: 0 files deleted, 0 files added, 0 files changed.
21:21:16.191404 [debug] [MainThread]: Partial parsing enabled, no changes found, skipping parsing
21:21:16.207330 [info ] [MainThread]: Found 2 models, 0 tests, 0 snapshots, 1 analysis, 535 macros, 0 operations, 1 seed file, 0 sources, 0 exposures, 0 metrics, 0 groups
```

## Структурированное логирование

(Версии dbt: v2.0 и новее)

dbt v2 формирует структурированную телеметрию выполнения в соответствии с соглашениями [OpenTelemetry](https://opentelemetry.io/), а не журналы событий в формате JSON, как dbt v1. Для локального просмотра используйте `--log-format otel` или параметры, описанные в разделе [Телеметрия и наблюдаемость dbt v2](https://docs.getdbt.tech/reference/telemetry-observability.md#available-output-formats).

В dbt platform можно [скачать журналы OTel](https://docs.getdbt.tech/docs/deploy/run-visibility.md#access-logs) для запусков заданий dbt v2.

Сведения о `--log-format`, `--log-level` и связанных параметрах CLI см. в разделе [Журналы](https://docs.getdbt.tech/reference/global-configs/logs.md).

## Интерфейс Python

(Версии dbt: v2.0 и новее)

dbt v2 не поддерживает интерфейс событий Python, доступный в dbt v1.

Сейчас мы [разрабатываем](https://github.com/dbt-labs/dbt/issues/13102) API на Python с привязками к Rust для программного запуска.
