El 15 de septiembre de 2026, todos los entornos de Cloud Composer 1 y Cloud Composer 2 versión 2.0.x alcanzarán el final de su ciclo de vida previsto, y no podrás usarlos. Te recomendamos que planifiques la migración a Cloud Composer 3.
En esta página, se proporcionan información y pasos para solucionar problemas comunes con el servidor web de Airflow.
El servidor web de Airflow es un componente de Airflow que proporciona una interfaz de usuario para administrar los DAG y las tareas de Airflow. En esta página, se describen los pasos para solucionar problemas relacionados con el acceso al servidor web de Airflow de tu entorno o con las advertencias relacionadas con el servidor web que se ven en los registros de Airflow.
No se puede acceder a la IU de Airflow cuando los controles de acceso a la red están habilitados
Síntoma: Después de configurar los controles de acceso al servidor web, no es posible acceder a la IU de Airflow. Por lo general, el código de error que se muestra en esta situación es 403.
Información sobre el problema: Cloud Composer admite controles de acceso a la red del servidor web, lo que te permite especificar los rangos de IP que pueden conectarse al servidor web.
Los problemas para acceder a la IU de Airflow suelen generar el error 403. Para verificar si el error está relacionado con los controles de acceso a la red del servidor web, haz lo siguiente:
En la lista de entornos, haz clic en el nombre de tu entorno.
Se abrirá la página Detalles del entorno.
Ve a la pestaña Configuración del entorno.
Verifica si el elemento Control de acceso al servidor web está configurado como Todas las direcciones IP tienen acceso (predeterminado).
Si se configura un valor diferente de Todas las direcciones IP tienen acceso (predeterminado), se habilita el control de acceso a la red y la visibilidad de la IU de Airflow se limita a los rangos de direcciones IPv4 e IPv6 proporcionados. En este caso, el problema podría estar relacionado con los controles de acceso a la red del servidor web.
En la mayoría de los casos, la causa del problema es la discrepancia entre la IP prevista que especificaste y la IP que realmente se resuelve para conectarse a la IU de Airflow. Para solucionar el problema, haz lo siguiente:
En la lista de entornos, haz clic en el nombre de tu entorno.
Se abrirá la página Detalles del entorno.
Ve a la pestaña Configuración del entorno.
Busca el elemento Control de acceso del servidor web y haz clic en Editar.
En el diálogo Control de acceso a la red del servidor web, selecciona Permitir acceso desde todas las direcciones IP.
Accede a la IU de Airflow varias veces y verifica que funcione sin problemas:
Si no tienes problemas, continúa con el siguiente paso.
Si tienes un problema en este punto, significa que el problema podría estar relacionado con la configuración de tus permisos de IAM. Para obtener más información sobre los permisos de IAM para Cloud Composer, consulta Control de acceso.
En el diálogo Control de acceso a la red del servidor web, selecciona Permitir el acceso solo desde direcciones IP específicas.
Agrega el rango de IP 0.0.0.0/0, luego accede a la IU de Airflow varias veces y verifica que funcione sin problemas:
Si no tienes problemas, la IP con la que te conectas es una dirección IPv4.
Si tienes un problema en este punto, significa que la IP con la que te conectas es una dirección IPv6.
Borra el rango de IP 0.0.0.0/0 y agrega el rango de IP ::/0.
Si no tienes problemas, la IP con la que te conectas es una dirección IPv6.
Si tienes un problema en este punto, significa que la IP con la que te conectas es una dirección IPv4.
Ahora determinaste si tu dirección resuelta es IPv4 o IPv6.
Según el tipo de dirección, reduce los rangos de ::/0 o 0.0.0.0/0 a rangos más específicos para verificar el rango más amplio cuando deje de funcionar el acceso:
Puedes comenzar con la máscara de subred amplia (como 192.0.2.0/8) que incluye la dirección que supones que es tu dirección IP.
Para determinar tu dirección IP, puedes usar un servicio de terceros que te proporcione tu dirección IP externa cuando visites su página. Puedes buscar estos servicios con la búsqueda "cuál es mi dirección IP").
Los valores de configuración no se muestran en la página de configuración
Algunos parámetros de configuración de Airflow están ocultos en la página de configuración para evitar el acceso a información potencialmente sensible. Por ejemplo, no se muestran las credenciales para acceder a la base de datos de Airflow.
Para mostrar los campos ocultos, anula la siguiente opción de configuración de Airflow. Te recomendamos que reviertas los cambios después de obtener los valores requeridos.
Sección
Clave
Valor
Notas
webserver
expose_config
True
El valor predeterminado es non-sensitive-only. Establécelo en False para ocultar todos los parámetros de configuración.
El DAG provoca una falla en el servidor web de Airflow o hace que muestre un error de "tiempo de espera de la puerta de enlace 502".
Las fallas del servidor web pueden ocurrir por varias razones diferentes. Verifica los registros de airflow-webserver en Cloud Logging para determinar la causa del error 502 gateway timeout.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
