Résoudre les problèmes avec le programmeur Airflow

Cloud Composer 1 | Cloud Composer 2

Cette page fournit les étapes de dépannage et des informations pour résoudre les problèmes courants liés aux programmeurs Airflow.

Identifier la source du problème

Pour commencer le dépannage, déterminez si le problème se produit au moment de l'analyse du DAG ou pendant le traitement des tâches au moment de l'exécution. Pour en savoir plus sur le temps d'analyse et la durée d'exécution du DAG, consultez la section Différence entre le temps d'analyse du DAG et la durée d'exécution du DAG.

Inspecter les journaux de processeur DAG

Si vous disposez de DAG complexes, il est possible que le processeur DAG, exécuté par le programmeur, n'analyse pas tous vos DAG. Cela peut entraîner de nombreux problèmes avec les symptômes suivants.

Symptômes :

• Si le processeur DAG rencontre des problèmes lors de l'analyse de vos DAG, les problèmes indiqués ci-dessous peuvent être combinés. Si les DAG sont générés de manière dynamique, ces problèmes peuvent avoir plus d'impact que les DAG statiques.

• Les DAG ne sont pas visibles dans les interfaces utilisateur d'Airflow et de DAG.

• L'exécution des DAG n'est pas planifiée.

• Les journaux du processeur DAG contiennent des erreurs, par exemple:

  dag-processor-manager [2023-04-21 21:10:44,510] {manager.py:1144} ERROR -
  Processor for /home/airflow/gcs/dags/dag-example.py with PID 68311 started
  at 2023-04-21T21:09:53.772793+00:00 has timed out, killing it.
  

  ou

  dag-processor-manager [2023-04-26 06:18:34,860] {manager.py:948} ERROR -
  Processor for /home/airflow/gcs/dags/dag-example.py exited with return
  code 1.
  

• Les programmeurs Airflow rencontrent des problèmes qui les redémarrent.

• Les tâches Airflow dont l'exécution est programmée sont annulées, et les exécutions de DAG pour les DAG dont l'analyse a échoué peuvent être marquées comme failed. Exemple :

  airflow-scheduler Failed to get task '<TaskInstance: dag-example.task1--1
  manual__2023-04-17T10:02:03.137439+00:00 [removed]>' for dag
  'dag-example'. Marking it as removed.
  

Solution :

• Augmentez le nombre de paramètres liés à l'analyse du DAG:

  • Augmentez la valeur de dagbag-import-timeout à au moins 120 secondes (ou plus, si nécessaire).

  • Augmentez la valeur de dag-file-processor-timeout à 180 secondes au moins (ou plus, si nécessaire). Cette valeur doit être supérieure à dagbag-import-timeout.

• Corrigez ou supprimez les DAG qui causent des problèmes au processeur DAG.

Inspecter les durées d'analyse des DAG

Pour vérifier si le problème se produit au moment de l'analyse du DAG, procédez comme suit :

Console

Dans la console Google Cloud, vous pouvez utiliser la page Surveillance et l'onglet Journaux pour inspecter les temps d'analyse des DAG.

Inspectez les temps d'analyse des DAG sur la page de surveillance de Cloud Composer:

1. Dans la console Google Cloud, accédez à la page Environnements.

   Accéder à la page Environnements

2. Dans la liste des environnements, cliquez sur le nom de votre environnement. La page Monitoring s'ouvre.

3. Dans l'onglet Surveillance, consultez le graphique Temps total d'analyse pour tous les fichiers DAG de la section Exécutions DAG et identifiez les problèmes potentiels.

   

Inspectez les temps d'analyse du DAG dans l'onglet Journaux Cloud Composer:

1. Dans la console Google Cloud, accédez à la page Environnements.

   Accéder à la page Environnements

2. Dans la liste des environnements, cliquez sur le nom de votre environnement. La page Monitoring s'ouvre.

3. Accédez à l'onglet Journaux et, dans l'arborescence de navigation Tous les journaux, sélectionnez la section Gestionnaire du processeur DAG.

4. Examinez les journaux dag-processor-manager et identifiez les problèmes éventuels.

   

gcloud – Airflow 1

Exécutez la commande list_dags avec l'option -r pour afficher le temps d'analyse de tous vos DAG.

