Il 15 settembre 2026, tutti gli ambienti Cloud Composer 1 e Cloud Composer 2 versione 2.0.x raggiungeranno la fine del ciclo di vita pianificata e non potrai più utilizzarli. Ti consigliamo di pianificare la migrazione a Cloud Composer 3.
Questa pagina fornisce informazioni e passaggi per la risoluzione dei problemi comuni del web server Airflow.
Il server web di Airflow è un componente di Airflow che fornisce un'interfaccia utente per la gestione dei DAG e delle attività di Airflow. Questa pagina descrive la procedura di risoluzione dei problemi relativi all'accesso al server web di Airflow del tuo ambiente o agli avvisi relativi al server web visibili nei log di Airflow.
Impossibile accedere all'interfaccia utente di Airflow quando i controlli di accesso alla rete sono abilitati
Sintomo: dopo aver configurato i controlli di accesso al server web, non è possibile accedere all'interfaccia utente di Airflow. Di solito, il codice di errore visualizzato in questa situazione è 403.
Informazioni sul problema: Cloud Composer supporta i controlli di accesso di rete del server web, che ti consentono di specificare gli intervalli IP che possono connettersi al server web.
I problemi di accesso all'interfaccia utente di Airflow di solito generano l'errore 403. Per verificare se
l'errore è correlato ai controlli dell'accesso di rete del server web:
Nell'elenco degli ambienti, fai clic sul nome dell'ambiente.
Viene visualizzata la pagina Dettagli dell'ambiente.
Vai alla scheda Configurazione dell'ambiente.
Verifica che l'elemento Controllo dell'accesso al server web sia impostato su
Tutti gli indirizzi IP hanno accesso (impostazione predefinita).
Se è configurato un valore diverso da Tutti gli indirizzi IP hanno accesso (valore predefinito), il controllo dell'accesso di rete è abilitato e la visibilità dell'interfaccia utente di Airflow è limitata agli intervalli di indirizzi IPv4 e IPv6 forniti. In questo caso, il problema potrebbe essere correlato ai controlli di accesso alla rete del server web.
Nella maggior parte dei casi, la causa del problema è la mancata corrispondenza tra l'IP previsto
che hai specificato e l'IP effettivamente risolto per la connessione all'UI di Airflow. Per risolvere il problema:
Nell'elenco degli ambienti, fai clic sul nome dell'ambiente.
Viene visualizzata la pagina Dettagli dell'ambiente.
Vai alla scheda Configurazione dell'ambiente.
Individua l'elemento Controllo dell'accesso al server web e fai clic su Modifica.
Nella finestra di dialogo Controllo dell'accesso di rete al server web, seleziona Consenti l'accesso da tutti gli indirizzi IP.
Accedi all'interfaccia utente di Airflow più volte e verifica che funzioni senza problemi:
Se non riscontri problemi, vai al passaggio successivo.
Se a questo punto riscontri un problema, significa che potrebbe essere correlato alla configurazione delle autorizzazioni IAM. Per maggiori informazioni sulle autorizzazioni IAM per Cloud Composer, consulta Controllo dell'accesso.
Nella finestra di dialogo Controllo dell'accesso di rete al server web, seleziona Consenti l'accesso solo da indirizzi IP specifici.
Aggiungi l'intervallo IP 0.0.0.0/0, poi accedi all'interfaccia utente di Airflow più volte e
verifica che funzioni senza problemi:
Se non riscontri problemi, l'IP con cui ti colleghi è un indirizzo IPv4.
Se a questo punto si verifica un problema, significa che l'IP con cui ti colleghi è un indirizzo IPv6.
Elimina l'intervallo IP 0.0.0.0/0 e aggiungi l'intervallo IP ::/0.
Se non riscontri problemi, l'IP con cui ti colleghi è un indirizzo IPv6.
Se a questo punto si verifica un problema, significa che l'IP con cui ti colleghi è un indirizzo IPv4.
Ora hai stabilito se l'indirizzo risolto è IPv4 o IPv6.
A seconda del tipo di indirizzo, riduci gli intervalli ::/0 o 0.0.0.0/0
a intervalli più specifici per verificare l'intervallo più ampio quando l'accesso smette di funzionare:
Puoi iniziare con la subnet mask ampia (ad esempio 192.0.2.0/8) che include l'indirizzo che ritieni essere il tuo indirizzo IP.
Per determinare il tuo indirizzo IP, puoi utilizzare un servizio di terze parti che fornisce il tuo indirizzo IP esterno quando visiti la sua pagina. Puoi
trovare questi servizi utilizzando la query di ricerca "Qual è il mio indirizzo IP?".
I valori di configurazione non vengono visualizzati nella pagina di configurazione
Alcuni parametri di configurazione di Airflow sono nascosti nella pagina di configurazione per impedire l'accesso a informazioni potenzialmente sensibili. Ad esempio, le credenziali per accedere al database Airflow non vengono visualizzate.
Per visualizzare i campi nascosti, sostituisci la seguente opzione di configurazione di Airflow. Ti consigliamo di annullare le modifiche dopo aver ottenuto i valori richiesti.
Sezione
Chiave
Valore
Note
webserver
expose_config
True
Il valore predefinito è non-sensitive-only. Imposta su False per nascondere tutti i parametri di configurazione.
Il DAG arresta in modo anomalo il server web Airflow o ne causa il ritorno di un errore "502 Gateway Timeout"
Gli errori del server web possono verificarsi per diversi motivi. Controlla i log di airflow-webserver in Cloud Logging per determinare la causa dell'errore 502 gateway timeout.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-29 UTC."],[[["\u003cp\u003eThis page offers guidance on troubleshooting common issues with the Airflow web server, which provides a user interface for managing Airflow DAGs and tasks.\u003c/p\u003e\n"],["\u003cp\u003eThe primary focus is on resolving access problems, particularly error 403, when web server network access controls are enabled in Cloud Composer 2.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting involves verifying if network access control is enabled and then pinpointing the discrepancy between the intended IP and the actual IP used to connect to the Airflow UI.\u003c/p\u003e\n"],["\u003cp\u003eThe document outlines a step-by-step process to identify whether the resolved IP address is IPv4 or IPv6, then narrowing down IP ranges for specific access permissions.\u003c/p\u003e\n"],["\u003cp\u003eThe content is applicable to Cloud Composer 2 only and is not yet revised for Cloud Composer 3.\u003c/p\u003e\n"]]],[],null,["**Cloud Composer 3** \\| [Cloud Composer 2](/composer/docs/composer-2/troubleshooting-web-server \"View this page for 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| **Note:** This page is **not yet revised for Cloud Composer 3** and displays content for Cloud Composer 2.\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)"]]
