翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CloudWatch の Apache Airflow 環境メトリクス
<a name="access-metrics-cw"></a>

Apache Airflow v2 および v3 は、Amazon Managed Workflows for Apache Airflow 環境の [StatsD](https://github.com/etsy/statsd) メトリクスを収集して Amazon CloudWatch に送信するようにすでに設定されています。Apache Airflow が送信するメトリクスの全リストは、*Apache Airflow リファレンスガイド* の [メトリクス](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html) ページにあります。このページでは、CloudWatch で使用できる Apache Airflow メトリクスと、CloudWatch コンソールでメトリクスにアクセスする方法について説明します。

**Contents**
+ [

## 用語
](#access-metrics-cw-terms)
+ [

## ディメンション
](#metrics-dimensions)
+ [

## CloudWatch コンソールのメトリクスにアクセスする
](#access-metrics-cw-console)
+ [

## CloudWatch で利用可能な Apache Airflow メトリクス
](#available-metrics-cw)
  + [

### Apache Airflow カウンター
](#counters-metrics)
  + [

### Apache Airflow Gauges
](#gauges-metrics)
  + [

### Apache Airflow Timers
](#timers-metrics)
+ [

## どのメトリクスを報告するかを選択する
](#choosing-metrics)
+ [

## 次のステップ
](#mwaa-metrics202-next-up)

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

**名前空間**  
名前空間は、 AWS サービスの CloudWatch メトリクスのコンテナです。*Amazon MWAA* の場合、名前空間は AmazonMWAA です。

**CloudWatch メトリクス**  
CloudWatch メトリクスは、CloudWatch に特異的な時系列のデータポイントのセットを表します。

**Apache Airflow メトリクス**  
Apache Airflow 固有の [メトリクス](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html )。

**ディメンション**  
ディメンションは、メトリクスのアイデンティティの一部である名前と値のペアです。

**Unit**  
1 つの統計には、測定単位があります。Amazon MWAA の単位には、*カウント*、*秒*、*ミリ秒* が含まれます。Amazon MWAA の場合、単位は元の Airflow メトリクスの単位に基づいて設定されます。

## ディメンション
<a name="metrics-dimensions"></a>

このセクションでは、CloudWatch の Apache Airflow メトリクスの CloudWatch *ディメンション* グループについて説明します。


| ディメンション | 説明 | 
| --- | --- | 
|  DAG  |  特定の Apache Airflow DAG 名を示します。  | 
|  DAG ファイル名  |  特定の Apache Airflow DAG ファイル名を示します。  | 
|  関数  |  このディメンションは、CloudWatch のメトリクスのグループ化を改善するために使用されます。  | 
|  ジョブ  |  スケジューラーによって実行される Apache Airflow ジョブを示します。常に `Job` という価値があります。  | 
|  オペレーター  |  特定の Apache Airflow オペレーターを示します。  | 
|  プール  |  特定の Apache Airflow ワーカープールを示します。  | 
|  タスク  |  特定の Apache Airflow タスクを示します。  | 
|  HostName  |  実行中の特定の Apache Airflow プロセスのホスト名を示します。  | 

## CloudWatch コンソールのメトリクスにアクセスする
<a name="access-metrics-cw-console"></a>

このセクションでは、特定の DAG の CloudWatch のパフォーマンスメトリクスにアクセスする方法について説明します。

**ディメンションのパフォーマンスメトリクスにアクセスするには**

1. CloudWatch コンソールで [メトリクスのページ](https://console.aws.amazon.com/cloudwatch/home#metricsV2:graph=~()) を開きます。

1. を選択します AWS リージョン。

1. **AmazonMWAA** の名前空間を選択します。

1. **すべてのメトリクス** タブでディメンションを選択します。例えば、*DAG や環境* などです。

1. ディメンションの CloudWatch メトリクスを選択します。例えば、*TaskInstanceSuccesses* や *TaskInstanceDuration* などです。**すべての検索結果をグラフ化** を選択します。

1. **グラフ化されたメトリクス** タブを選択すると、*DAG、環境、タスク* などの Apache Airflow メトリクスのパフォーマンス統計にアクセスできます。

## CloudWatch で利用可能な Apache Airflow メトリクス
<a name="available-metrics-cw"></a>

このセクションでは、CloudWatch に送信される Apache Airflow のメトリクスとディメンションについて説明します。

### Apache Airflow カウンター
<a name="counters-metrics"></a>

このセクションの Apache Airflow メトリクスには、[Apache Airflow *カウンター*](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#counters) に関するデータが含まれています。


| [CloudWatch メトリクス] | Apache Airflow メトリクス | Unit | ディメンション | 
| --- | --- | --- | --- | 
|  SLAMissed  Apache Airflow v2.4.3 から v2.10.3 でのみ使用できます。   |  sla\$1missed  |  カウント  |  関数、スケジュール  | 
|  FailedSLACallback  Apache Airflow v2.4.3 から v2.10.3 でのみ使用できます。   |  sla\$1callback\$1notification\$1failure  |  カウント  |  関数、スケジュール  | 
|  更新  Apache Airflow v2.6.3 以降で利用可能です。   |  dataset.updates  |  カウント  |  関数、スケジュール  | 
|  Orphaned  Apache Airflow v2.6.3 以降で利用可能です。   |  dataset.orphaned  |  カウント  |  関数、スケジュール  | 
|  FailedCeleryTaskExecution  Apache Airflow v2.4.3 以降で利用可能です。   |  celery.execute\$1command.failure  |  カウント  |  関数、Celery  | 
|  FilePathQueueUpdateCount  Apache Airflow v2.6.3 以降で利用可能です。   |  dag\$1processing.file\$1path\$1queue\$1update\$1count  |  カウント  |  関数、スケジュール  | 
|  CriticalSectionBusy  |  scheduler.critical\$1section\$1busy  |  カウント  |  関数、スケジュール  | 
|  DagBagSize  |  dagbag\$1size  |  カウント  |  関数、DAG 処理  | 
|  DagCallbackExceptions  |  dag.callback\$1exceptions  |  カウント  |  DAG、すべて  | 
|  FailedSLAEmailAttempts  Apache Airflow v3.0.6 以降で利用可能です。   |  sla\$1email\$1notification\$1failure  |  カウント  |  関数、スケジュール  | 
|  TaskInstanceFinished  |  ti.finish.\$1dag\$1id\$1.\$1task\$1id\$1.\$1state\$1  |  カウント  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1 State, \$1state\$1  | 
|  JobEnd  |  \$1job\$1name\$1\$1end  |  カウント  |  Job, \$1job\$1name\$1  | 
|  JobHeartbeatFailure  |  \$1job\$1name\$1\$1heartbeat\$1failure  |  カウント  |  Job, \$1job\$1name\$1  | 
|  JobStart  |  \$1job\$1name\$1\$1start  |  カウント  |  Job, \$1job\$1name\$1  | 
|  ManagerStalls  |  dag\$1processing.manager\$1stalls  |  カウント  |  関数、DAG 処理  | 
|  OperatorFailures  |  operator\$1failures\$1\$1operator\$1name\$1  |  カウント  |  Operator, \$1operator\$1name\$1  | 
|  OperatorSuccesses  |  operator\$1successes\$1\$1operator\$1name\$1  |  カウント  |  Operator, \$1operator\$1name\$1  | 
|  OtherCallbackCount  Apache Airflow v2.6.3 以降で利用可能です。   |  dag\$1processing.other\$1callback\$1count  |  カウント  |  関数、スケジュール  | 
|  プロセス  |  dag\$1processing.processes  |  カウント  |  関数、DAG 処理  | 
|  SchedulerHeartbeat  |  scheduler\$1heartbeat  |  カウント  |  関数、スケジュール  | 
|  StartedTaskInstances  |  ti.start.\$1dag\$1id\$1.\$1task\$1id\$1  |  カウント  |  DAG、すべて タスク、すべて  | 
|  SlaCallbackCount  |  dag\$1processing.sla\$1callback\$1count  Apache Airflow v2.6.3 以降で利用可能です。   |  カウント  |  関数、スケジュール  | 
|  TasksKilledExternally  |  scheduler.tasks.killed\$1externally  |  カウント  |  関数、スケジュール  | 
|  TaskTimeoutError  |  celery.task\$1timeout\$1error  |  カウント  |  関数、Celery  | 
|  TaskInstanceCreatedUsingOperator  |  task\$1instance\$1created-\$1operator\$1name\$1  |  カウント  |  Operator, \$1operator\$1name\$1  | 
|  TaskInstancePreviouslySucceeded  |  previously\$1succeeded  |  カウント  |  DAG、すべて タスク、すべて  | 
|  TaskInstanceFailures  |  ti\$1failure  |  カウント  |  DAG、すべて タスク、すべて  | 
|  TaskInstanceSuccesses  |  ti\$1success  |  カウント  |  DAG、すべて タスク、すべて  | 
|  TaskRemovedFromDAG  |  task\$1removed\$1from\$1dag.\$1dag\$1id\$1  |  カウント  |  DAG, \$1dag\$1id\$1  | 
|  TaskRestoredToDAG  |  task\$1restored\$1to\$1dag.\$1dag\$1id\$1  |  カウント  |  DAG, \$1dag\$1id\$1  | 
|  TriggersSucceeded  Apache Airflow v2.7.2 以降で利用可能です。   |  triggers.succeeded  |  カウント  |  関数、トリガー  | 
|  TriggersFailed  Apache Airflow v2.7.2 以降で利用可能です。   |  triggers.failed  |  カウント  |  関数、トリガー  | 
|  TriggersBlockedMainThread  Apache Airflow v2.7.2 以降で利用可能です。   |  triggers.blocked\$1main\$1thread  |  カウント  |  関数、トリガー  | 
|  TriggerHeartbeat  Apache Airflow v2.8.1 以降で利用可能です。   |  triggerer\$1heartbeat  |  カウント  |  関数、トリガー  | 
|  TaskInstanceCreatedUsingOperator  |  airflow.task\$1instance\$1created\$1`{operator_name}`  Apache Airflow v2.7.2 以降で利用可能です。   |  カウント  |  演算子、`{operator_name}`  | 
|  ZombiesKilled  |  zombies\$1killed  |  カウント  |  DAG、すべて タスク、すべて  | 

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

このセクションの Apache Airflow メトリクスには、[Apache Airflow *ゲージ*](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#gauges) に関するデータが含まれています。


| [CloudWatch メトリクス] | Apache Airflow メトリクス | Unit | ディメンション | 
| --- | --- | --- | --- | 
|  DAGFileRefreshError  |  dag\$1file\$1refresh\$1error  |  カウント  |  関数、DAG 処理  | 
|  ImportErrors  |  dag\$1processing.import\$1errors  |  カウント  |  関数、DAG 処理  | 
|  ExceptionFailures  |  smart\$1sensor\$1operator.exception\$1failures  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  ExecutedTasks  |  smart\$1sensor\$1operator.executed\$1tasks  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  InfraFailures  |  smart\$1sensor\$1operator.infra\$1failures  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  LoadedTasks  |  smart\$1sensor\$1operator.loaded\$1tasks  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  TotalParseTime  |  dag\$1processing.total\$1parse\$1time  |  秒  |  関数、DAG 処理  | 
|  TriggeredDagRuns  Apache Airflow v2.6.3 以降で利用可能です。   |  dataset.triggered\$1dagruns  |  カウント  |  関数、スケジュール  | 
|  TriggersRunning  Apache Airflow v2.7.2 以降で利用可能です。   |  triggers.running.*\$1hostname\$1*  |  カウント  |  関数、トリガー HostName, *\$1hostname\$1*  | 
|  PoolDeferredSlots  Apache Airflow v2.7.2 以降で利用可能です。   |  pool.deferred\$1slots.`{pool_name}`  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  DAGFileProcessingLastRunSecondsAgo  |  dag\$1processing.last\$1run.seconds\$1ago.\$1dag\$1filename\$1  |  秒  |  DAG Filename, \$1dag\$1filename\$1  | 
|  OpenSlots  |  executor.open\$1slots  |  カウント  |  関数、エグゼキューター  | 
|  OrphanedTasksAdopted  |  scheduler.orphaned\$1tasks.adopted  |  カウント  |  関数、スケジュール  | 
|  OrphanedTasksCleared  |  scheduler.orphaned\$1tasks.cleared  |  カウント  |  関数、スケジュール  | 
|  PokedExceptions  |  smart\$1sensor\$1operator.poked\$1exception  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  PokedSuccess  |  smart\$1sensor\$1operator.poked\$1success  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  PokedTasks  |  smart\$1sensor\$1operator.poked\$1tasks  |  カウント  |  関数、スマートセンサーオペレーター  | 
|  PoolFailures  |  pool.open\$1slots.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  PoolStarvingTasks  |  pool.starving\$1tasks.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  PoolOpenSlots  |  pool.open\$1slots.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  PoolQueuedSlots  |  pool.queued\$1slots.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  PoolRunningSlots  |  pool.running\$1slots.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  ProcessorTimeouts  |  dag\$1processing.processor\$1timeouts  |  カウント  |  関数、DAG 処理  | 
|  QueuedTasks  |  executor.queued\$1tasks  |  カウント  |  関数、エグゼキューター  | 
|  RunningTasks  |  executor.running\$1tasks  |  カウント  |  関数、エグゼキューター  | 
|  TasksExecutable  |  scheduler.tasks.executable  |  カウント  |  関数、スケジュール  | 
|  TasksPending  Apache Airflow v2.2 以降には適用されません。   |  scheduler.tasks.pending  |  カウント  |  関数、スケジュール  | 
|  TasksRunning  |  scheduler.tasks.running  |  カウント  |  関数、スケジュール  | 
|  TasksStarving  |  scheduler.tasks.starving  |  カウント  |  関数、スケジュール  | 
|  TasksWithoutDagRun  |  scheduler.tasks.without\$1dagrun  |  カウント  |  関数、スケジュール  | 
|  DAGFileProcessingLastNumOfDbQueries  Apache Airflow v2.10.1 以降で利用可能です。  |  dag\$1processing.last\$1num\$1of\$1db\$1queries.\$1dag\$1filename\$1  |  カウント  |  DAG Filename, \$1dag\$1filename\$1  | 
|  PoolScheduledSlots  Apache Airflow v2.10.1 以降で利用可能です。   |  pool.scheduled\$1slots.\$1pool\$1name\$1  |  カウント  |  Pool, \$1pool\$1name\$1  | 
|  TaskCpuUsage  Apache Airflow v2.10.1 以降で利用可能です。  |  cpu.usage.\$1dag\$1id\$1.\$1task\$1id\$1  |  割合 (%)  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1  | 
|  TaskMemoryUsage  Apache Airflow v2.10.1 以降で利用可能です。  |  mem.usage.\$1dag\$1id\$1.\$1task\$1id\$1  |  割合 (%)  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1  | 

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

このセクションの Apache Airflow メトリクスには、[Apache Airflow *Timers*](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/logging-monitoring/metrics.html#timers) に関するデータが含まれています。


| [CloudWatch メトリクス] | Apache Airflow メトリクス | Unit | ディメンション | 
| --- | --- | --- | --- | 
|  CollectDBDags  |  collect\$1db\$1dags  |  ミリ秒  |  関数、DAG 処理  | 
|  CriticalSectionDuration  |  scheduler.critical\$1section\$1duration  |  ミリ秒  |  関数、スケジュール  | 
|  CriticalSectionQueryDuration  Apache Airflow v2.5.1 以降で利用可能です。   |  scheduler.critical\$1section\$1query\$1duration  |  ミリ秒  |  関数、スケジュール  | 
|  DAGDependencyCheck  |  dagrun.dependency-check.\$1dag\$1id\$1  |  ミリ秒  |  DAG, \$1dag\$1id\$1  | 
|  DAGDurationFailed  |  dagrun.duration.failed.\$1dag\$1id\$1  |  ミリ秒  |  DAG, \$1dag\$1id\$1  | 
|  DAGDurationSuccess  |  dagrun.duration.success.\$1dag\$1id\$1  |  ミリ秒  |  DAG, \$1dag\$1id\$1  | 
|  DAGFileProcessingLastDuration  |  dag\$1processing.last\$1duration.\$1dag\$1filename\$1  |  秒  |  DAG Filename, \$1dag\$1filename\$1  | 
|  DAGScheduleDelay  |  dagrun.schedule\$1delay.\$1dag\$1id\$1  |  ミリ秒  |  DAG, \$1dag\$1id\$1  | 
|  FirstTaskSchedulingDelay  |  dagrun.\$1dag\$1id\$1.first\$1task\$1scheduling\$1delay  |  ミリ秒  |  DAG, \$1dag\$1id\$1  | 
|  SchedulerLoopDuration  Apache Airflow v2.5.1 以降で利用可能です。   |  scheduler.scheduler\$1loop\$1duration  |  ミリ秒  |  関数、スケジュール  | 
|  TaskInstanceDuration  |  dag.\$1dag\$1id\$1.\$1task\$1id\$1.duration  |  ミリ秒  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1  | 
|  TaskInstanceQueuedDuration  |  dag.`{dag_id}`.`{task_id}`.queued\$1duration  Apache Airflow v2.7.2 以降で利用可能です。   |  ミリ秒  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1  | 
|  TaskInstanceScheduledDuration  Apache Airflow v2.7.2 以降で利用可能です。   |  dag.`{dag_id}`.`{task_id}`.scheduled\$1duration  |  ミリ秒  |  DAG, \$1dag\$1id\$1 Task, \$1task\$1id\$1  | 

## どのメトリクスを報告するかを選択する
<a name="choosing-metrics"></a>

次の Amazon MWAA [設定オプション](configuring-env-variables.md) を使用して、どの Apache Airflow メトリクスを CloudWatch に送信するか、またはApache Airflow によってブロックするかを選択できます。
+ **`metrics.metrics_allow_list`** — お使いの環境によって CloudWatch に送信されるメトリクスを選択するために使用できるカンマで区切られたプレフィックスのリスト。Apache Airflow で利用可能なメトリクスをすべて送信させずに、要素のサブセットを選択させたい場合は、このオプションを使用してください。例えば、`scheduler,executor,dagrun` です。
+ **`metrics.metrics_block_list`** — リストの要素で始まるメトリクスを除外するための、カンマで区切られたプレフィックスのリスト。例えば、`scheduler,executor,dagrun` です。

`metrics.metrics_allow_list` と `metrics.metrics_block_list` を両方構成した場合、Apache Airflow は `metrics.metrics_block_list` を無視します。`metrics.metrics_block_list` を設定して、`metrics.metrics_allow_list` を設定しなかった場合、Apache Airflow は `metrics.metrics_block_list` で指定した要素を除外します。

**注記**  
`metrics.metrics_allow_list` および `metrics.metrics_block_list` 設定オプションは、Apache Airflow v2.6.3 以降にのみ適用されます。以前のバージョンの Apache Airflow では、`metrics.statsd_allow_list` と `metrics.statsd_block_list` を使用します。

## 次のステップ
<a name="mwaa-metrics202-next-up"></a>
+ [PublishMetrics](https://docs.aws.amazon.com/mwaa/latest/API/API_PublishMetrics.html) で環境ヘルスメトリクスの公開に使用される Amazon MWAA API オペレーションをご覧ください。