gcloud composer environments run ENVIRONMENT_NAME \
    --location LOCATION \
    list_dags -- -r

Remplacez :

• ENVIRONMENT_NAME par le nom de l'environnement.
• LOCATION par la région dans laquelle se trouve l'environnement.

Le résultat de la commande ressemble à ceci :

-------------------------------------------------------------------
DagBag loading stats for /home/airflow/gcs/dags
-------------------------------------------------------------------
Number of DAGs: 5
Total task number: 13
DagBag parsing time: 0.6765180000000001
-----------+----------+---------+----------+-----------------------
file       | duration | dag_num | task_num | dags
-----------+----------+---------+----------+-----------------------
/dag_1.py  | 0.6477   |       1 |        2 | ['dag_1']
/dag_2.py  | 0.018652 |       1 |        2 | ['dag_2']
/dag_3.py  | 0.004024 |       1 |        6 | ['dag_3']
/dag_4.py  | 0.003476 |       1 |        2 | ['dag_4']
/dag_5.py  | 0.002666 |       1 |        1 | ['dag_5']
-----------+----------+---------+----------+-----------------------

Recherchez la valeur Temps d'analyse DagBag. Une valeur élevée peut indiquer que l'un de vos DAG n'est pas mis en œuvre de manière optimale. La table de sortie vous permet d'identifier les DAG dont la durée d'analyse est longue.

gcloud – Airflow 2

Utilisez la commande dags report pour afficher la durée d'analyse de tous vos DAG.

gcloud composer environments run ENVIRONMENT_NAME \
    --location LOCATION \
    dags report

Remplacez :

• ENVIRONMENT_NAME par le nom de l'environnement.
• LOCATION par la région dans laquelle se trouve l'environnement.

Le résultat de la commande ressemble à ceci :

Executing within the following Kubernetes cluster namespace: composer-2-0-31-airflow-2-3-3
file                  | duration       | dag_num | task_num | dags
======================+================+=========+==========+===================
/manydagsbig.py       | 0:00:00.038334 | 2       | 10       | serial-0,serial-0
/airflow_monitoring.py| 0:00:00.001620 | 1       | 1        | airflow_monitoring

Recherchez la valeur duration (durée) de chacun des dags répertoriés dans le tableau. Une valeur élevée peut indiquer que l'un de vos DAG n'est pas mis en œuvre de manière optimale. La table de sortie vous permet d'identifier les DAG dont le temps d'analyse est long.

Surveiller les tâches en cours et en file d'attente

Pour vérifier si des tâches sont bloquées dans une file d'attente, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Environnements.

   Accéder à la page Environnements

2. Dans la liste des environnements, cliquez sur le nom de votre environnement. La page Détails de l'environnement s'ouvre.

3. Accédez à l'onglet Surveillance.

4. Dans l'onglet Surveillance, consultez le graphique Tâches Airflow dans la section Exécutions du DAG et identifiez les problèmes éventuels. Les tâches Airflow sont des tâches en file d'attente dans Airflow. Elles peuvent être dirigées vers la file d'attente d'agents Celery ou Kubernetes Executor. Les tâches en file d'attente Celery sont des instances de tâches placées dans la file d'attente de l'agent Celery.

Résoudre les problèmes rencontrés au moment de l'analyse du DAG

Les sections suivantes décrivent les symptômes et les correctifs potentiels pour certains problèmes courants qui surviennent au moment de l'analyse du DAG.

Analyse et planification des DAG dans Cloud Composer 1 et Airflow 1

L'efficacité de l'analyse des DAG a été considérablement améliorée dans Airflow 2. Si vous rencontrez des problèmes de performances liés à l'analyse et à la planification du DAG, envisagez de migrer vers Airflow 2.

Dans Cloud Composer 1, le programmeur s'exécute sur les nœuds du cluster avec d'autres composants Cloud Composer. De ce fait, la charge des nœuds de cluster individuels peut être supérieure ou inférieure à celle des autres nœuds. Les performances du programmeur (analyse et planification du DAG) peuvent varier en fonction du nœud sur lequel il s'exécute. En outre, un nœud individuel sur lequel s'exécute le programmeur peut changer à la suite d'opérations de mise à niveau ou de maintenance. Cette limitation a été résolue dans Cloud Composer 2, où vous pouvez allouer des ressources de processeur et de mémoire au programmeur, où ses performances ne dépendent pas de la charge des nœuds du cluster.

