apache / airflow

Apache Airflow - A platform to programmatically author, schedule, and monitor workflows
https://airflow.apache.org/
Apache License 2.0
36.9k stars 14.25k forks source link

Missing docs for logging #10593

Open mik-laj opened 4 years ago

mik-laj commented 4 years ago

Hello,

The configuration of the Airflow logger is not easy, as in most applications. We have many loggers, some loggers generate multiple streams. This is very confusing for end-users, and the lack of documentation doesn't make it any easier.

We have following loggers

airflow.task creates a new log file for each pair of task instances and try numbers. These entries are accessible via the Web UI. airflow.processor creates a new log file for each DAG File. flask_appbuilder is only used to filter logs records because the FAB is too verbose, so in most cases, we don't have to configure it specially.

Webserver writes logs to root logger. Worker writes logs to airflow.processor and root logger Scheduler writes logs to airflow.processor, airflow.processor_manager and root logger

I would be happy if we had a description of the default configuration and the methods on how to influence these configurations were described. Currently, the documentation only describes configurations for airflow.task.

Best regards, Kamil Breguła

kaxil commented 2 years ago

cc @blag