Como solucionar problemas do servidor da Web do Airflow

Airflow gerenciado (Geração 3) | Airflow gerenciado (Geração 2) | Airflow gerenciado (Geração 1 legada)

Nesta página, você encontra etapas de solução de problemas e informações sobre problemas comuns do servidor da Web do Airflow.

O servidor da Web do Airflow é um componente do Airflow que fornece uma interface do usuário para gerenciar DAGs e tarefas do Airflow. Esta página descreve as etapas de solução de problemas para vários problemas ao acessar o servidor da Web do Airflow do seu ambiente ou para avisos relacionados ao servidor da Web visíveis nos registros do Airflow.

Não é possível acessar a interface do Airflow quando os controles de acesso à rede estão ativados

Sintoma: depois que os controles de acesso ao servidor da Web são configurados, não é possível acessar a interface do Airflow. Geralmente, o código de erro exibido nessa situação é 403.

Informações sobre o problema: o Airflow gerenciado oferece suporte a controles de acesso à rede do servidor da Web, que permitem especificar intervalos de IP que podem se conectar ao servidor da Web.

Problemas ao acessar a interface do Airflow geralmente resultam no erro 403. Para verificar se o erro está relacionado aos controles de acesso à rede do servidor da Web, faça o seguinte:

  1. Na lista de ambientes, clique no nome do seu ambiente. A página Detalhes do ambiente é aberta.
  2. Acesse a guia Configuração do ambiente.
  3. Verifique se o item Controle de acesso ao servidor da Web está definido como Todos os endereços IP têm acesso (padrão).
  4. Se um valor diferente de Todos os endereços IP têm acesso (padrão) estiver configurado, o controle de acesso à rede será ativado e a visibilidade da interface do Airflow será limitada aos intervalos de endereços IPv4 e IPv6 fornecidos. Nesse caso, o problema pode estar relacionado aos controles de acesso à rede do servidor da Web.

Na maioria dos casos, a causa do problema é a incompatibilidade entre o IP pretendido especificado e o IP que é resolvido para se conectar à interface do Airflow. Para resolver o problema, faça o seguinte:

  1. Na lista de ambientes, clique no nome do seu ambiente. A página Detalhes do ambiente é aberta.

  2. Acesse a guia Configuração do ambiente.

  3. Encontre o item Controle de acesso ao servidor da Web e clique em Editar.

  4. Na caixa de diálogo Controle de acesso à rede do servidor da Web, selecione Permitir acesso de todos os endereços IP.

  5. Acesse a interface do Airflow várias vezes e verifique se ela funciona sem problemas:

    • Se você não tiver problemas, continue para a próxima etapa.

    • Se você tiver um problema nesse momento, isso significa que o problema pode estar relacionado à configuração de permissões do IAM. Para mais informações sobre as permissões do IAM para o Airflow gerenciado, consulte Controle de acesso.

  6. Na caixa de diálogo Controle de acesso à rede do servidor da Web, selecione Permitir acesso apenas de endereços IP específicos.

  7. Adicione o intervalo de IP 0.0.0.0/0 e acesse a interface do Airflow várias vezes e verifique se ela funciona sem problemas:

    • Se você não tiver problemas, o IP com que você está se conectando é um endereço IPv4.

    • Se você tiver um problema nesse momento, isso significa que o IP com que você está se conectando é um endereço IPv6.

  8. Exclua o intervalo de IP 0.0.0.0/0 e adicione o intervalo de IP ::/0.

    • Se você não tiver problemas, o IP com que você está se conectando é um endereço IPv6.

    • Se você tiver um problema nesse momento, isso significa que o IP com que você está se conectando é um endereço IPv4.

  9. Agora você determinou se o endereço resolvido é IPv4 ou IPv6.

  10. Dependendo do tipo de endereço, restrinja os intervalos ::/0 ou 0.0.0.0/0 a intervalos mais específicos para verificar o intervalo mais amplo quando o acesso parar de funcionar:

    • Você pode começar com a máscara de sub-rede ampla (como 192.0.2.0/8) que inclui o endereço que você considera ser seu endereço IP.

    • Para determinar seu endereço IP, use um serviço de terceiros que forneça seu endereço IP externo quando você visitar a página dele. Você pode pesquisar esses serviços pela consulta "qual é meu endereço IP".

Os valores de configuração não são mostrados na página de configuração

Alguns parâmetros de configuração do Airflow são ocultos na página de configuração para impedir o acesso a informações potencialmente sensíveis. Por exemplo, as credenciais para acessar o banco de dados do Airflow não são mostradas.

Para mostrar campos ocultos, substitua a seguinte opção de configuração do Airflow. Recomendamos reverter as mudanças depois de receber os valores necessários.

Seção Chave Valor Observações
webserver expose_config True O valor padrão é non-sensitive-only. Defina como False para ocultar todos os parâmetros de configuração.

O DAG trava o servidor da Web do Airflow ou faz ele retornar um erro "502 gateway timeout"

As falhas do servidor da Web podem ocorrer por diversos motivos. Verifique os registros airflow-webserver no Cloud Logging para determinar a causa do 502 gateway timeout erro.

A seguir