Nombre limité de threads

Autoriser le gestionnaire de processeur DAG (la partie du programmeur qui traite les fichiers DAG) à n'utiliser qu'un nombre limité de threads peut affecter le temps d'analyse de votre DAG.

Pour résoudre le problème, remplacez les options de configuration Airflow suivantes:

• Pour Airflow 1.10.12 et les versions antérieures, remplacez le paramètre max_threads:

  Section	Clé	Valeur	Remarques
  scheduler	max_threads	NUMBER_OF_CORES_IN_MACHINE - 1	Remplacez NUMBER_OF_CORES_IN_MACHINE par le nombre de cœurs dans les machines des nœuds de calcul.

• Pour Airflow 1.10.14 et versions ultérieures, remplacez le paramètre parsing_processes:

  Section	Clé	Valeur	Remarques
  scheduler	parsing_processes	NUMBER_OF_CORES_IN_MACHINE - 1	Remplacez NUMBER_OF_CORES_IN_MACHINE par le nombre de cœurs dans les machines des nœuds de calcul.

Remarque :Pour vérifier la taille maximale des valeurs max_threads ou parsing_processes, accédez à Kubernetes Engine > Charges de travail > airflow-scheduler dans la console Google Cloud, puis consultez les graphiques d'utilisation du processeur et de la mémoire. Vous souhaitez que votre cluster fonctionne avec environ 70% de son processeur virtuel ou de sa capacité de mémoire.

Répartition du nombre et de la durée des tâches

Airflow est connu pour avoir des difficultés avec la planification d'un grand nombre de petites tâches. Dans de telles situations, il est préférable d'utiliser un nombre plus faible de tâches mieux consolidées.

La planification simultanée d'un grand nombre de DAG ou de tâches peut également être source de problèmes. Pour éviter ce problème, répartissez vos tâches de manière plus uniforme au fil du temps.

Résoudre les problèmes liés aux tâches en cours d'exécution et en file d'attente

Les sections suivantes décrivent les symptômes et les correctifs potentiels pour certains problèmes courants qui surviennent au moment de l'exécution ou de la mise en file d'attente des tâches.

Les files d'attente de tâches sont trop longues

Dans certains cas, une file d'attente de tâches peut être trop longue pour le planificateur. Pour en savoir plus sur l'optimisation des paramètres de nœud de calcul et de Celery, consultez la page Faire évoluer votre environnement Cloud Composer avec votre entreprise.

Utiliser la fonctionnalité TimeTable du programmeur Airflow

À partir d'Airflow 2.2, vous pouvez définir une table temporelle pour un DAG à l'aide d'une nouvelle fonctionnalité appelée TimeTable.

Vous pouvez définir un horaire en utilisant l'une des méthodes suivantes:

• Avec une fonction Python

• à l'aide d'un plug-in personnalisé

Remarque :Cloud Composer 1 ne permet pas de spécifier de programmation de tables temporelles avec des plug-ins personnalisés. Vous ne pouvez spécifier une table "TimeTable" avec un plug-in personnalisé que dans Cloud Composer 2.

Ressources de cluster limitées

Cette section ne s'applique qu'à Cloud Composer 1.

Vous risquez de rencontrer des problèmes de performances si le cluster GKE de votre environnement est trop petit pour gérer tous vos DAG et tâches. Dans ce cas, essayez l'une des solutions suivantes :

• Créez un environnement avec un type de machine offrant plus de performances et migrez vos DAG vers cet environnement.
• Créez d'autres environnements Cloud Composer et répartissez les DAG sur ces environnements.
• Modifiez le type de machine pour les nœuds GKE, comme décrit dans la section Mettre à niveau le type de machine pour les nœuds GKE. Cette procédure étant sujette aux erreurs, il s'agit de l'option la moins recommandée.
• Mettez à niveau le type de machine de l'instance Cloud SQL qui exécute la base de données Airflow dans votre environnement, par exemple à l'aide des commandes gcloud composer environments update. Les faibles performances de la base de données Airflow peuvent expliquer la lenteur du programmeur.

Éviter la planification des tâches pendant les intervalles de maintenance

