

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á.

# Métricas do ambiente Apache Airflow em CloudWatch
<a name="access-metrics-cw"></a>

O Apache Airflow v2 e v3 já estão configurados para coletar e enviar métricas do [StatsD](https://github.com/etsy/statsd) para um ambiente Amazon Managed Workflows for Apache Airflow para a Amazon. CloudWatch A lista completa de métricas que o Apache Airflow envia está disponível na página [Métricas](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html) em *Guia de referência do Apache Airflow*. Esta página descreve as métricas do Apache Airflow disponíveis CloudWatch no console e como acessá-las. CloudWatch 

**Contents**
+ [Termos](#access-metrics-cw-terms)
+ [Dimensões](#metrics-dimensions)
+ [Acessando métricas no CloudWatch console](#access-metrics-cw-console)
+ [Métricas do Apache Airflow disponíveis em CloudWatch](#available-metrics-cw)
  + [Contadores do Apache Airflow](#counters-metrics)
  + [Medidores do Apache Airflow](#gauges-metrics)
  + [Temporizadores do Apache Airflow](#timers-metrics)
+ [Como escolher quais métricas são relatadas](#choosing-metrics)
+ [Próximas etapas](#mwaa-metrics202-next-up)

## Termos
<a name="access-metrics-cw-terms"></a>

**Namespace**  
Um namespace é um contêiner para as CloudWatch métricas de um AWS serviço. Para o Amazon MWAA, o namespace é *AmazonMWAA*.

**CloudWatch métricas**  
Uma CloudWatch métrica representa um conjunto ordenado por tempo de pontos de dados específicos de CloudWatch.

**Métricas do Apache Airflow**  
As [métricas](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html ) específicas do Apache Airflow.

**Dimensão**  
Uma dimensão é um name/value par que faz parte da identidade de uma métrica.

**Unidade**  
Uma estatística tem uma unidade de medida. Para o Amazon MWAA, as unidades incluem *Contagem*, *Segundos* e *Milissegundos*. Para o Amazon MWAA, as unidades são definidas com base nas unidades nas métricas originais do Airflow.

## Dimensões
<a name="metrics-dimensions"></a>

Esta seção descreve o agrupamento de CloudWatch *dimensões* para métricas do Apache Airflow em. CloudWatch


| Dimensão | Description | 
| --- | --- | 
| DAG | Indica um nome específico de DAG do Apache Airflow. | 
| Nome do arquivo DAG | Indica um nome de arquivo específico de DAG do Apache Airflow. | 
| Função | Essa dimensão é usada para melhorar o agrupamento de métricas em CloudWatch. | 
| Trabalho | Indica um trabalho do Apache Airflow executado pelo agendador. Sempre tem o valor de `Job`. | 
| Operador | Indica um operador específico do Apache Airflow. | 
| Grupo | Indica um grupo de operadores específico do Apache Airflow. | 
| Tarefa | Indica uma tarefa específica do Apache Airflow. | 
| HostName | Indica o nome do host de um processo específico do Apache Airflow em execução. | 

## Acessando métricas no CloudWatch console
<a name="access-metrics-cw-console"></a>

Esta seção descreve como acessar as métricas de desempenho CloudWatch de um DAG específico.

**Para acessar as métricas de desempenho para uma dimensão**

1. Abra a [página Métricas](https://console.aws.amazon.com/cloudwatch/home#metricsV2:graph=~()) no CloudWatch console.

1. Selecione seu Região da AWS.

1. Escolha o namespace **AmazonMWAA**.

1. Na guia **Todas as métricas**, selecione uma dimensão. Por exemplo, *DAG, Ambiente*.

1. Escolha uma CloudWatch métrica para uma dimensão. Por exemplo, *TaskInstanceSuccesses* ou *TaskInstanceDuration*. Escolha **Representar graficamente todos os resultados da pesquisa**.

1. Escolha a guia **Métricas representadas graficamente** para acessar estatísticas de desempenho das métricas do Apache Airflow, como *DAG, Ambiente, Tarefa*.

## Métricas do Apache Airflow disponíveis em CloudWatch
<a name="available-metrics-cw"></a>

Esta seção descreve as métricas e dimensões do Apache Airflow enviadas para. CloudWatch

### Contadores do Apache Airflow
<a name="counters-metrics"></a>

As métricas do Apache Airflow nesta seção contêm dados sobre os [*Contadores* do Apache Airflow](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#counters).


| CloudWatch métrica | Métrica do Apache Airflow | Unidade | Dimensão | 
| --- | --- | --- | --- | 
| SLAMissed Disponível somente para Apache Airflow v2.4.3 a v2.10.3.  | sla\_missed | Contagem | Função, Agendador | 
| Falhou SLACallback Disponível somente para Apache Airflow v2.4.3 a v2.10.3.  | sla\_callback\_notification\_failure | Contagem | Função, Agendador | 
| Atualizações Disponível para Apache Airflow v2.6.3 e versões posteriores.  | dataset.updates | Contagem | Função, Agendador | 
| Orphaned Disponível para Apache Airflow v2.6.3 e versões posteriores.  | dataset.orphaned | Contagem | Função, Agendador | 
| FailedCeleryTaskExecution Disponível para Apache Airflow v2.4.3 e versões posteriores.  | celery.execute\_command.failure | Contagem | Função, Celery | 
| FilePathQueueUpdateCount Disponível para Apache Airflow v2.6.3 e versões posteriores.  | dag\_processing.file\_path\_queue\_update\_count | Contagem | Função, Agendador | 
| CriticalSectionBusy | scheduler.critical\_section\_busy | Contagem | Função, Agendador | 
| DagBagSize | dagbag\_size | Contagem | Função, Processamento de DAG | 
| DagCallbackExceptions | dag.callback\_exceptions | Contagem | DAG, Todos | 
| SLAEmailTentativas fracassadas Não disponível para Apache Airflow v3.0.6 e versões posteriores.  | sla\_email\_notification\_failure | Contagem | Função, Agendador | 
| TaskInstanceFinished | ti.finish.{dag\_id}.{task\_id}.{state} | Contagem | DAG, {dag\_id}<br />Tarefa, {task\_id}<br />Estado, {state} | 
| JobEnd | {job\_name}\_end | Contagem | Trabalho, {job\_name} | 
| JobHeartbeatFailure | {job\_name}\_heartbeat\_failure | Contagem | Trabalho, {job\_name} | 
| JobStart | {job\_name}\_start | Contagem | Trabalho, {job\_name} | 
| ManagerStalls | dag\_processing.manager\_stalls | Contagem | Função, Processamento de DAG | 
| OperatorFailures | operator\_failures\_{operator\_name} | Contagem | Operador, {operator\_name} | 
| OperatorSuccesses | operator\_successes\_{operator\_name} | Contagem | Operador, {operator\_name} | 
| OtherCallbackCount Disponível no Apache Airflow v2.6.3 e versões posteriores.  | dag\_processing.other\_callback\_count | Contagem | Função, Agendador | 
| Processos | dag\_processing.processes | Contagem | Função, Processamento de DAG | 
| SchedulerHeartbeat | scheduler\_heartbeat | Contagem | Função, Agendador | 
| StartedTaskInstances | ti.start.{dag\_id}.{task\_id} | Contagem | DAG, Todos<br />Tarefa, Todos | 
| SlaCallbackCount | dag\_processing.sla\_callback\_count Disponível para Apache Airflow v2.6.3 e versões posteriores.  | Contagem | Função, Agendador | 
| TasksKilledExternally | scheduler.tasks.killed\_externally | Contagem | Função, Agendador | 
| TaskTimeoutError | celery.task\_timeout\_error | Contagem | Função, Celery | 
| TaskInstanceCreatedUsingOperator | task\_instance\_created-{operator\_name} | Contagem | Operador, {operator\_name} | 
| TaskInstancePreviouslySucceeded | previously\_succeeded | Contagem | DAG, Todos<br />Tarefa, Todos | 
| TaskInstanceFailures | ti\_failures | Contagem | DAG, Todos<br />Tarefa, Todos | 
| TaskInstanceSuccesses | ti\_successes | Contagem | DAG, Todos<br />Tarefa, Todos | 
| TaskRemovedFromDAG | task\_removed\_from\_dag.{dag\_id} | Contagem | DAG, {dag\_id} | 
| TaskRestoredToDAG | task\_restored\_to\_dag.{dag\_id} | Contagem | DAG, {dag\_id} | 
| TriggersSucceeded Disponível para Apache Airflow v2.7.2 e versões posteriores.  | triggers.succeeded | Contagem | Função, Trigger | 
| TriggersFailed Disponível para Apache Airflow v2.7.2 e versões posteriores.  | triggers.failed | Contagem | Função, Trigger | 
| TriggersBlockedMainThread Disponível para Apache Airflow v2.7.2 e versões posteriores.  | triggers.blocked\_main\_thread | Contagem | Função, Trigger | 
| TriggerHeartbeat Disponível para Apache Airflow v2.8.1 e versões posteriores.  | triggerer\_heartbeat | Contagem | Função, acionador | 
| TaskInstanceCreatedUsingOperator | airflow.task\_instance\_created\_`{operator_name}` Disponível para Apache Airflow v2.7.2 e versões posteriores.  | Contagem | Operador, `{operator_name}` | 
| ZombiesKilled | zombies\_killed | Contagem | DAG, Todos<br />Tarefa, Todos | 

### Medidores do Apache Airflow
<a name="gauges-metrics"></a>

As métricas do Apache Airflow nesta seção contêm dados sobre os [*Medidores* do Apache Airflow](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#gauges).


| CloudWatch métrica | Métrica do Apache Airflow | Unidade | Dimensão | 
| --- | --- | --- | --- | 
| DAGFileRefreshError | dag\_file\_refresh\_error | Contagem | Função, Processamento de DAG | 
| ImportErrors | dag\_processing.import\_errors | Contagem | Função, Processamento de DAG | 
| ExceptionFailures | smart\_sensor\_operator.exception\_failures | Contagem | Função, Operador de sensor inteligente | 
| ExecutedTasks | smart\_sensor\_operator.executed\_tasks | Contagem | Função, Operador de sensor inteligente | 
| InfraFailures | smart\_sensor\_operator.infra\_failures | Contagem | Função, Operador de sensor inteligente | 
| LoadedTasks | smart\_sensor\_operator.loaded\_tasks | Contagem | Função, Operador de sensor inteligente | 
| TotalParseTime | dag\_processing.total\_parse\_time | Segundos | Função, Processamento de DAG | 
| TriggeredDagRuns Disponível no Apache Airflow v2.6.3 e versões posteriores.  | dataset.triggered\_dagruns | Contagem | Função, Agendador | 
| TriggersRunning Disponível no Apache Airflow v2.7.2 e versões posteriores.  | aciona. Em execução. {{{hostname}}} | Contagem | Função, Trigger<br />HostName, {{{hostname}}} | 
| PoolDeferredSlots Disponível no Apache Airflow v2.7.2 e versões posteriores.  | pool.deferred\_slots.`{pool_name}` | Contagem | Pool, {pool\_name} | 
| DAGFileProcessingLastRunSecondsAgo | dag\_processing.last\_run.seconds\_ago.{dag\_filename} | Segundos | Nome do arquivo DAG, {dag\_filename} | 
| OpenSlots | executor.open\_slots | Contagem | Função, Executor | 
| OrphanedTasksAdopted | scheduler.orphaned\_tasks.adopted | Contagem | Função, Agendador | 
| OrphanedTasksCleared | scheduler.orphaned\_tasks.cleared | Contagem | Função, Agendador | 
| PokedExceptions | smart\_sensor\_operator.poked\_exception | Contagem | Função, Operador de sensor inteligente | 
| PokedSuccess | smart\_sensor\_operator.poked\_success | Contagem | Função, Operador de sensor inteligente | 
| PokedTasks | smart\_sensor\_operator.poked\_tasks | Contagem | Função, Operador de sensor inteligente | 
| PoolFailures | pool.open\_slots.{pool\_name} | Contagem | Pool, {pool\_name} | 
| PoolStarvingTasks | pool.starving\_tasks.{pool\_name} | Contagem | Pool, {pool\_name} | 
| PoolOpenSlots | pool.open\_slots.{pool\_name} | Contagem | Pool, {pool\_name} | 
| PoolQueuedSlots | pool.queued\_slots.{pool\_name} | Contagem | Pool, {pool\_name} | 
| PoolRunningSlots | pool.running\_slots.{pool\_name} | Contagem | Pool, {pool\_name} | 
| ProcessorTimeouts | dag\_processing.processor\_timeouts | Contagem | Função, Processamento de DAG | 
| QueuedTasks | executor.queued\_tasks | Contagem | Função, Executor | 
| RunningTasks | executor.running\_tasks | Contagem | Função, Executor | 
| TasksExecutable | scheduler.tasks.executable | Contagem | Função, Agendador | 
| TasksPending Não se aplica ao Apache Airflow v2.2 e versões posteriores.  | scheduler.tasks.pending | Contagem | Função, Agendador | 
| TasksRunning | scheduler.tasks.running | Contagem | Função, Agendador | 
| TasksStarving | scheduler.tasks.starving | Contagem | Função, Agendador | 
| TasksWithoutDagRun | scheduler.tasks.without\_dagrun | Contagem | Função, Agendador | 
| DAGFileProcessingLastNumOfDbQueries Disponível no Apache Airflow v2.10.1 e versões posteriores.  | dag\_processing.last\_num\_of\_db\_queries.{dag\_filename} | Contagem | Nome do arquivo DAG, {dag\_filename} | 
| PoolScheduledSlots Disponível no Apache Airflow v2.10.1 e versões posteriores.  | pool.scheduled\_slots.{pool\_name} | Contagem | Pool, {pool\_name} | 
| TaskCpuUsage Disponível no Apache Airflow v2.10.1 e versões posteriores.  | cpu.usage.{dag\_id}.{task\_id} | Percentual | DAG, {dag\_id}<br />Tarefa, {task\_id} | 
| TaskMemoryUsage Disponível no Apache Airflow v2.10.1 e versões posteriores.  | mem.usage.{dag\_id}.{task\_id} | Percentual | DAG, {dag\_id}<br />Tarefa, {task\_id} | 

### Temporizadores do Apache Airflow
<a name="timers-metrics"></a>

As métricas do Apache Airflow nesta seção contêm dados sobre os [*temporizadores* do Apache Airflow](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#timers).


| CloudWatch métrica | Métrica do Apache Airflow | Unidade | Dimensão | 
| --- | --- | --- | --- | 
| Colete DBDags | collect\_db\_dags | Milissegundos | Função, Processamento de DAG | 
| CriticalSectionDuration | scheduler.critical\_section\_duration | Milissegundos | Função, Agendador | 
| CriticalSectionQueryDuration Disponível para Apache Airflow v2.5.1 e versões posteriores.  | scheduler.critical\_section\_query\_duration | Milissegundos | Função, Agendador | 
| DAGDependencyVerifique | dagrun.dependency-check.{dag\_id} | Milissegundos | DAG, {dag\_id} | 
| DAGDurationFalhou | dagrun.duration.failed.{dag\_id} | Milissegundos | DAG, {dag\_id} | 
| DAGDurationSucesso | dagrun.duration.success.{dag\_id} | Milissegundos | DAG, {dag\_id} | 
| DAGFileProcessingLastDuration | dag\_processing.last\_duration.{dag\_filename} | Segundos | Nome do arquivo DAG, {dag\_filename} | 
| DAGScheduleAtraso | dagrun.schedule\_delay.{dag\_id} | Milissegundos | DAG, {dag\_id} | 
| FirstTaskSchedulingDelay | dagrun.{dag\_id}.first\_task\_scheduling\_delay | Milissegundos | DAG, {dag\_id} | 
| SchedulerLoopDuration Disponível para Apache Airflow v2.5.1 e versões posteriores.  | scheduler.scheduler\_loop\_duration | Milissegundos | Função, Agendador | 
| TaskInstanceDuration | dag.{dag\_id}.{task\_id}.duration | Milissegundos | DAG, {dag\_id}<br />Tarefa, {task\_id} | 
| TaskInstanceQueuedDuration | dag.`{dag_id}`.`{task_id}`.queued\_duration Disponível para Apache Airflow v2.7.2 e versões posteriores.  | Milissegundos | DAG, {dag\_id}<br />Tarefa, {task\_id} | 
| TaskInstanceScheduledDuration Disponível para Apache Airflow v2.7.2 e versões posteriores.  | dag.`{dag_id}`.`{task_id}`.scheduled\_duration | Milissegundos | DAG, {dag\_id}<br />Tarefa, {task\_id} | 

## Como escolher quais métricas são relatadas
<a name="choosing-metrics"></a>

[Você pode escolher quais métricas do Apache Airflow são emitidas ou bloqueadas CloudWatch pelo Apache Airflow usando as seguintes opções de configuração do Amazon MWAA:](configuring-env-variables.md)
+ **`metrics.metrics_allow_list`**— Uma lista de prefixos separados por vírgula que você pode usar para selecionar quais métricas são emitidas pelo seu CloudWatch ambiente. Use essa opção se quiser que o Apache Airflow não envie todas as métricas disponíveis e, em vez disso, selecione um subconjunto de elementos. Por exemplo, .`scheduler,executor,dagrun`
+ **`metrics.metrics_block_list`**: uma lista de prefixos separados por vírgula para filtrar as métricas que começam com os elementos da lista. Por exemplo, .`scheduler,executor,dagrun`

Se você configurar `metrics.metrics_allow_list` e`metrics.metrics_block_list`, o Apache Airflow ignorará `metrics.metrics_block_list`. Se você configura `metrics.metrics_block_list`, mas não `metrics.metrics_allow_list`, o Apache Airflow filtra os elementos que você especifica em `metrics.metrics_block_list`.

**nota**  
As opções de configuração `metrics.metrics_allow_list` e `metrics.metrics_block_list` se aplicam somente ao Apache Airflow v2.6.3 e versões posteriores. Para a versão anterior do Apache Airflow, use `metrics.statsd_allow_list` e `metrics.statsd_block_list`.

## Próximas etapas
<a name="mwaa-metrics202-next-up"></a>
+ Explore a operação da API Amazon MWAA usada para publicar métricas de integridade do ambiente em. [PublishMetrics](https://docs.aws.amazon.com/mwaa/latest/API/API_PublishMetrics.html)