Am 15. September 2026erreichen alle Cloud Composer 1- und Cloud Composer 2-Umgebungen der Version 2.0.x das geplante Ende des Lebenszyklus und können nicht mehr verwendet werden. Wir empfehlen, die Migration zu Cloud Composer 3 zu planen.
Diese Seite enthält Schritte zur Fehlerbehebung und Informationen zu häufigen Problemen mit dem Airflow-Webserver.
Der Airflow-Webserver ist eine Airflow-Komponente, die eine Benutzeroberfläche zum Verwalten von Airflow-DAGs und -Aufgaben bietet. Auf dieser Seite werden Schritte zur Fehlerbehebung für verschiedene Probleme beim Zugriff auf den Airflow-Webserver Ihrer Umgebung oder für Webserver-bezogene Warnungen in Airflow-Logs beschrieben.
Bei aktivierter Netzwerkzugriffssteuerung kann nicht auf die Airflow-UI zugegriffen werden
Symptom: Nach der Konfiguration der Zugriffssteuerung für Webserver ist der Zugriff auf die Airflow-UI nicht mehr möglich. Normalerweise wird in dieser Situation der Fehlercode 403 angezeigt.
Informationen zum Problem: Cloud Composer unterstützt Netzwerkzugriffskontrollen für Webserver. Damit können Sie IP-Bereiche angeben, die eine Verbindung zum Webserver herstellen dürfen.
Probleme beim Zugriff auf die Airflow-UI führen in der Regel zu Fehler 403. So prüfen Sie, ob der Fehler mit der Netzwerkzugriffssteuerung des Webservers zusammenhängt:
Klicken Sie in der Liste der Umgebungen auf den Namen Ihrer Umgebung.
Die Seite Umgebungsdetails wird geöffnet.
Rufen Sie den Tab Umgebungskonfiguration auf.
Prüfen Sie, ob das Element Webserver-Zugriffssteuerung auf Alle IP-Adressen haben Zugriff (Standardeinstellung) festgelegt ist.
Wenn ein anderer Wert als Alle IP-Adressen haben Zugriff (Standard) konfiguriert ist, ist die Netzwerkzugriffskontrolle aktiviert und die Sichtbarkeit der Airflow-UI ist auf die angegebenen IPv4- und IPv6-Adressbereiche beschränkt. In diesem Fall hängt das Problem möglicherweise mit der Netzwerkzugriffssteuerung für Webserver zusammen.
In den meisten Fällen liegt die Ursache des Problems in der Diskrepanz zwischen der von Ihnen angegebenen IP-Adresse und der IP-Adresse, die tatsächlich aufgelöst wird, um eine Verbindung zur Airflow-Benutzeroberfläche herzustellen. So beheben Sie das Problem:
Klicken Sie in der Liste der Umgebungen auf den Namen Ihrer Umgebung.
Die Seite Umgebungsdetails wird geöffnet.
Rufen Sie den Tab Umgebungskonfiguration auf.
Suchen Sie das Element Webserver-Zugriffssteuerung und klicken Sie auf Bearbeiten.
Wählen Sie im Dialogfeld Netzwerkzugriffskontrolle für Webserver die Option Zugriff über alle IP-Adressen zulassen aus.
Rufen Sie die Airflow-UI mehrmals auf und prüfen Sie, ob sie ohne Probleme funktioniert:
Wenn keine Probleme auftreten, fahren Sie mit dem nächsten Schritt fort.
Wenn an dieser Stelle ein Problem auftritt, liegt es möglicherweise an der Konfiguration Ihrer IAM-Berechtigungen. Weitere Informationen zu den IAM-Berechtigungen für Cloud Composer finden Sie unter Zugriffssteuerung.
Wählen Sie im Dialogfeld Netzwerkzugriffssteuerung für Webserver die Option Zugriff nur von bestimmten IP-Adressen zulassen aus.
Fügen Sie den 0.0.0.0/0-IP-Bereich hinzu, greifen Sie mehrmals auf die Airflow-UI zu und prüfen Sie, ob sie problemlos funktioniert:
Wenn keine Probleme auftreten, ist die IP-Adresse, mit der Sie eine Verbindung herstellen, eine IPv4-Adresse.
Wenn an dieser Stelle ein Problem auftritt, bedeutet das, dass die IP-Adresse, mit der Sie eine Verbindung herstellen, eine IPv6-Adresse ist.
Löschen Sie den 0.0.0.0/0-IP-Bereich und fügen Sie den ::/0-IP-Bereich hinzu.
Wenn keine Probleme auftreten, ist die IP-Adresse, mit der Sie eine Verbindung herstellen, eine IPv6-Adresse.
Wenn an dieser Stelle ein Problem auftritt, bedeutet das, dass die IP-Adresse, mit der Sie eine Verbindung herstellen, eine IPv4-Adresse ist.
Sie haben nun ermittelt, ob es sich bei der aufgelösten Adresse um eine IPv4- oder IPv6-Adresse handelt.
Je nach Adresstyp können Sie die Bereiche ::/0 oder 0.0.0.0/0 auf spezifischere Bereiche eingrenzen, um den breitesten Bereich zu ermitteln, wenn der Zugriff nicht mehr funktioniert:
Sie können mit der breiten Subnetzmaske (z. B. 192.0.2.0/8) beginnen, die die Adresse enthält, die Sie für Ihre IP-Adresse halten.
Um Ihre IP-Adresse zu ermitteln, können Sie einen Drittanbieterdienst verwenden, der Ihre externe IP-Adresse angibt, wenn Sie die entsprechende Seite aufrufen. Sie können nach solchen Diensten suchen, indem Sie die Suchanfrage „Wie lautet meine IP-Adresse?“ verwenden.
Konfigurationswerte werden auf der Konfigurationsseite nicht angezeigt
Einige Airflow-Konfigurationsparameter sind auf der Konfigurationsseite ausgeblendet, um den Zugriff auf potenziell vertrauliche Informationen zu verhindern. So werden beispielsweise keine Anmeldedaten für den Zugriff auf die Airflow-Datenbank angezeigt.
Um ausgeblendete Felder anzuzeigen, überschreiben Sie die folgende Airflow-Konfigurationsoption. Wir empfehlen, die Änderungen rückgängig zu machen, nachdem Sie die erforderlichen Werte erhalten haben.
Bereich
Schlüssel
Wert
Hinweise
webserver
expose_config
True
Der Standardwert ist non-sensitive-only. Legen Sie False fest, um alle Konfigurationsparameter auszublenden.
DAG verursacht den Absturz des Airflow-Webservers oder einen „502 gateway timeout“-Fehler
Webserverausfälle können aus verschiedenen Gründen auftreten. Prüfen Sie die airflow-webserver-Logs in Cloud Logging, um die Ursache des Fehlers 502 gateway timeout zu ermitteln.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)"]]