Vous pouvez définir des intervalles de maintenance spécifiques pour votre environnement. Au cours de ces périodes, des événements de maintenance pour Cloud SQL et GKE ont lieu.

Forcer le programmeur Airflow à ignorer les fichiers inutiles

Vous pouvez améliorer les performances du programmeur Airflow en ignorant les fichiers inutiles dans le dossier des DAG. Le programmeur Airflow ignore tous les fichiers et dossiers spécifiés dans le fichier .airflowignore.

Pour que le programmeur Airflow ignore les fichiers inutiles, procédez comme suit :

1. Créez un fichier .airflowignore.
2. Dans ce fichier, répertoriez les fichiers et dossiers à ignorer.
3. Importez ce fichier dans le dossier /dags du bucket de votre environnement.

Pour en savoir plus sur le format de fichier .airflowignore, consultez la documentation Airflow.

Le programmeur Airflow traite des DAG interrompus

Les utilisateurs Airflow peuvent interrompre un DAG pour en éviter l'exécution. Cela permet d'économiser les cycles de traitement des nœuds de calcul Airflow.

Cependant, le programmeur Airflow continue d'analyser les DAG interrompus. Si vous souhaitez vraiment améliorer les performances du programmeur Airflow, utilisez .airflowignore ou supprimez les DAG suspendus du dossier des DAG.

Utilisation de "wait_for_downstream" dans vos DAG

Si vous définissez le paramètre wait_for_downstream sur True dans vos DAG, pour qu'une tâche réussisse, toutes les tâches immédiatement en aval de cette tâche doivent également réussir. Cela signifie que l'exécution des tâches d'un DAG donné peut être ralentie par l'exécution des tâches du DAG précédent. Pour en savoir plus, consultez la documentation Airflow.

Les tâches placées en file d'attente trop longtemps seront annulées et replanifiées

Si une tâche Airflow est conservée dans la file d'attente trop longtemps, le programmeur la replanifiera pour exécution (dans les versions d'Airflow antérieures à la version 2.3.1, la tâche est également marquée comme ayant échoué et retentée si elle peut faire l'objet d'une nouvelle tentative).

Pour observer les symptômes de cette situation, vous pouvez examiner le graphique comportant le nombre de tâches en file d'attente (onglet "Surveillance" dans l'interface utilisateur de Cloud Composer). Si les pics de ce graphique ne chutent pas dans un délai de deux heures environ, les tâches seront probablement reprogrammées (sans journaux), suivies des entrées de journal "Les tâches adoptées étaient toujours en attente..." dans les journaux du planificateur. Dans ce cas, le message "Log file is not found..." (Fichier journal introuvable) peut s'afficher dans les journaux des tâches Airflow, car la tâche n'a pas été exécutée.

En général, ce comportement est normal, et l'instance suivante de la tâche planifiée est censée être exécutée conformément à la planification. Si vous observez de nombreux cas de ce type dans vos environnements Cloud Composer, cela peut signifier qu'il n'y a pas assez de nœuds de calcul Airflow dans votre environnement pour traiter toutes les tâches planifiées.

Résolution: Pour résoudre ce problème, vous devez vous assurer que les nœuds de calcul Airflow ont toujours la capacité nécessaire pour exécuter les tâches en file d'attente. Par exemple, vous pouvez augmenter le nombre de nœuds de calcul ou la simultanéité de nœud de calcul. Vous pouvez également ajuster le parallélisme ou les pools pour éviter que des tâches ne soient mises en file d'attente au-delà de votre capacité.

Sporadiquement, des tâches obsolètes peuvent bloquer l'exécution d'un DAG spécifique

Dans des cas normaux, le programmeur Airflow doit être en mesure de gérer les situations dans lesquelles la file d'attente contient des tâches obsolètes et, pour une raison quelconque, il est impossible de les exécuter correctement (par exemple, un DAG auquel appartiennent les tâches obsolètes a été supprimé).

Si ces tâches obsolètes ne sont pas supprimées définitivement par le planificateur, vous devrez peut-être les supprimer manuellement. Vous pouvez le faire, par exemple, dans l'interface utilisateur d'Airflow : accédez à Menu > Navigateur > Instances de tâche, puis recherchez les tâches en file d'attente appartenant à un DAG obsolète et supprimez-les.

