A 15 de setembro de 2026, todos os ambientes do Cloud Composer 1 e do Cloud Composer 2 versão 2.0.x vão atingir o fim da vida útil planeado e não vai poder usá-los. Recomendamos que planeie a migração para o Cloud Composer 3.
Esta página fornece passos de resolução de problemas e informações para problemas comuns do servidor Web do Airflow.
O servidor Web do Airflow é um componente do Airflow que fornece uma interface do utilizador
para gerir DAGs e tarefas do Airflow. Esta página descreve os passos de resolução de problemas
para vários problemas de acesso ao servidor Web do Airflow do seu ambiente ou
para avisos relacionados com o servidor Web visíveis nos registos do Airflow.
Não é possível aceder à IU do Airflow quando os controlos de acesso à rede estão ativados
Sintoma: depois de configurar os controlos de acesso do servidor Web, não é possível aceder à IU do Airflow. Normalmente, o código de erro apresentado nesta situação é 403.
Informações sobre o problema: o Cloud Composer suporta
controlos de acesso à rede do servidor Web,
que lhe permitem especificar intervalos de IP com autorização para estabelecer ligação ao servidor Web.
Os problemas de acesso à IU do Airflow resultam normalmente no erro 403. Para verificar se o erro está relacionado com os controlos de acesso à rede do servidor Web, faça o seguinte:
Na lista de ambientes, clique no nome do seu ambiente.
É apresentada a página Detalhes do ambiente.
Aceda ao separador Configuração do ambiente.
Verifique se o item Controlo de acesso ao servidor Web está definido como
Todos os endereços IP têm acesso (predefinição).
Se for configurado um valor diferente de Todos os endereços IP têm acesso (predefinição), o controlo de acesso à rede é ativado e a visibilidade da IU do Airflow é limitada aos intervalos de endereços IPv4 e IPv6 fornecidos. Neste caso, o problema pode estar relacionado com os controlos de acesso à rede do servidor Web.
Na maioria dos casos, a causa do problema é a incompatibilidade entre o IP pretendido que especificou e o IP que é realmente resolvido para estabelecer ligação à IU do Airflow. Para resolver o problema, faça o seguinte:
Na lista de ambientes, clique no nome do seu ambiente.
É apresentada a página Detalhes do ambiente.
Aceda ao separador Configuração do ambiente.
Localize o item Controlo de acesso ao servidor Web e clique em Editar.
Na caixa de diálogo Controlo de acesso à rede do servidor Web, selecione
Permitir acesso a partir de todos os endereços IP.
Aceda à IU do Airflow várias vezes e verifique se funciona sem problemas:
Se não tiver problemas, avance para o passo seguinte.
Se tiver um problema neste ponto, significa que o problema pode estar relacionado com a configuração das suas autorizações da IAM. Para mais informações sobre as autorizações de IAM para o Cloud Composer, consulte o artigo Controlo de acesso.
Na caixa de diálogo Controlo de acesso à rede do servidor Web, selecione
Permitir acesso apenas a partir de endereços IP específicos.
Adicione o 0.0.0.0/0intervalo de IP e, em seguida, aceda à IU do Airflow várias vezes e
verifique se funciona sem problemas:
Se não tiver problemas, o IP com o qual está a estabelecer ligação é um endereço IPv4.
Se tiver um problema neste ponto, significa que o IP com o qual está a estabelecer ligação é um endereço IPv6.
Elimine o intervalo de IP 0.0.0.0/0 e adicione o intervalo de IP ::/0.
Se não tiver problemas, o IP com o qual está a estabelecer ligação é um endereço IPv6.
Se tiver um problema neste ponto, significa que o IP com o qual está a estabelecer ligação é um endereço IPv4.
Agora, determinou se o seu endereço resolvido é IPv4 ou IPv6.
Consoante o tipo de endereço, restrinja os intervalos de ::/0 ou 0.0.0.0/0 a intervalos mais específicos para validar o intervalo mais amplo quando o acesso deixa de funcionar:
Pode começar com a máscara de sub-rede ampla (como 192.0.2.0/8) que inclui o endereço que considera ser o seu endereço IP.
Para determinar o seu endereço IP, pode usar um serviço de terceiros que
fornece o seu endereço IP externo quando visita a respetiva página. Pode
pesquisar esses serviços através da consulta de pesquisa "qual é o meu endereço IP").
Os valores de configuração não são apresentados na página de configuração
Alguns parâmetros de configuração do Airflow estão ocultos na página de configuração para impedir o acesso a informações potencialmente confidenciais. Por exemplo, as credenciais para aceder à base de dados do Airflow não são apresentadas.
Para apresentar campos ocultos, substitua a seguinte opção de configuração do Airflow. Recomendamos que reverta as alterações depois de obter os valores necessários.
Secção
Chave
Valor
Notas
webserver
expose_config
True
O valor predefinido é non-sensitive-only. Defina como False para ocultar todos os parâmetros de configuração.
O DAG falha no servidor Web do Airflow ou faz com que devolva um erro "502 gateway timeout"
As falhas do servidor Web podem ocorrer por vários motivos diferentes. Verifique os registos do airflow-webserver no Cloud Logging para determinar a causa do erro 502 gateway timeout.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 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)"]]
