Pada 15 September 2026, semua lingkungan Cloud Composer 1 dan Cloud Composer 2 versi 2.0.x akan mencapai akhir masa pakainya yang direncanakan, dan Anda tidak akan dapat menggunakannya. Sebaiknya rencanakan migrasi ke Cloud Composer 3.
Halaman ini memberikan langkah-langkah dan informasi pemecahan masalah untuk masalah server web Airflow umum.
Server web Airflow adalah komponen Airflow yang menyediakan antarmuka pengguna
untuk mengelola DAG dan tugas Airflow. Halaman ini menjelaskan langkah-langkah pemecahan masalah
untuk berbagai masalah terkait akses ke server web Airflow di lingkungan Anda atau
untuk peringatan terkait server web yang terlihat di log Airflow.
Tidak dapat mengakses UI Airflow saat kontrol akses jaringan diaktifkan
Gejala: Setelah kontrol akses server web dikonfigurasi, UI Airflow tidak dapat diakses. Biasanya, kode error yang ditampilkan dalam situasi ini adalah 403.
Informasi tentang masalah ini: Cloud Composer mendukung
kontrol akses jaringan server web,
yang memungkinkan Anda menentukan rentang IP yang diizinkan untuk terhubung ke server web.
Masalah saat mengakses UI Airflow biasanya menghasilkan error 403. Untuk memeriksa apakah error terkait dengan kontrol akses jaringan server web, lakukan hal berikut:
Dalam daftar lingkungan, klik nama lingkungan Anda.
Halaman Environment details akan terbuka.
Buka tab Konfigurasi lingkungan.
Periksa apakah item Kontrol akses server web disetel ke
Semua alamat IP memiliki akses (default).
Jika nilai yang berbeda dengan Semua alamat IP memiliki akses (default) dikonfigurasi, maka kontrol akses jaringan diaktifkan dan visibilitas UI Airflow dibatasi ke rentang alamat IPv4 dan IPv6 yang diberikan. Dalam hal ini, masalahnya mungkin terkait dengan kontrol akses jaringan server web.
Dalam kebanyakan kasus, penyebab masalahnya adalah ketidakcocokan antara IP yang dimaksud
yang Anda tentukan dan IP yang sebenarnya di-resolve untuk terhubung ke
UI Airflow. Untuk memecahkan masalah, lakukan langkah-langkah berikut:
Dalam daftar lingkungan, klik nama lingkungan Anda.
Halaman Environment details akan terbuka.
Buka tab Konfigurasi lingkungan.
Temukan item Kontrol akses server web, lalu klik Edit.
Dalam dialog Web server network access control, pilih
Allow access from all IP addresses.
Akses UI Airflow beberapa kali dan pastikan UI berfungsi tanpa masalah:
Jika Anda tidak mengalami masalah, lanjutkan ke langkah berikutnya.
Jika Anda mengalami masalah pada tahap ini, artinya masalah tersebut mungkin terkait dengan konfigurasi izin IAM Anda. Untuk
mengetahui informasi selengkapnya tentang izin IAM untuk
Cloud Composer, lihat Kontrol akses.
Dalam dialog Web server network access control, pilih
Allow access only from specific IP addresses.
Tambahkan rentang IP 0.0.0.0/0, lalu akses UI Airflow beberapa kali dan
verifikasi bahwa UI berfungsi tanpa masalah:
Jika Anda tidak mengalami masalah, berarti IP yang Anda gunakan untuk terhubung adalah alamat IPv4.
Jika Anda mengalami masalah pada tahap ini, berarti IP yang Anda gunakan untuk terhubung adalah alamat IPv6.
Hapus rentang IP 0.0.0.0/0, lalu tambahkan rentang IP ::/0.
Jika Anda tidak mengalami masalah, berarti IP yang Anda gunakan untuk terhubung adalah alamat IPv6.
Jika Anda mengalami masalah pada tahap ini, berarti IP yang Anda gunakan untuk terhubung adalah alamat IPv4.
Sekarang Anda telah menentukan apakah alamat yang di-resolve adalah IPv4 atau IPv6.
Bergantung pada jenis alamat, persempit rentang ::/0 atau 0.0.0.0/0 ke rentang yang lebih spesifik, untuk memverifikasi rentang terluas saat akses berhenti berfungsi:
Anda dapat memulai dengan subnet mask yang luas (seperti 192.0.2.0/8) yang mencakup alamat yang Anda anggap sebagai alamat IP Anda.
Untuk menentukan alamat IP Anda, Anda dapat menggunakan layanan pihak ketiga yang memberikan alamat IP eksternal Anda saat Anda membuka halamannya. Anda dapat menelusuri layanan tersebut dengan kueri penelusuran "apa alamat IP saya").
Nilai konfigurasi tidak ditampilkan di halaman konfigurasi
Beberapa parameter konfigurasi Airflow disembunyikan di halaman konfigurasi untuk mencegah akses ke informasi yang berpotensi sensitif. Misalnya, kredensial untuk mengakses database Airflow tidak ditampilkan.
Untuk menampilkan kolom tersembunyi, ganti opsi konfigurasi Airflow berikut. Sebaiknya kembalikan perubahan setelah Anda mendapatkan nilai yang diperlukan.
Bagian
Kunci
Nilai
Catatan
webserver
expose_config
True
Nilai defaultnya adalah non-sensitive-only. Tetapkan ke False untuk menyembunyikan semua parameter konfigurasi.
DAG menyebabkan server web Airflow mengalami error atau menampilkan error '502 gateway timeout'
Kegagalan server web dapat terjadi karena beberapa alasan yang berbeda. Periksa
log airflow-webserver di
Cloud Logging untuk menentukan penyebab error
502 gateway timeout.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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,["# Troubleshooting Airflow web server issues\n\n\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\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---------------------------------------------------------------\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\nDAG crashes the Airflow web server or causes it to return a '502 gateway timeout' error\n---------------------------------------------------------------------------------------\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\n- [Access Airflow UI](/composer/docs/composer-2/access-airflow-web-interface)\n- [Access control](/composer/docs/composer-2/access-control)"]]