Pour résoudre ce problème, mettez à niveau votre environnement vers Cloud Composer version 2.1.12 ou ultérieure.

Approche de Cloud Composer pour le paramètre [scheduler]min_file_process_interval

Cloud Composer modifie la façon dont [scheduler]min_file_process_interval est utilisé par le programmeur Airflow.

Airflow 1

Si Cloud Composer utilise Airflow 1, les utilisateurs peuvent définir la valeur de [scheduler]min_file_process_interval entre 0 et 600 secondes. Les valeurs supérieures à 600 secondes donnent les mêmes résultats que si [scheduler]min_file_process_interval était défini sur 600 secondes.

Remarque :Dans Airflow 1, un intervalle [scheduler]min_file_process_interval plus long peut également augmenter les délais de planification entre les tâches. Cette limitation a été supprimée dans Airflow 2.

Airflow 2

Dans Airflow 2, [scheduler]min_file_process_interval ne peut être utilisé qu'avec les versions 1.19.9 et 2.0.26 (ou versions ultérieures).

• Versions de Cloud Composer antérieures à 1.19.9 et 2.0.26

  Dans ces versions, [scheduler]min_file_process_interval est ignoré.

• Cloud Composer versions 1.19.9 ou 2.0.26, ou versions plus récentes

  Le programmeur Airflow est redémarré après un certain nombre de fois que tous les DAG sont planifiés, et le paramètre [scheduler]num_runs contrôle le nombre de fois où il est exécuté par le programmeur. Lorsque le programmeur atteint les boucles de planification [scheduler]num_runs, il est redémarré. Il est un composant sans état, et un tel redémarrage constitue un mécanisme de réparation automatique pour tout problème que le programmeur pourrait rencontrer. Si aucune valeur n'est spécifiée, la valeur par défaut de [scheduler]num_runs est appliquée, soit 5 000.

  [scheduler]min_file_process_interval peut être utilisé pour configurer la fréquence de l'analyse du DAG, mais ce paramètre ne peut pas dépasser le temps nécessaire à un programmeur pour effectuer des boucles [scheduler]num_runs lors de la planification de vos DAG.

Scaling de la configuration Airflow

Airflow fournit des options de configuration Airflow qui contrôlent le nombre de tâches et de DAG Airflow pouvant être exécutés simultanément. Pour définir ces options de configuration, remplacez leurs valeurs pour votre environnement.

• Simultanéité des nœuds de calcul

  Le paramètre [celery]worker_concurrency contrôle le nombre maximal de tâches qu'un nœud de calcul Airflow peut exécuter en même temps. Si vous multipliez la valeur de ce paramètre par le nombre de nœuds de calcul Airflow dans votre environnement Cloud Composer, vous obtenez le nombre maximal de tâches pouvant être exécutées simultanément dans votre environnement. Ce nombre est limité par l'option de configuration Airflow [core]parallelism, décrite plus loin.

  Dans les environnements Cloud Composer 2, la valeur par défaut de [celery]worker_concurrency est calculée automatiquement

  • Pour les versions Airflow 2.3.3 et ultérieures, [celery]worker_concurrency est défini sur une valeur minimale parmi 32, 12 * worker_CPU et 8 * worker_memory.

  • Pour les versions Airflow 2.2.5 ou antérieures, [celery]worker_concurrency est défini sur 12 x le nombre de processeurs des nœuds de calcul.

• Nombre maximal d'exécutions de DAG actives

  L'option de configuration Airflow [core]max_active_runs_per_dag contrôle le nombre maximal d'exécutions de DAG actives par DAG. Si cette limite est atteinte, le programmeur ne crée pas d'autres exécutions de DAG.

  Une définition incorrecte de ce paramètre peut créer un problème où le programmeur limite l'exécution du DAG, car il ne peut pas créer d'autres instances d'exécution de DAG simultanées.

