이 페이지에서는 일반적인 Airflow 웹 서버 문제의 문제 해결 단계 및 정보를 제공합니다.
Airflow 웹 서버는 Airflow DAG 및 태스크를 관리하기 위한 사용자 인터페이스를 제공하는 Airflow 구성요소입니다. 이 페이지에서는 환경의 Airflow 웹 서버 액세스와 관련된 다양한 문제 또는 Airflow 로그에 표시되는 웹 서버 관련 경고에 대한 문제 해결 단계를 설명합니다.
네트워크 액세스 제어가 사용 설정된 경우 Airflow UI에 액세스할 수 없음
증상: 웹 서버 액세스 제어가 구성된 후 Airflow UI에 액세스할 수 없습니다. 일반적으로 이 경우 표시되는 오류 코드는 403입니다.
문제에 관한 정보: Cloud Composer는 웹 서버 네트워크 액세스 제어를 지원하므로 웹 서버에 연결할 수 있는 IP 범위를 지정할 수 있습니다.
Airflow UI에 액세스하는 데 문제가 발생하면 일반적으로 오류 403이 반환됩니다. 이 오류가 웹 서버 네트워크 액세스 제어와 관련이 있는지 확인하려면 다음 안내를 따르세요.
환경 목록에서 환경 이름을 클릭합니다.
환경 세부정보 페이지가 열립니다.
환경 구성 탭으로 이동합니다.
웹 서버 액세스 제어 항목이 모든 IP 주소에 액세스 권한이 있음(기본값)으로 설정되어 있는지 확인합니다.
모든 IP 주소에 액세스 권한이 있음(기본값) 이외의 값이 구성된 경우 네트워크 액세스 제어가 사용 설정되고 Airflow UI 공개 상태가 제공된 IPv4 및 IPv6 주소 범위로 제한됩니다. 이 경우 웹 서버 네트워크 액세스 제어와 관련된 문제일 수 있습니다.
대부분의 경우 문제의 원인은 사용자가 지정한 의도된 IP와 실제로 Airflow UI에 연결하도록 결정된 IP가 불일치하기 때문입니다. 이 문제를 해결하려면 다음 안내를 따르세요.
환경 목록에서 환경 이름을 클릭합니다.
환경 세부정보 페이지가 열립니다.
환경 구성 탭으로 이동합니다.
웹 서버 액세스 제어 항목을 찾아 수정을 클릭합니다.
웹 서버 네트워크 액세스 제어 대화상자에서 모든 IP 주소의 액세스 허용을 선택합니다.
Airflow UI에 여러 번 액세스하고 문제 없이 작동하는지 확인합니다.
문제가 발생하지 않으면 다음 단계로 진행합니다.
이 시점에서 문제가 발생하면 IAM 권한 구성과 관련된 문제일 수 있습니다. Cloud Composer의 IAM 권한에 대한 자세한 내용은 액세스 제어를 참조하세요.
웹 서버 네트워크 액세스 제어 대화상자에서 특정 IP 주소의 액세스만 허용을 선택합니다.
0.0.0.0/0 IP 범위를 추가한 후 Airflow UI에 여러 번 액세스하고 문제 없이 작동하는지 확인합니다.
문제가 발생하지 않으면 연결하려는 IP가 IPv4 주소입니다.
이 시점에서 문제가 발생하면 연결하려는 IP가 IPv6 주소임을 의미합니다.
0.0.0.0/0 IP 범위를 삭제하고 ::/0 IP 범위를 추가합니다.
문제가 발생하지 않으면 연결하려는 IP가 IPv6 주소입니다.
이 시점에서 문제가 발생하면 연결하려는 IP가 IPv4 주소임을 의미합니다.
이제 결정된 주소가 IPv4 또는 IPv6 중 무엇인지 확인했습니다.
주소 유형에 따라 ::/0 또는 0.0.0.0/0 범위를 더욱 구체적인 범위로 좁혀 액세스가 작동하지 않을 때 가장 넓은 범위를 확인합니다.
IP 주소로 가정하는 주소가 포함된 넓은 서브넷 마스크(예: 192.0.2.0/8)로 시작할 수 있습니다.
IP 주소를 결정하려면 해당 페이지를 방문할 때 외부 IP 주소를 제공하는 서드 파티 서비스를 사용하면 됩니다. '내 IP 주소는 무엇인가요?' 검색어로 이러한 서비스를 검색할 수 있습니다.
구성 페이지에 구성 값이 표시되지 않음
잠재적으로 민감한 정보에 대한 액세스를 방지하기 위해 Airflow의 일부 Airflow 구성 매개변수가 구성 페이지에 숨겨져 있습니다. 예를 들어 Airflow 데이터베이스에 액세스하는 사용자 인증 정보는 표시되지 않습니다.
숨겨진 필드를 표시하려면 다음 Airflow 구성 옵션을 재정의하세요. 필요한 값을 얻은 후 변경사항을 되돌리는 것이 좋습니다.
섹션
키
값
참고
webserver
expose_config
True
기본값은 non-sensitive-only입니다. 모든 구성 매개변수를 숨기려면 False로 설정합니다.
DAG가 Airflow 웹 서버를 다운시키거나 '502 gateway timeout' 오류를 유발하는 경우
웹 서버 오류는 여러 가지 이유로 발생할 수 있습니다. Cloud Logging에서 airflow-webserver 로그를 참조하여 502 gateway timeout 오류 원인을 확인하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-03(UTC)"],[[["\u003cp\u003eThis document provides troubleshooting steps for common issues related to the Airflow web server, a key component for managing Airflow DAGs and tasks within Cloud Composer environments.\u003c/p\u003e\n"],["\u003cp\u003eA common problem is the inability to access the Airflow UI, often indicated by a 403 error, which typically stems from misconfigurations in web server network access controls.\u003c/p\u003e\n"],["\u003cp\u003eCloud Composer supports the ability to limit Airflow UI access to specific IP ranges, and problems may arise due to mismatches between the intended IP and the actual resolved IP address.\u003c/p\u003e\n"],["\u003cp\u003eTo diagnose IP related issues, users can temporarily allow access from all IP addresses, and then add either \u003ccode\u003e0.0.0.0/0\u003c/code\u003e or \u003ccode\u003e::/0\u003c/code\u003e IP ranges to determine if the connecting IP is IPv4 or IPv6.\u003c/p\u003e\n"],["\u003cp\u003eUsers can utilize a third-party service to determine the connecting IP address to allow them to narrow down the subnet masks for access, allowing for a more secure and controlled access.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n[Cloud Composer 3](/composer/docs/composer-3/troubleshooting-web-server \"View this page for Cloud Composer 3\") \\| **Cloud Composer 2** \\| [Cloud Composer 1](/composer/docs/composer-1/troubleshooting-web-server \"View this page for Cloud Composer 1\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis page provides troubleshooting steps and information for common Airflow\nweb server issues.\n\nThe Airflow web server is an Airflow component that provides a user interface\nfor managing Airflow DAGs and tasks. This page describes troubleshooting steps\nfor various issues with accessing the Airflow web server of your environment or\nfor web server-related warnings visible in Airflow logs.\n\nCan't access Airflow UI when network access controls are enabled\n\n**Symptom**: After web server access controls are configured, it's not possible\nto access Airflow UI. Usually, the error code displayed in this situation is\n403.\n\n**Information about the issue** : Cloud Composer supports\n[web server network access controls](/composer/docs/composer-2/access-airflow-web-interface#network-access-controls),\nwhich lets you specify IP ranges that are allowed to connect to the web server.\n\nProblems with accessing Airflow UI usually result in error 403. To check if the\nerror is related to web server network access controls, do the following:\n\n1. In the list of environments, click the name of your environment. The **Environment details** page opens.\n2. Go to the **Environment configuration** tab.\n3. Check if the **Web server access control** item is set to **All IP addresses have access (default)**.\n4. If a value different than **All IP addresses have access (default)** is configured, then network access control is enabled and the visibility of the Airflow UI is limited to the provided IPv4 and IPv6 address ranges. In this case, the problem might be related to web server network access controls.\n\nIn most cases, the cause of the issue is the mismatch between the intended IP\nthat you specified and the IP that is actually resolved to connect to the\nAirflow UI. To troubleshoot the problem, do the following:\n\n1. In the list of environments, click the name of your environment.\n The **Environment details** page opens.\n\n2. Go to the **Environment configuration** tab.\n\n3. Find the **Web server access control** item and click **Edit**.\n\n4. In the **Web server network access control** dialog, select\n **Allow access from all IP addresses**.\n\n5. Access the Airflow UI multiple times and verify that it works without any\n issues:\n\n - If you don't experience problems, continue to the next step.\n\n - If you experience a problem at this point, it means that the issue might\n be related to your IAM permissions configuration. For\n more information about the IAM permissions for\n Cloud Composer, see [Access control](/composer/docs/composer-2/access-control).\n\n6. In the **Web server network access control** dialog, select\n **Allow access only from specific IP addresses**.\n\n7. Add the `0.0.0.0/0` IP range, then access the Airflow UI multiple times and\n verify that it works without issues:\n\n - If you don't experience problems, then the IP that you're connecting\n with is an IPv4 address.\n\n - If you experience a problem at this point, it means the IP you're\n connecting with is an IPv6 address.\n\n8. Delete the `0.0.0.0/0` IP range, and add the `::/0` IP range.\n\n - If you don't experience problems, then the IP that you're connecting\n with is an IPv6 address.\n\n - If you experience a problem at this point, it means the IP you're\n connecting with is an IPv4 address.\n\n9. Now you determined if your resolved address is IPv4 or IPv6.\n\n10. Depending on the address type, narrow down the `::/0` or `0.0.0.0/0` ranges\n to more specific ones, to verify the broadest range when the access stops\n working:\n\n - You can start with the wide subnet mask (such as `192.0.2.0/8`) that\n includes the address that you assume to be your IP address.\n\n - To determine your IP address, you can use a third-party service that\n provides your external IP address when you visit its page. You can\n search for such services by the \"what is my IP address\" search query).\n\nConfiguration values aren't displayed on the configuration page\n\nSome Airflow configuration parameters of Airflow are hidden on the\nconfiguration page to prevent access to potentially sensitive information. For\nexample, credentials to access the Airflow database are not displayed.\n| **Warning:** If you configure Airflow to display these parameters, then\n| **any Airflow user with `Admin` and `Op` permission will be able to access this\n| information.**\n| By default, Airflow assigns the `Op` role to new Airflow users.\n|\n| To prevent Airflow users with the `Op` role from accessing the configuration page:\n|\n| 1. Go to the **Security** \\\u003e **List Roles** configuration page in the Airflow UI.\n| 2. Revoke the **can read Configurations** and **menu access on Configurations** permissions from the `Op` role.\n\nTo display hidden fields, [override](/composer/docs/composer-2/override-airflow-configurations) the following Airflow\nconfiguration option. We recommend to revert the changes after you obtain the\nrequired values.\n\n| Section | Key | Value | Notes |\n|-------------|-----------------|--------|-------------------------------------------------------------------------------------------------|\n| `webserver` | `expose_config` | `True` | The default value is `non-sensitive-only`. Set to `False` to hide all configuration parameters. |\n\nDAG crashes the Airflow web server or causes it to return a '502 gateway timeout' error\n\nWeb server failures can occur for several different reasons. Check\nthe **airflow-webserver** logs in\n[Cloud Logging](/composer/docs/composer-2/view-logs#streaming) to determine the cause of the\n`502 gateway timeout` error.\n\nWhat's next\n\n- [Access Airflow UI](/composer/docs/composer-2/access-airflow-web-interface)\n- [Access control](/composer/docs/composer-2/access-control)"]]
