설정 참조
설정 참조 (Configuration Reference)
이 페이지는 Airflow의 모든 설정 옵션을 종합적으로 정리한 참조 문서예요. 각 옵션은 airflow.cfg의 섹션([api], [core], [scheduler] 등) 아래에 있으며, 대응하는 환경 변수(AIRFLOW__{SECTION}__{KEY}), 기본값, 유효 값과 설명이 함께 제공돼요. 자동 생성된 페이지라 보통 수백 개의 옵션이 있으므로 이 문서의 섹션 안내를 따라 원하는 옵션을 찾으면 돼요.
출처: 문서
본문
Provider별 설정 옵션 (Provider-specific configuration options)
각 provider는 자체 설정 옵션 섹션을 제공할 수 있어요. Airflow core 설정과 달리 provider 설정은 설치된 provider에 따라 달라지며, 각 provider 문서에서 찾을 수 있어요.
Airflow 설정 옵션 (Airflow configuration options)
Airflow core 설정 옵션은 아래 섹션별로 정리되어 있어요. 각 옵션은 airflow.cfg의 해당 섹션 아래에 두고, 환경 변수로는 AIRFLOW__{SECTION}__{KEY} 형식으로 설정할 수 있어요. 아래 각 섹션에 속한 옵션 이름(영문 그대로)을 나열했어요. 각 옵션의 기본값·유효 값·상세 설명은 원본 문서에서 확인할 수 있어요.
[api] — API 서버 설정
API 서버의 동작을 제어해요. 옵션: access_control_allow_headers, access_control_allow_methods, access_control_allow_origins, auto_refresh_interval, base_url, client_ssl_cert, client_ssl_key, client_use_public_certs, dag_cache_size, dag_cache_ttl, default_wrap, enable_swagger_ui, expose_config, expose_stacktrace, fallback_page_limit, grid_view_sorting_order, hide_paused_dags_by_default, host, instance_name, log_config, log_fetch_timeout_sec, log_stream_buffer_size, maximum_page_limit, port, require_confirmation_dag_change, secret_key, server_type, ssl_ca_file, ssl_cert, ssl_cert_reqs, ssl_key, theme, worker_refresh_batch_size, worker_refresh_interval, worker_timeout, workers. Deprecated: access_logfile, page_size.
[api_auth] — API 인증(JWT) 설정
API JWT 토큰 생성·검증 관련 설정. 옵션: jwt_algorithm, jwt_audience, jwt_cli_expiration_time, jwt_expiration_time, jwt_issuer, jwt_kid, jwt_leeway, jwt_private_key_path, jwt_secret, trusted_jwks_url.
[callbacks] — 콜백 설정
콜백 실행 관련 설정. 옵션: callback_execution_timeout.
[connection_test] — 연결 테스트 설정
연결 테스트 관련 설정. 옵션: max_concurrency, reaper_interval, timeout.
[core] — 핵심 설정
Airflow의 핵심 동작을 제어하는 가장 큰 섹션이에요. DAG 폴더, executor, 타임존, 직렬화, 인증, 보안 등. 옵션: allow_double_dot_in_ids, allowed_deserialization_classes, allowed_deserialization_classes_regexp, asset_manager_class, asset_manager_kwargs, auth_manager, compress_serialized_dags, daemon_umask, dag_discovery_safe_mode, dag_ignore_file_syntax, dag_run_conf_overrides_params, dagbag_import_error_traceback_depth, dagbag_import_error_tracebacks, dagbag_import_timeout, dags_are_paused_at_creation, dags_folder, default_impersonation, default_pool_task_slot_count, default_task_execution_timeout, default_task_retries, default_task_retry_delay, default_task_weight_rule, default_timezone, execute_tasks_new_python_interpreter, execution_api_server_url, executor, fernet_key, hide_sensitive_var_conn_fields, hostname_callable, killed_task_cleanup_time, lazy_discover_providers, lazy_load_plugins, load_examples, max_active_runs_per_dag, max_active_tasks_per_dag, max_consecutive_failed_dag_runs_per_dag, max_map_length, max_task_retry_delay, max_templated_field_length, might_contain_dag_callable, min_serialized_dag_update_interval, mp_forkserver_preload, mp_start_method, multi_team, num_dag_runs_to_retain_rendered_fields, parallelism, plugins_folder, rerun_with_latest_version, security, sensitive_var_conn_names, simple_auth_manager_all_admins, simple_auth_manager_passwords_file, simple_auth_manager_users, task_success_overtime, team_name_cache_ttl, test_connection, unit_test_mode, xcom_backend. Deprecated: dag_file_processor_timeout, max_num_rendered_ti_fields_per_task, sql_alchemy_conn.
[dag_processor] — Dag processor 설정
DAG 파일 처리 관련 설정. 옵션: bundle_refresh_check_interval, dag_bundle_config_list, dag_bundle_storage_path, dag_file_processor_timeout, dag_version_inflation_check_level, disable_bundle_versioning, file_parsing_sort_mode, health_check_threshold, max_callbacks_per_loop, min_file_process_interval, parsing_pre_import_modules, parsing_processes, print_stats_interval, refresh_interval, stale_bundle_cleanup_age_threshold, stale_bundle_cleanup_interval, stale_bundle_cleanup_min_versions, stale_dag_threshold.
[database] — 데이터베이스 설정
메타데이터 데이터베이스 연결·SQLAlchemy 설정. 옵션: alembic_ini_file_path, check_migrations, external_db_managers, max_db_retries, migration_batch_size, sql_alchemy_conn, sql_alchemy_conn_async, sql_alchemy_connect_args, sql_alchemy_connect_args_async, sql_alchemy_engine_args, sql_alchemy_max_overflow, sql_alchemy_pool_enabled, sql_alchemy_pool_pre_ping, sql_alchemy_pool_recycle, sql_alchemy_pool_size, sql_alchemy_schema, sql_alchemy_session_maker, sql_engine_collation_for_ids, sql_engine_encoding.
[email] — 이메일 설정
이메일 알림 전송 설정. 옵션: default_email_on_failure, default_email_on_retry, email_backend, email_conn_id, from_email, html_content_template, ssl_context, subject_template.
[execution_api] — Execution API 설정
관련 옵션: jwt_audience, jwt_expiration_time, otel_trace_propagation.
[kerberos] — Kerberos 설정
Kerberos 인증 관련 설정. 옵션: ccache, forwardable, include_ip, keytab, kinit_path, principal, reinit_frequency.
[lineage] — Lineage 설정
데이터 계보 관련 설정. 옵션: max_assets_per_collector, max_extras_per_collector.
[logging] — 로깅 설정
로깅 동작·형식·원격 로깅 설정. 옵션: base_log_folder, callsite_parameters, celery_logging_level, celery_stdout_stderr_separation, color_log_error_keywords, color_log_warning_keywords, colored_console_log, dag_processor_child_process_log_directory, dag_processor_log_format, dag_processor_log_target, delete_local_logs, encrypt_s3_logs, extra_logger_names, fab_logging_level, file_task_handler_new_file_permissions, file_task_handler_new_folder_permissions, google_key_path, interleave_timestamp_parser, json_logs, log_filename_template, log_format, log_formatter_class, log_timestamp_format, logging_config_class, logging_level, min_length_masked_secret, namespace_levels, remote_base_log_folder, remote_log_conn_id, remote_logging, remote_task_handler_kwargs, secret_mask_adapter, simple_log_format, task_log_prefix_template, task_log_reader, trigger_log_server_port, uvicorn_logging_level, worker_log_server_port.
[metrics] — 메트릭 설정
StatsD·OpenTelemetry 메트릭 내보내기 설정. 옵션: legacy_names_on, metrics_allow_list, metrics_block_list, otel_debugging_on, otel_host, otel_interval_milliseconds, otel_on, otel_port, otel_prefix, otel_service, otel_ssl_active, stat_name_handler, statsd_custom_client_path, statsd_datadog_enabled, statsd_datadog_metrics_tags, statsd_datadog_tags, statsd_disabled_tags, statsd_host, statsd_influxdb_enabled, statsd_ipv6, statsd_on, statsd_port, statsd_prefix.
[operators] — Operator 기본값 설정
Operator의 기본 리소스/동작 값. 옵션: default_cpus, default_deferrable, default_disk, default_gpus, default_owner, default_queue, default_ram.
[profiling] — 프로파일링 설정
옵션: memray_detailed_tracing, memray_trace_components.
[scheduler] — 스케줄러 설정
스케줄러 성능·동작 관련 설정. 옵션: allowed_run_id_pattern, catchup_by_default, create_cron_data_intervals, create_delta_data_intervals, dagrun_metrics_interval, enable_health_check, enable_tracemalloc, ignore_first_depends_on_past_by_default, job_heartbeat_sec, max_dagruns_per_loop_to_schedule, max_dagruns_to_create_per_loop, max_tis_per_query, num_runs, only_idle, orphaned_tasks_check_interval, parsing_cleanup_interval, partition_mapper_max_downstream_keys, pool_metrics_interval, scheduler_health_check_server_host, scheduler_health_check_server_port, scheduler_health_check_threshold, scheduler_heartbeat_sec, scheduler_idle_sleep_time, task_instance_heartbeat_sec, task_instance_heartbeat_timeout, task_instance_heartbeat_timeout_detection_interval, task_queued_timeout, task_queued_timeout_check_interval, ti_metrics_interval, trigger_timeout_check_interval, use_job_schedule, use_row_level_locking, dag_dir_list_interval, parsing_pre_import_modules, running_metrics_interval.
[sdk] — Task SDK 설정
비-Python Task SDK의 coordinator 설정. 옵션: coordinators, queue_to_coordinator.
[secrets] — Secrets 설정
secrets backend 관련 설정. 옵션: backend, backend_kwargs, cache_ttl_seconds, use_cache.
[sensors] — Sensor 설정
옵션: default_timeout.
[sentry] — Sentry 설정
Sentry 에러 추적 통합 설정. 옵션: before_send, sentry_dsn, sentry_on.
[smtp] — SMTP 설정
이메일 발송용 SMTP 설정. 옵션: smtp_host, smtp_mail_from, smtp_port, smtp_retry_limit, smtp_ssl, smtp_starttls, smtp_timeout.
[state_store] — 상태 저장소 설정
Task·Asset 상태 저장소 설정. 옵션: backend, clear_on_success, default_retention_days, max_value_storage_bytes, state_cleanup_batch_size.
[traces] — 트레이스 설정
OpenTelemetry 트레이스 관련 설정. 옵션: otel_debug_traces_on, otel_debugging_on, otel_host, otel_on, otel_port, otel_service, otel_ssl_active, task_runner_flush_timeout_milliseconds.
[triggerer] — Triggerer 설정
트리거 실행 관련 설정. 옵션: blocked_main_thread_warning_threshold, capacity, job_heartbeat_sec, max_trigger_to_select_per_loop, on_kill_timeout, queues_enabled, runner_health_check_threshold, shared_stream_ack_timeout, shared_stream_cohort_grace_period, shared_stream_subscriber_queue_size, triggerer_health_check_threshold, default_capacity.
[workers] — Worker 설정
worker 실행 관련 설정. 옵션: execution_api_retries, execution_api_retry_wait_max, execution_api_retry_wait_min, execution_api_timeout, max_failed_heartbeats, min_heartbeat_interval, missing_dag_retries, missing_dag_retry_delay, secrets_backend, secrets_backend_kwargs, socket_cleanup_timeout, state_store_backend, execution_api_server_url, missing_dag_retires.
위 각 옵션에 대해 원본 문서에는 상세 설명, 기본값, 예시가 함께 제공돼요. 자동 생성된 페이지이므로 원본 문서 페이지에서 특정 옵션을 검색해 확인하는 것이 정확해요.