• Nombre maximal de tâches actives par DAG

  L'option de configuration Airflow [core]max_active_tasks_per_dag contrôle le nombre maximal d'instances de tâche pouvant s'exécuter simultanément dans chaque DAG. Il s'agit d'un paramètre au niveau du DAG.

  Si ce paramètre est défini de manière incorrecte, vous risquez de rencontrer un problème dans lequel l'exécution d'une instance de DAG est ralentie car le nombre de tâches de DAG pouvant être exécutées simultanément est limité.

  Solution: augmentez [core]max_active_tasks_per_dag.

  Remarque :Les versions antérieures d'Airflow utilisaient [core]dag_concurrency au lieu de [core]max_active_tasks_per_dag. Dans Airflow 2, le paramètre [core]dag_concurrency est obsolète.

• Parallélisme et taille du pool

  L'option de configuration Airflow [core]parallelism contrôle le nombre de tâches que le programmeur Airflow peut mettre en file d'attente dans la file d'attente de l'exécuteur une fois que toutes les dépendances pour ces tâches sont satisfaites.

  Il s'agit d'un paramètre global pour l'ensemble de la configuration Airflow.

  Les tâches sont mises en file d'attente et exécutées dans un pool. Les environnements Cloud Composer n'utilisent qu'un seul pool. La taille de ce pool contrôle le nombre de tâches pouvant être mises en file d'attente simultanément par le programmeur. Si la taille du pool est trop faible, le programmeur ne pourra plus mettre de tâches en file d'attente avant même que les seuils (définis par l'option de configuration [core]parallelism et par l'option de configuration [celery]worker_concurrency multipliée par le nombre de nœuds de calcul Airflow) ne soient dépassés.

  Vous pouvez configurer la taille du pool dans l'interface utilisateur Airflow (Menu > Admin > Pools). Ajustez la taille du pool en fonction du niveau de parallélisme attendu dans votre environnement.

  Généralement, [core]parallelism est défini comme un produit du nombre maximal de nœuds de calcul et de la valeur [celery]worker_concurrency.

Les DAG ne sont pas programmés par le programmeur en raison des délais avant expiration du processeur DAG

Pour en savoir plus sur ce problème, consultez la page Dépanner les DAG.

Marquage des tâches comme ayant échoué lorsque vous avez atteint dagrun_timeout

Le programmeur marque les tâches qui ne sont pas terminées (en cours d'exécution, programmées et mises en file d'attente) comme ayant échoué si l'exécution d'un DAG ne se termine pas dans dagrun_timeout (un paramètre du DAG).

Solution :

• Prolongez dagrun_timeout pour respecter le délai d'inactivité.

• (Cloud Composer 2) Augmentez le nombre de nœuds de calcul ou augmentez les paramètres de performances des nœuds de calcul, afin d'accélérer l'exécution du DAG.

Symptômes lorsque la base de données Airflow est soumise à une pression de charge

L'entrée de journal d'avertissement suivante peut parfois s'afficher dans les journaux du programmeur Airflow:

Scheduler heartbeat got an exception: (_mysql_exceptions.OperationalError) (2006, "Lost connection to MySQL server at 'reading initial communication packet', system error: 0")"

Des symptômes similaires peuvent également être observés dans les journaux de nœuds de calcul Airflow:

Pour MySQL:

