Skip to content

Leverage Airflow ::group:: to group logs associated to DAG parsing#2235

Merged
tatiana merged 2 commits into
mainfrom
group-log-parsing-logs
Dec 29, 2025
Merged

Leverage Airflow ::group:: to group logs associated to DAG parsing#2235
tatiana merged 2 commits into
mainfrom
group-log-parsing-logs

Conversation

@tatiana
Copy link
Copy Markdown
Collaborator

@tatiana tatiana commented Dec 29, 2025

In more recent versions of Airflow, the task logs display logs related to DAG parsing. This behaviour can be confusing, particularly to users who may not realise DAG parsing happens every time Airflow runs a task.

A way to clean up the logs is to leverage the log groups feature in Airflow 2.9+.

The two screenshots illustrate the usage of this feature:

  1. Visualising the group expanded
Screenshot 2025-12-29 at 14 58 36
  1. Visualising the group compressed:
Screenshot 2025-12-29 at 14 58 19

Copilot AI review requested due to automatic review settings December 29, 2025 15:07
@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 29, 2025

Deploy Preview for astronomer-cosmos canceled.

Name Link
🔨 Latest commit 9cb27d4
🔍 Latest deploy log https://app.netlify.com/projects/astronomer-cosmos/deploys/695299284f4da700084551c7

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR introduces log grouping for DAG parsing activities in Cosmos using Airflow 2.9+'s ::group:: feature. The log grouping helps reduce clutter in task logs by collapsing DAG parsing-related log messages, which can be confusing to users unfamiliar with Airflow's parsing behavior during task execution.

Key changes:

  • Added log group markers at the start and end of the DbtToAirflowConverter.__init__ method to wrap all DAG parsing logs
  • Added a test to verify correct ordering of group start and end markers

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
cosmos/converter.py Added ::group:: and ::endgroup:: log markers to wrap DAG parsing operations
tests/test_converter.py Added test case to verify log group markers are emitted in correct order

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread cosmos/converter.py
Comment thread tests/test_converter.py
@tatiana tatiana changed the title Leverage Airflow ::group:: feature to group logs associated to DAG parsing Leverage Airflow ::group:: to group logs associated to DAG parsing Dec 29, 2025
@tatiana tatiana requested a review from pankajkoti December 29, 2025 15:33
@tatiana tatiana merged commit d794145 into main Dec 29, 2025
90 checks passed
@tatiana tatiana deleted the group-log-parsing-logs branch December 29, 2025 16:25
@codecov
Copy link
Copy Markdown

codecov Bot commented Dec 29, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.98%. Comparing base (d7fa4cb) to head (9cb27d4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2235   +/-   ##
=======================================
  Coverage   97.98%   97.98%           
=======================================
  Files          95       95           
  Lines        6190     6192    +2     
=======================================
+ Hits         6065     6067    +2     
  Misses        125      125           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@pankajastro pankajastro mentioned this pull request Jan 7, 2026
2 tasks
@tatiana tatiana added this to the Cosmos 1.13.0 milestone Jan 29, 2026
@pankajastro pankajastro mentioned this pull request Jan 29, 2026
tatiana added a commit that referenced this pull request Jan 30, 2026
Features

* Support cross-referencing models across dbt projects using dbt-loom by
@pankajkoti in #2271
* Support use of YAML selectors when using ``LoadMode.DBT_MANIFEST`` by
@YourRoyalLinus in #2261
* Introduce ``ExecutionMode.WATCHER_KUBERNETES`` to use the watcher with
``KubernetesPodOperator`` by @tatiana in #2207
* Add support for StarRocks profile mapping by @kurkim0661 in #2256
* Allow pushing URIs as XComs for Cosmos tasks by @corsettigyg in #2275
* Support defining custom callbacks alongside the ``WATCHER_KUBERNETES``
callback by @johnhoran in #2307

Enhancements

* Refactor: remove duplicate ``_construct_dest_file_path`` by @jx2lee in
#2077
* Leverage Airflow ``::group::`` to group logs associated with DAG
parsing by @tatiana in #2235
* Refactor ``DbtConsumerWatcherSensor`` for reusability by @tatiana in
#2245
* Restore plain text output when using ``ExecutionMode.WATCHER`` by
@tiovader in #2241

Bug Fixes

* Fix running empty models or ephemeral nodes in
``ExecutionMode.WATCHER`` by @tatiana in #2279
* Improve watcher producer task priority in scheduling and the UI by
@tatiana in #2237
* Fix typos and formatting issues in documentation by @pankajkoti in
#2259
* Allow watcher producer retries without erroring by @tatiana in #2283
* Fix ``TestBehavior.AFTER_ALL`` is missing project_name information
when loading project using manifest file by @tuantran0910 in #2242
* Fix duplicate log lines in watcher subprocess execution and format
timestamps by @pankajkoti in #2301

Docs

* Add Watcher Kubernetes documentation by @tatiana in #2303
* Document newly added telemetry metrics in the privacy notice by
@pankajkoti in #2249
* Add compatibility policy document by @pankajastro in #2251
* Improve watcher documentation related to dbt threads by @tatiana in
#2273
* Fix link in watcher execution mode documentation by @jedcunningham in
#2277
* Update Apache Airflow minimum compatibility policy by @tatiana in
#2285
* Clarify Cosmos runtime support until "End of Basic Support" by
@jedcunningham in #2286
* Update watcher docs by @tatiana in #2298
* Update watcher kubernetes documentation by @tatiana in #2306

Others

* Add Airflow 3 DAG versioning tests for Cosmos by @michal-mrazek in
#2177
* Add dbt Core 1.11 to the test matrix by @tatiana in #2230
* Add integration tests using InvocationMode.SUBPROCESS and validate
output by @tatiana in #2287
* Fix main branch failing tests by @tatiana in #2296
* Update pre-commit hooks to the latest versions by @jedcunningham in
#2289
* Pre-commit autoupdates by @pre-commit in #2222, #2264, #2274 and #2290
* Dependabot updates by @dependabot in #2218, #2219, #2220, #2280 and
#2284
* Add Scarf metrics to understand Cosmos feature usage patterns
- Add telemetry tracking for dbt docs plugin usage by @pankajkoti in
#2240
- Add DAG run telemetry metrics for load mode, invocation, and
render_config parameters by @pankajkoti in #2223
  - Collect profile metrics for DAG runs by @pankajastro in #2228
- Compress telemetry metadata to reduce serialized DAG size by
@pankajkoti in #2252
- Skip storing telemetry metadata when emission is disabled by
@pankajkoti in #2278
- Hide telemetry metadata parameters from the Airflow trigger UI by
@pankajkoti in #2247

closes:
astronomer/oss-integrations-private#317

---------

Co-authored-by: Tatiana Al-Chueyr <tatiana.alchueyr@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants