Solução de problemas: operadores DAGs, conexões e outros problemas - Amazon Managed Workflows for Apache Airflow

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas: operadores DAGs, conexões e outros problemas

Os tópicos desta página descrevem resoluções para dependências do Apache Airflow v2 e v3 Python, plug-ins DAGs personalizados, operadores, conexões, tarefas e problemas de servidor web que você pode encontrar em um ambiente Amazon Managed Workflows para Apache Airflow.

Conexões

O tópico a seguir descreve os erros que você pode receber ao usar uma conexão do Apache Airflow ou usar outro banco de dados. AWS

Não consigo me conectar ao Secrets Manager

Recomendamos as seguintes etapas:

  1. Aprenda a criar chaves secretas para sua conexão e variáveis do Apache Airflow em Configurando uma conexão do Apache Airflow usando um segredo AWS Secrets Manager.

  2. Saiba como usar a chave secreta para uma variável do Apache Airflow (test-variable) em Usando uma chave secreta AWS Secrets Manager para uma variável do Apache Airflow.

  3. Saiba como usar a chave secreta para uma conexão Apache Airflow (myconn) em Usando uma chave secreta AWS Secrets Manager para uma conexão do Apache Airflow.

Como configuro as condições do gerenciador de segredos secretsmanager:ResourceTag/<tag-key> ou uma restrição de recursos na minha política de perfil de execução?

nota

Aplica-se ao Apache Airflow versão 2.0 e anterior.

Atualmente, você não pode limitar o acesso aos segredos do Secrets Manager usando chaves de condição ou outras restrições de recursos no perfil de execução do seu ambiente, devido a um problema conhecido no Apache Airflow.

Não consigo me conectar ao Snowflake

Recomendamos as seguintes etapas:

  1. Teste seus DAGs plug-ins personalizados e dependências do Python localmente usando on. aws-mwaa-docker-images GitHub

  2. Adicione as seguintes entradas ao requirements.txt para seu ambiente.

    apache-airflow-providers-snowflake==1.3.0
  3. Adicione as seguintes importações ao seu DAG:

    from airflow.providers.snowflake.operators.snowflake import SnowflakeOperator

Certifique-se de que o objeto de conexão Apache Airflow inclui os seguintes pares de chave-valor:

  1. ID de conexão: snowflake_conn

  2. Tipo de conexão: Snowflake

  3. Host: <my account>.<my region if not us-west-2>.snowflakecomputing.com

  4. Esquema: <my schema>

  5. Login: <my user name>

  6. Senha: ********

  7. Porta: <port, if any>

  8. Extra:

    { "account": "<my account>", "warehouse": "<my warehouse>", "database": "<my database>", "region": "<my region if not using us-west-2 otherwise omit this line>" }

Por exemplo:

>>> import json >>> from airflow.models.connection import Connection >>> myconn = Connection( ... conn_id='snowflake_conn', ... conn_type='Snowflake', ... host='123456789012.us-east-1.snowflakecomputing.com', ... schema='YOUR_SCHEMA' ... login='YOUR_USERNAME', ... password='YOUR_PASSWORD', ... port='YOUR_PORT' ... extra=json.dumps(dict(account='123456789012', warehouse='YOUR_WAREHOUSE', database='YOUR_DB_OPTION', region='us-east-1')), ... )

Não consigo encontrar minha conexão na interface do Airflow

O Apache Airflow fornece modelos de conexão na IU do Apache Airflow. Isto é usado para gerar a string do URI de conexão, independentemente do tipo de conexão. Se um modelo de conexão não estiver disponível na IU do Apache Airflow, um modelo de conexão alternativo poderá ser usado para gerar uma string de URI de conexão, como o uso do modelo de conexão HTTP.

Recomendamos as seguintes etapas:

  1. Acesse os tipos de conexão que o Amazon MWAA fornece na interface de usuário do Apache Airflow em. Pacotes do provedor Apache Airflow instalados em ambientes Amazon MWAA

  2. Acesse os comandos para criar uma conexão Apache Airflow na CLI em. Referência de comandos da CLI do Apache Airflow

  3. Aprenda a usar modelos de conexão na IU do Apache Airflow de forma intercambiável para tipos de conexão que não estão disponíveis na IU do Apache Airflow no Amazon MWAA em Visão geral dos tipos de conexão.

Webserver

O tópico a seguir descreve os erros que você pode receber em seu servidor web Apache Airflow no Amazon MWAA.

Eu recebo um erro 5xx ao acessar o servidor web

Recomendamos as seguintes etapas:

  1. Verifique as opções de configuração do Apache Airflow. Verifique se os pares de valores-chave que você especificou como uma opção de configuração do Apache Airflow, como AWS Secrets Manager, foram configurados corretamente. Para saber mais, consulteNão consigo me conectar ao Secrets Manager.

  2. Verifique requirements.txt. Verifique se o pacote “extras” do Airflow e outras bibliotecas listadas no seu requirements.txt são compatíveis com sua versão do Apache Airflow.

  3. Explore formas de especificar dependências do Python em um requirements.txt arquivo, consulte. Como gerenciar dependências do Python em requirements.txt

Eu recebo um The scheduler does not seem to be running erro

Se o agendador parecer não estar em execução ou se o último “batimento cardíaco” tiver sido recebido há várias horas, você DAGs pode não estar listado no Apache Airflow e novas tarefas não serão agendadas.

Recomendamos as seguintes etapas:

  1. Confirme se seu grupo de segurança da VPC permite acesso de entrada à porta 5432. Essa porta é necessária para se conectar ao banco de dados de metadados PostgreSQL do Amazon Aurora para seu ambiente. Depois que essa regra for adicionada, aguarde alguns minutos para o Amazon MWAA e o erro poderá desaparecer. Para saber mais, consulteSegurança em sua VPC no Amazon MWAA.

    nota
    • O banco de dados Aurora PostgreSQL faz parte da arquitetura de serviços do Amazon MWAA e não está disponível no seu. Conta da AWS

    • Os erros relacionados ao banco de dados geralmente são um sintoma de falha do programador e não a causa raiz.

  2. Se o programador não estiver em execução, pode ser devido a vários fatores, como falhas na instalação de dependências ou um programador sobrecarregado. Confirme se seus DAGs plug-ins e requisitos estão funcionando corretamente acessando os grupos de CloudWatch registros correspondentes em Registros. Para saber mais, consulteMonitoramento e métricas para o Amazon Managed Workflows for Apache Airflow.

Tarefas

O tópico a seguir descreve os erros que você pode receber nas tarefas do Apache Airflow em um ambiente.

Minhas tarefas estão travadas ou não estão sendo concluídas

Se suas tarefas do Apache Airflow estiverem “travadas” ou não estiverem sendo concluídas, recomendamos as seguintes etapas:

  1. Pode haver um grande número de DAGs definidos. Reduza o número DAGs e realize uma atualização do ambiente (como alterar um nível de registro) para forçar uma redefinição.

    1. O Airflow analisa DAGs se eles estão habilitados ou não. Se você estiver usando mais de 50% da capacidade do seu ambiente, poderá começar a sobrecarregar o agendador do Apache Airflow. Isso leva a um grande tempo total de análise nas CloudWatch métricas ou a longos tempos de processamento do DAG nos CloudWatch registros. Há outras maneiras de otimizar as configurações do Apache Airflow que estão fora do escopo deste guia.

    2. Para saber mais sobre as melhores práticas que recomendamos para ajustar o desempenho do seu ambiente, consulteAjuste de desempenho para o Apache Airflow no Amazon MWAA.

  2. Pode haver um grande número de tarefas na fila. Isso geralmente é mostrado como um grande — e crescente — número de tarefas no None estado ou como um grande número em. Queued Tasks and/or Tasks Pending CloudWatch Este erro pode ocorrer pelos seguintes motivos:

    1. Se houver mais tarefas a serem executadas do que o ambiente tem a capacidade de executar, and/or um grande número de tarefas que estavam na fila antes do escalonamento automático tem tempo para detectá-las e implantar trabalhadores adicionais.

    2. Se houver mais tarefas para executar do que um ambiente tem a capacidade de executar, recomendamos reduzir o número de tarefas que você DAGs executa simultaneamente, and/or aumentando o número mínimo de trabalhadores do Apache Airflow.

    3. Se houver um grande número de tarefas que foram colocadas em fila antes que o escalonamento automático tivesse tempo de detectar e implantar trabalhadores adicionais, recomendamos escalonar a implantação de tarefas, aumentando o número and/or mínimo de trabalhadores do Apache Airflow.

    4. Você pode usar o comando update-environment no AWS Command Line Interface (AWS CLI) para alterar o número mínimo ou máximo de trabalhadores que são executados em seu ambiente.

      aws mwaa update-environment --name MyEnvironmentName --min-workers 2 --max-workers 10
    5. Para saber mais sobre as melhores práticas que recomendamos para ajustar o desempenho do seu ambiente, consulteAjuste de desempenho para o Apache Airflow no Amazon MWAA.

  3. Se suas tarefas estiverem travadas no estado “em execução”, você também poderá limpá-las ou marcá-las como bem-sucedidas ou malsucedidas. Isso permite que o componente de ajuste de escala automático do seu ambiente reduza a escala verticalmente do número de operadores em execução no seu ambiente. A imagem a seguir mostra um exemplo de uma tarefa ociosa.

    Esta é uma imagem com uma tarefa perdida.
    1. Escolha o círculo para a tarefa perdida e selecione Limpar (conforme mostrado). Isso permite que o Amazon MWAA reduza os trabalhadores; caso contrário, o Amazon MWAA não pode determinar quais DAGs estão ativados ou desativados e não pode reduzir a escala se ainda houver tarefas na fila.

      Ações do Apache Airflow
  4. Saiba mais sobre o ciclo de vida das tarefas do Apache Airflow em Conceitos no Guia de referência do Apache Airflow.

Eu recebo falhas de tarefas sem registros no Airflow v3

Se suas tarefas do Apache Airflow 3 estiverem falhando sem registros, siga estas etapas:

  • Se os registros do trabalhador apresentarem um erro, como no momento Task handler raised error: WorkerLostError('Worker exited prematurely: exitcode 15 Job: 12.') em que a tarefa falhou, isso indica que o processo de trabalho bifurcado atribuído à tarefa provavelmente foi encerrado inesperadamente.

    Para resolver isso, considere configurar celery.worker_autoscale com os mesmos valores mínimo e máximo. Por exemplo:

    celery.worker_autoscale=5,5 # for mw1.small celery.worker_autoscale=10,10 # for mw1.medium celery.worker_autoscale=20,20 # for mw1.large

    Isso garante que o tamanho do pool de trabalhadores permaneça fixo, evitando demissões inesperadas de trabalhadores.

CLI

O tópico a seguir descreve os erros que você pode receber ao executar comandos da CLI do Airflow no. AWS Command Line Interface

Eu recebo um erro '503' ao acionar um DAG na CLI

A CLI do Airflow é executada no servidor web Apache Airflow, que tem simultaneidade limitada. Normalmente, no máximo 4 comandos da CLI podem ser executados simultaneamente.

Por que o comando da CLI dags backfill do Apache Airflow falha? Existe uma solução alternativa?

nota

O seguinte se aplica somente aos ambientes Apache Airflow v2.0.2.

O backfill comando, como outros comandos da CLI do Apache Airflow, analisa DAGs tudo localmente antes de DAGs qualquer um ser processado, independentemente do DAG ao qual a operação da CLI se aplica. Em ambientes Amazon MWAA usando o Apache Airflow v2.0.2, como os plug-ins e os requisitos ainda não estão instalados no servidor web no momento em que o comando CLI é executado, a operação de análise falha e a operação não é invocada. backfill Se você não tivesse nenhum requisito nem plug-ins em seu ambiente, a operação backfill seria bem-sucedida.

Para poder executar o comando da CLI backfill, recomendamos invocá-lo em um operador bash. Em um operador bash, backfill é iniciado pelo trabalhador, permitindo que ele analise com sucesso, pois todos os requisitos e plug-ins necessários estão disponíveis e instalados. DAGs Use o exemplo a seguir para criar um DAG com um BashOperator para executarbackfill.

from airflow import DAG from airflow.operators.bash_operator import BashOperator from airflow.utils.dates import days_ago with DAG(dag_id="backfill_dag", schedule_interval=None, catchup=False, start_date=days_ago(1)) as dag: cli_command = BashOperator( task_id="bash_command", bash_command="airflow dags backfill my_dag_id" )

Operadores

O tópico a seguir descreve os erros que você pode receber ao usar Operadores.

Recebi um erro PermissionError: [Errno 13] Permission denied ao usar o operador S3Transform

Recomendamos as etapas a seguir se você estiver tentando executar um script de shell com o operador S3Transform e estiver recebendo um erro PermissionError: [Errno 13] Permission denied. As etapas a seguir pressupõem que você tenha um arquivo plugins.zip existente. Se você estiver criando um novo plugins.zip, consulteComo instalar plug-ins personalizados.

  1. Teste seus DAGs plug-ins personalizados e dependências do Python localmente usando on. aws-mwaa-docker-images GitHub

  2. Crie seu script de “transform” (transformação).

    #!/bin/bash cp $1 $2
  3. (opcional) Talvez os usuários de macOS e Linux precisem executar o comando a seguir para garantir que o script seja executável.

    chmod 777 transform_test.sh
  4. Adicione o script ao seu arquivo plugins.zip.

    zip plugins.zip transform_test.sh
  5. Siga as etapas em Carregar o plugins.zip para o Amazon S3.

  6. Siga as etapas em Especificação da versão do plugins.zip no console do Amazon MWAA.

  7. Crie o seguinte DAG.

    from airflow import DAG from airflow.providers.amazon.aws.operators.s3_file_transform import S3FileTransformOperator from airflow.utils.dates import days_ago import os DAG_ID = os.path.basename(__file__).replace(".py", "") with DAG (dag_id=DAG_ID, schedule_interval=None, catchup=False, start_date=days_ago(1)) as dag: file_transform = S3FileTransformOperator( task_id='file_transform', transform_script='/usr/local/airflow/plugins/transform_test.sh', source_s3_key='s3://amzn-s3-demo-bucket/files/input.txt', dest_s3_key='s3://amzn-s3-demo-bucket/files/output.txt' )
  8. Siga as etapas em Como fazer upload do código DAG para o Amazon S3.