(_mysql_exceptions.OperationalError) (2006, "Lost connection to MySQL server at
'reading initial communication packet', system error: 0")"

Pour PostgreSQL:

psycopg2.OperationalError: connection to server at ... failed

De tels avertissements ou erreurs peuvent indiquer que la base de données Airflow est submergée par le nombre de connexions ouvertes ou le nombre de requêtes exécutées en même temps, soit par les programmeurs, soit par d'autres composants Airflow tels que les nœuds de calcul, les déclencheurs et les serveurs Web.

Solutions possibles:

• Supprimer les données inutiles de la base de données Airflow

• Augmentez la capacité de la base de données Airflow:

  • (Cloud Composer 1) Modifiez le type de machine de l'instance Cloud SQL qui stocke la base de données Airflow de votre environnement.
  • (Cloud Composer 2) Ajustez la taille de votre environnement.

• Réduisez le nombre de programmeurs. Dans la plupart des cas, un ou deux programmeurs suffisent pour analyser et planifier les tâches Airflow. Il n'est pas recommandé de configurer plus de deux programmeurs, sauf en cas de justification.

• Évitez d'utiliser des variables globales dans les DAG Airflow : variables d'environnement Cloud Composer et variables Airflow.

• Définissez [scheduler]scheduler-heartbeat-sec sur une valeur supérieure, par exemple, sur 15 secondes ou plus.

• Définissez [scheduler]job-heartbeat-sec sur une valeur supérieure, par exemple 30 secondes ou plus.

• Définissez [scheduler]scheduler_health_check_threshold sur une valeur égale à [scheduler]job-heartbeat-sec multipliée par 4.

Remarque :Certains paramètres Airflow ne sont disponibles que dans les versions récentes d'Airflow.

Le serveur Web affiche l'avertissement "Le programmeur ne semble pas être en cours d'exécution"

Le programmeur transmet régulièrement ses pulsations à la base de données Airflow. Sur la base de ces informations, le serveur Web Airflow détermine si le programmeur est actif.

Parfois, si le programmeur est soumis à une charge importante, il peut ne pas pouvoir signaler sa pulsation à chaque [scheduler]scheduler-heartbeat-sec.

Dans ce cas, le serveur Web Airflow peut afficher l'avertissement suivant:

The scheduler does not appear to be running. Last heartbeat was received <X>
seconds ago.

Solutions possibles:

• Augmentez le nombre de processeurs et la mémoire des ressources pour l'ordonnanceur.

• Optimisez vos DAG pour que leur analyse et leur planification soient plus rapides et ne consomment pas trop de ressources du programmeur.

• Évitez d'utiliser des variables globales dans les DAG Airflow : variables d'environnement Cloud Composer et variables Airflow.

• Augmentez la valeur de [scheduler]scheduler-health-check-threshold, afin que le serveur Web attende plus longtemps avant de signaler l'indisponibilité du programmeur.

Solutions pour les problèmes rencontrés lors du remplissage des DAG

Il se peut que vous souhaitiez réexécuter des DAG déjà exécutés. Pour ce faire, utilisez l'outil de ligne de commande Airflow comme suit:

Airflow 1

gcloud composer environments run \
  ENVIRONMENT_NAME \
  --location LOCATION \
  backfill -- -B \
  -s START_DATE \
  -e END_DATE \
  DAG_NAME

Pour réexécuter uniquement les tâches ayant échoué pour un DAG spécifique, utilisez également l'argument --rerun_failed_tasks.

Airflow 2

gcloud composer environments run \
  ENVIRONMENT_NAME \
  --location LOCATION \
   dags backfill -- -B \
   -s START_DATE \
   -e END_DATE \
   DAG_NAME

Pour réexécuter uniquement les tâches ayant échoué pour un DAG spécifique, utilisez également l'argument --rerun-failed-tasks.

Remplacez :

• ENVIRONMENT_NAME par le nom de l'environnement.
• LOCATION par la région dans laquelle se trouve l'environnement.
• START_DATE par une valeur pour le paramètre DAG start_date, au format YYYY-MM-DD ;
• END_DATE par une valeur pour le paramètre DAG end_date, au format YYYY-MM-DD ;
• DAG_NAME par le nom du DAG.

L'opération de remplissage peut parfois générer une situation d'interblocage où un remplissage n'est pas possible en raison du verrouillage d'une tâche. Exemple :

2022-11-08 21:24:18.198 CET DAG ID Task ID Run ID Try number
2022-11-08 21:24:18.201 CET -------- --------- -------- ------------
2022-11-08 21:24:18.202 CET 2022-11-08 21:24:18.203 CET These tasks are deadlocked:
2022-11-08 21:24:18.203 CET DAG ID Task ID Run ID Try number
2022-11-08 21:24:18.204 CET ----------------------- ----------- ----------------------------------- ------------
2022-11-08 21:24:18.204 CET <DAG name> <Task name> backfill__2022-10-27T00:00:00+00:00 1
2022-11-08 21:24:19.249 CET Command exited with return code 1
...
2022-11-08 21:24:19.348 CET Failed to execute job 627927 for task backfill

Dans certains cas, vous pouvez utiliser les solutions de contournement suivantes pour contourner les interblocages:

• Désactivez le mini-Scheduler en remplaçant [core]schedule-after-task-execution par False.

• Exécutez des remplissages pour des plages de dates plus étroites. Par exemple, définissez START_DATE et END_DATE pour spécifier une période d'un seul jour.

Étapes suivantes

• Optimiser votre environnement Cloud Composer 2
• Faire évoluer des environnements