Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,36 @@ logging to cloud storage such as AWS, Google Cloud, and Azure.
The logging settings and options can be specified in the Airflow Configuration file,
which as usual needs to be available to all the Airflow process: Web server, Scheduler, and Workers.

Default Airflow loggers
-----------------------

Airflow uses Python's standard logging framework, and most loggers follow the
Python package and module naming convention. A few logger names are useful to
know when reading logs or customizing logging behavior:

* ``root``: the root Python logger. During task execution, Airflow configures
the root logger so standard Python loggers that propagate to it can write to
the task log.
* ``airflow.task``: the parent logger for task logs. Operators and hooks use
child loggers under this namespace, such as ``airflow.task.operators`` and
``airflow.task.hooks``.
* ``airflow.processor``: used by Dag file processing code, including messages
emitted while parsing Dag files.
* ``airflow.processor_manager``: used by the scheduler's Dag processor manager
to report Dag processing activity.
* ``flask_appbuilder``: used by Flask-AppBuilder in the webserver. Airflow's
default logging configuration keeps this logger less verbose than Airflow's
own component loggers.

Task logs are configured separately from other component logs because they must
be grouped by task instance and made available in the Airflow UI. For task log
file layout and remote task logging settings, see
:doc:`/administration-and-deployment/logging-monitoring/logging-tasks`.

For custom handlers, custom logger levels, or per-operator and per-task logger
configuration, see
:doc:`/administration-and-deployment/logging-monitoring/advanced-logging-configuration`.

You can customize the logging settings for each of the Airflow components by specifying the logging settings
in the Airflow Configuration file, or for advanced configuration by using
:doc:`advanced features </administration-and-deployment/logging-monitoring/advanced-logging-configuration>`.
Expand Down
Loading