Cloud Composer 1 | Cloud Composer 2
Questa pagina spiega come ottenere informazioni sui DAG nel tuo ambiente.
Metodi per visualizzare le informazioni sui DAG
Cloud Composer offre diversi modi per ottenere informazioni dettagliate sui DAG nel tuo ambiente:
- La UI DAG è una sezione dell'interfaccia della console Google Cloud per Cloud Composer dedicata alla visualizzazione e al monitoraggio dei DAG, delle esecuzioni di DAG e delle singole attività.
- La UI di Airflow è l'interfaccia web integrata di Airflow.
- L'interfaccia a riga di comando di Airflow è l'interfaccia a riga di comando di Airflow. Puoi ottenere informazioni sui DAG eseguendo i comandi dell'interfaccia a riga di comando di Airflow con
gcloud.
Informazioni sulla UI DAG di Cloud Composer
La UI DAG è una sezione dell'interfaccia della console Google Cloud per Cloud Composer dedicata alla visualizzazione e al monitoraggio dei DAG, delle esecuzioni di DAG e delle singole attività.
Nella UI DAG puoi:
Visualizza un elenco di DAG nel tuo ambiente, inclusi intervalli di pianificazione, stati dei DAG e descrizioni.
Mettere in pausa, riattivare e attivare i DAG.
Visualizza i dettagli dell'esecuzione di DAG, tra cui le esecuzioni riuscite, attive e non riuscite, dal tempo dall'ultima esecuzione completata. Per ogni DAG puoi visualizzare la cronologia delle esecuzioni dei DAG e delle istanze di attività associate a questo particolare DAG, inclusi i log per le attività eseguite.
Filtra dettagli esecuzione DAG. Ad esempio, puoi scegliere un intervallo di tempo e creare query per selezionare le informazioni che ti servono.
Visualizza informazioni dettagliate sulle singole attività e sui singoli DAG. Sono inclusi diagrammi DAG visualizzati, informazioni sulle attività all'interno di un DAG, codice sorgente DAG e informazioni aggiuntive sui DAG.
Prima di iniziare
La UI DAG richiede l'attivazione della serializzazione DAG.
La UI DAG è supportata in Cloud Composer 1.17.8 e versioni successive.
Visualizza l'elenco di DAG per il tuo ambiente
Console
La scheda DAG del tuo ambiente mostra l'elenco dei DAG e i dettagli dell'esecuzione di DAG per ogni DAG.
Per visualizzare l'elenco dei DAG:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Elenco DAG, segui il link DAG per il tuo ambiente.
Puoi utilizzare i filtri per visualizzare i dettagli solo per determinati DAG o per determinate condizioni. Ad esempio:
- Seleziona il campo Filtri.
- Dall'elenco a discesa, seleziona la proprietà DAG id (ID DAG).
- Specifica l'identificatore del DAG. I risultati mostrano i dettagli solo per il DAG selezionato.
- (Facoltativo) Per includere altri DAG, aggiungi gli operatori
ORseguiti dagli ID DAG. - (Facoltativo) Per filtrare in base ad altre condizioni, aggiungi altre proprietà nel
campo Filtri. Ad esempio, puoi filtrare i DAG con esecuzioni non riuscite specificando
Failed runs:>0.
UI di Airflow
Per visualizzare l'elenco dei DAG nell'interfaccia web di Airflow:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Airflow webserver, segui il link Airflow per il tuo ambiente.
Accedi con l'Account Google che dispone delle autorizzazioni appropriate.
Nella pagina DAG dell'interfaccia web di Airflow viene visualizzato un elenco di DAG per il tuo ambiente.
gcloud
In Airflow 1.10.*, esegui il comando list_dags dell'interfaccia a riga di comando di Airflow:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
list_dags
In Airflow 2, esegui il comando dags list dell'interfaccia a riga di comando di Airflow:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
dags list -- -o plain
Sostituisci:
ENVIRONMENT_NAMEcon il nome dell'ambiente.LOCATIONcon la regione in cui si trova l'ambiente.
Visualizzare la cronologia delle esecuzioni e delle attività di DAG
Console
La scheda Esecuzioni nella pagina Dettagli DAG mostra la cronologia delle esecuzioni di DAG per un singolo DAG.
Per visualizzare la cronologia delle esecuzioni di DAG:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Elenco DAG, segui il link DAG per il tuo ambiente.
Seleziona un DAG.
Nella pagina Dettagli DAG, vai alla scheda Esecuzioni.
Seleziona un'esecuzione di DAG dall'elenco per visualizzare i dettagli dell'esecuzione, ad esempio lo stato delle istanze dell'attività per questa esecuzione di DAG, il numero di tentativi e la durata dell'esecuzione. Puoi selezionare singole attività per visualizzare i log delle istanze delle attività.
UI di Airflow
Per visualizzare l'elenco dei DAG nell'interfaccia web di Airflow:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Airflow webserver, segui il link Airflow per il tuo ambiente.
Accedi con l'Account Google che dispone delle autorizzazioni appropriate.
Nell'interfaccia web di Airflow, nel menu, seleziona Sfoglia > Esecuzioni DAG. Nella pagina Esecuzioni DAG vengono visualizzate le esecuzioni DAG per il tuo ambiente. Puoi seguire il link nella colonna ID esecuzione per ottenere ulteriori informazioni sulle attività.
gcloud
In Airflow 1.10.*, esegui il comando list_dag_runs dell'interfaccia a riga di comando di Airflow:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
list_dag_runs -- DAG_ID
In Airflow 2, esegui il comando dags list-runs dell'interfaccia a riga di comando di Airflow:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
dags list-runs -- -d DAG_ID
Sostituisci:
ENVIRONMENT_NAMEcon il nome dell'ambiente.LOCATIONcon la regione in cui si trova l'ambiente.DAG_IDcon il nome del DAG.
Per ottenere ulteriori informazioni sulle istanze delle attività, esegui i comandi dell'interfaccia a riga di comando di Airflow tasks state e tasks states-for-dag-run.
Per ulteriori informazioni, consulta Accesso a interfaccia a riga di comando di Airflow e riferimento dell'interfaccia a riga di comando di Airflow per Airflow 1 e Airflow 2.
Visualizza diagrammi DAG
Console
La scheda Diagramma nella pagina Dettagli DAG mostra la visualizzazione di un DAG con dipendenze delle attività.
Per visualizzare il diagramma di un DAG:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Elenco DAG, segui il link DAG per il tuo ambiente.
Seleziona un DAG.
Nella pagina Dettagli DAG, vai alla scheda Diagramma.
(Facoltativo) Per visualizzare ulteriori informazioni sulle attività, seleziona le singole attività nel diagramma.
UI di Airflow
Per visualizzare il diagramma di un DAG nell'interfaccia web di Airflow:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Airflow webserver, segui il link Airflow per il tuo ambiente.
Accedi con l'Account Google che dispone delle autorizzazioni appropriate.
Nella pagina DAG dell'interfaccia web di Airflow viene visualizzato un elenco di DAG per il tuo ambiente.
Per il DAG, nella colonna Link, segui il link Visualizzazione grafico.
Visualizza il codice sorgente dei DAG e ulteriori informazioni sui DAG
Console
Puoi visualizzare il codice sorgente dei DAG e informazioni aggiuntive come gli identificatori DAG e i link ai file di definizione dei DAG nel bucket di ambiente.
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Elenco DAG, segui il link DAG per il tuo ambiente.
Seleziona un DAG.
Per visualizzare il codice sorgente del DAG, vai alla scheda Diagramma.
Per visualizzare ulteriori informazioni sul DAG, vai alla scheda Origine.
UI di Airflow
Per visualizzare il diagramma di un DAG nell'interfaccia web di Airflow:
Nella console Google Cloud, vai alla pagina Ambienti.
Nella colonna Airflow webserver, segui il link Airflow per il tuo ambiente.
Accedi con l'Account Google che dispone delle autorizzazioni appropriate.
Nell'interfaccia web di Airflow, nella pagina DAG, fai clic sul nome del tuo DAG.
Nella pagina con i dettagli dei DAG, vai alle schede disponibili per visualizzare ulteriori informazioni sul DAG.