

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

# Amazon Managed Workflows for Apache Airflow のモニタリングとメトリクス
<a name="cw-metrics"></a>

モニタリングは、Amazon Managed Workflows for Apache Airflow と AWS ソリューションの信頼性、可用性、パフォーマンスを維持する上で重要な部分です。マルチポイント障害が発生した場合は、その障害をより簡単にデバッグできるように、 AWS ソリューションのすべての部分からモニタリングデータを収集することをお勧めします。このトピックでは AWS 、Amazon MWAA 環境をモニタリングし、潜在的なイベントに対応するための リソースについて説明します。

**注記**  
Apache Airflow メトリクスとログは、標準の [Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/) の対象となります。

Apache Airflow のモニタリングの詳細については、Apache Airflow ドキュメンテーションウェブサイトの [ログとモニタリング](https://airflow.apache.org/docs/apache-airflow/stable/logging-monitoring/index.html) を参照してください。

**Topics**
+ [Amazon MWAA でのモニタリングの概要](monitoring-overview.md)
+ [での監査ログへのアクセス AWS CloudTrail](monitoring-cloudtrail.md)
+ [Amazon CloudWatch の Airflow ログへのアクセス](monitoring-airflow.md)
+ [Amazon MWAA のモニタリングダッシュボードとアラーム](monitoring-dashboard.md)
+ [CloudWatch の Apache Airflow 環境メトリクス](access-metrics-cw.md)
+ [Amazon MWAA のコンテナ、キュー、およびデータベースメトリクス](accessing-metrics-cw-container-queue-db.md)

# Amazon MWAA でのモニタリングの概要
<a name="monitoring-overview"></a>

このページでは、Amazon Managed Workflows for Apache Airflow 環境のモニタリングに使用される AWS サービスについて説明します。

**Contents**
+ [Amazon CloudWatch の概要](#monitoring-metrics-cw-about)
+ [AWS CloudTrail の概要](#monitoring-metrics-ct-about)

## Amazon CloudWatch の概要
<a name="monitoring-metrics-cw-about"></a>

CloudWatch は、 AWS サービスによって発行されたメトリクスと[ディメンション](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)に基づいて統計を取得するために使用できるサービスの[メトリクス](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric)リポジトリです。これらのメトリクスを使用して [アラーム](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#CloudWatchAlarms) を構成し、統計を計算し、そのデータを Amazon CloudWatch コンソールで環境の状態を評価するのに役立つ [ダッシュボード](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) に表示できます。

Apache Airflow は、Amazon Managed Workflows for Apache Airflow 環境の [StatsD](https://github.com/etsy/statsd) メトリクスを Amazon CloudWatch に送信するようにすでに設定されています。

詳細については、[Amazon CloudWatch とは](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) を参照してください。

## AWS CloudTrail の概要
<a name="monitoring-metrics-ct-about"></a>

CloudTrail は、Amazon MWAA のユーザー、ロール、または AWS のサービスによって実行されたアクションを記録する監査サービスです。CloudTrail により収集された情報を使用して、Amazon MWAA に対して行われたリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエストが行われた日時、および追加の詳細を特定することができます。

詳細については、[「 とは AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)」を参照してください。

# での監査ログへのアクセス AWS CloudTrail
<a name="monitoring-cloudtrail"></a>

AWS CloudTrail は、作成 AWS アカウント 時に で有効になります。CloudTrail は、CloudTrail イベントとして記録される Amazon Managed Workflows for Apache Airflow などの IAM エンティティまたは AWS サービスによって実行されたアクティビティを記録します。CloudTrail コンソールでは、過去 90 日間のイベント履歴を表示、検索、ダウンロードできます。CloudTrail は Amazon MWAA コンソールのすべてのイベントと Amazon MWAA API へのすべての呼び出しをキャプチャします。`GetEnvironment` などの読み取り専用アクションや `PublishMetrics` アクションはキャプチャされません。このページでは、CloudTrail を使用して Amazon MWAA のイベントをモニタリングする方法について説明します。

**Contents**
+ [CloudTrail で追跡を作成する](#monitoring-cloudtrail-create)
+ [CloudTrail Event 履歴でのイベントへのアクセス](#monitoring-cloudtrail-view)
+ [`CreateEnvironment` のトレイルの例](#monitoring-cloudtrail-logs-ex)
+ [次のステップ](#monitoring-cloudtrail-next-up)

## CloudTrail で追跡を作成する
<a name="monitoring-cloudtrail-create"></a>

Amazon MWAA のイベントなど AWS アカウント、 のイベントの継続的な記録にアクセスするには、証跡を作成する必要があります。証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。証跡を作成しない場合でも、CloudTrail コンソールで入手可能なイベント履歴にアクセスできます。例えば、CloudTrail により収集された情報を使用して、Amazon MWAA に対して行われたリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエストが行われた日時、および追加の詳細を特定することができます。詳細については、[AWS アカウントの証跡の作成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) を参照してください。

## CloudTrail Event 履歴でのイベントへのアクセス
<a name="monitoring-cloudtrail-view"></a>

CloudTrail コンソールで過去 90 日間の運用およびセキュリティインシデントのトラブルシューティングを行うには、[イベント履歴] を表示します。例えば、 内のリソース (IAM ユーザーや他の AWS リソースなど) の作成、変更、または削除に関連するイベントには AWS アカウント 、リージョンごとにアクセスできます。詳細については、[Accessing Events with CloudTrail Event History](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) (CloudTrail イベント履歴でのイベントのアクセス) を参照してください。

1. [CloudTrail](https://console.aws.amazon.com/cloudtrail/home#) コンソールを開きます。

1. **イベント履歴** を選択します。

1. 表示したいイベントを選択し、**イベントの詳細を比較** を選択します。

## `CreateEnvironment` のトレイルの例
<a name="monitoring-cloudtrail-logs-ex"></a>

「トレイル」は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。

CloudTrail のログファイルには、ログエントリが 1 つ以上あります。イベントは、あらゆるソースからの単一のリクエストを表し、リクエストされたアクション、アクションの日時、およびリクエストパラメータなどに関する情報が含まれています。CloudTrail ログファイルは、公開 API コールの順序付けられたスタックトレースではなく、特定の順序でリストされていません。次の例では、アクセス許可がないために拒否された `CreateEnvironment` アクションのログエントリを示します。`AirflowConfigurationOptions` 内の値は、プライバシー保護のために編集されています。

```
{
  "eventVersion": "1.05",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "00123456ABC7DEF8HIJK",
    "arn": "arn:aws:sts::012345678901:assumed-role/root/myuser",
    "accountId": "012345678901",
    "accessKeyId": "",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "00123456ABC7DEF8HIJK",
        "arn": "arn:aws:iam::012345678901:role/user",
        "accountId": "012345678901",
        "userName": "user"
      },
      "webIdFederationData": {},
      "attributes": {
        "mfaAuthenticated": "false",
        "creationDate": "2020-10-07T15:51:52Z"
      }
    }
  },
  "eventTime": "2020-10-07T15:52:58Z",
  "eventSource": "airflow.amazonaws.com",
  "eventName": "CreateEnvironment",
  "awsRegion": "us-west-2",
  "sourceIPAddress": "205.251.233.178",
  "userAgent": "PostmanRuntime/7.26.5",
  "errorCode": "AccessDenied",
  "requestParameters": {
    "SourceBucketArn": "arn:aws:s3:::my-bucket",
    "ExecutionRoleArn": "arn:aws:iam::012345678901:role/AirflowTaskRole",
    "AirflowConfigurationOptions": "***",
    "DagS3Path": "sample_dag.py",
    "NetworkConfiguration": {
      "SecurityGroupIds": [
      "sg-01234567890123456"
      ],
      "SubnetIds": [
        "subnet-01234567890123456",
        "subnet-65432112345665431"
      ]
    },
    "Name": "test-cloudtrail"
  },
  "responseElements": {
    "message": "Access denied."
  },
  "requestID": "RequestID",
  "eventID": "EventID",
  "readOnly": false,
  "eventType": "AwsApiCall",
  "recipientAccountId": "012345678901"
}
```

## 次のステップ
<a name="monitoring-cloudtrail-next-up"></a>
+ CloudTrail がサポートする AWS サービスと統合の CloudTrail ログで収集されたイベントデータ用に他の サービスを設定する方法について説明します。 [CloudTrail ](https://docs.aws.amazon.com//awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ CloudTrail が Amazon S3 バケットに新しいログファイルを発行するときに通知を受け取る方法については、[CloudTrail 用の Amazon SNS 通知の設定](https://docs.aws.amazon.com//awscloudtrail/latest/userguide/getting_notifications_top_level.html) をご参照ください。

# Amazon CloudWatch の Airflow ログへのアクセス
<a name="monitoring-airflow"></a>

Amazon MWAA は Apache Airflow ログを Amazon CloudWatch に送信できます。追加のサードパーティツールなしで、Apache Airflow のタスクの遅延やワークフローエラーを簡単に特定するために、単一の場所から複数の環境のログにアクセスできます。CloudWatch で Apache Airflow DAG 処理、タスク、ウェブサーバー、ワーカーログにアクセスするには、Amazon Managed Workflows for Apache Airflow コンソールで Apache Airflow ログを有効にする必要があります。

**Contents**
+ [料金](#monitoring-airflow-pricing)
+ [[開始する前に]](#monitoring-airflow-before)
+ [ログタイプ](#monitoring-airflow-log-groups)
+ [Apache Airflow ログを有効にする](#monitoring-airflow-enable)
+ [Apache Airflow ログへのアクセス](#monitoring-airflow-view)
+ [スケジューラーログの例](#monitoring-airflow-example)
+ [次のステップ](#monitoring-airflow-next-up)

## 料金
<a name="monitoring-airflow-pricing"></a>
+ CloudWatch Logs の一般料金が適用されます。詳細については、[CloudWatch 料金表](https://aws.amazon.com/cloudwatch/pricing/) を参照してください。

## [開始する前に]
<a name="monitoring-airflow-before"></a>
+ CloudWatch でログにアクセスできるロールが必要です。詳細については、[Amazon MWAA 環境へのアクセス](access-policies.md) を参照してください。

## ログタイプ
<a name="monitoring-airflow-log-groups"></a>

Amazon MWAA は、有効にする Airflow ロギングオプションごとにロググループを作成し、そのログを環境に関連付けられた CloudWatch Logs グループにプッシュします。ロググループの名前は以下の形式に従います: `YourEnvironmentName-LogType` 例えば、お使いの環境に `Airflow-v202-Public` という名前が付けられている場合、Apache Airflow タスクログは `Airflow-v202-Public-Task` に送信されます。


| ログタイプ | 説明 | 
| --- | --- | 
|  `YourEnvironmentName-DAGProcessing`  |  DAG プロセッサマネージャー (DAG ファイルを処理するスケジューラーの一部) のログ。  | 
|  `YourEnvironmentName-Scheduler`  |  Airflow スケジューラーが生成するログ。  | 
|  `YourEnvironmentName-Task`  |  DAG が生成するタスクログ。  | 
|  `YourEnvironmentName-WebServer`  |  Airflow ウェブインターフェイスが生成するログ。  | 
|  `YourEnvironmentName-Worker`  |  ワークフローと DAG 実行の一部として生成されたログ。  | 

## Apache Airflow ログを有効にする
<a name="monitoring-airflow-enable"></a>

Apache Airflow ログは `INFO`、`WARNING`、`ERROR` または `CRITICAL` レベルで有効にできます。ログレベルを選択すると、Amazon MWAA はそのレベルとそれ以上の重要度レベルのすべてのログを送信します。例えば、`INFO` レベルでログを有効にすると、Amazon MWAA は `INFO` ログと `WARNING`、`ERROR`、`CRITICAL` のログレベルを CloudWatch Logs に送信します。

1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。

1. 環境を選択します。

1. **編集** を選択します。

1. **次へ** を選択します。

1. 以下のロギングオプションのうち 1 つ以上を選択します。

   1. **モニタリング** ペインで **Airflow スケジューラーロググループ** を選択します。

   1. **モニタリング** ペインで **Airflow ウェブサーバーのロググループ** を選択します。

   1. **モニタリング** ペインで **Airflow ワーカーロググループ** を選択します。

   1. **モニタリング** ペインで **Airflow DAG 処理ロググループ** を選択します。

   1. **モニタリング** ペインで **Airflow タスクロググループ** を選択します。

   1. **ログレベル** でログレベルを選択します。

1. **次へ** を選択します。

1. **保存** を選択します。

## Apache Airflow ログへのアクセス
<a name="monitoring-airflow-view"></a>

以下のセクションでは、CloudWatch コンソールで Apache Airflow のログにアクセスする方法について説明します。

1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。

1. 環境を選択します。

1. **モニタリング** ペインでロググループを選択します。

1. **ログストリーム** を選択します。

## スケジューラーログの例
<a name="monitoring-airflow-example"></a>

ワークフローのスケジュール設定と `dags` フォルダーの解析を行うスケジューラーの Apache Airflow ログにアクセスできます。次のステップでは、Amazon MWAA コンソールでスケジューラーのロググループを開き、CloudWatch Logs コンソールで Apache Airflow ログにアクセスする方法について説明します。

**`requirements.txt` のログにアクセスするには**

1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。

1. 環境を選択します。

1. **モニタリング** ペインで **Airflow スケジューラーロググループ** を選択します。

1. **ログストリーム** の `requirements_install_ip` ログを選択します。

1. 環境にインストールされたパッケージのリストについては、`/usr/local/airflow/.local/bin` を参照してください。例えば、次のようになります。

   ```
   Collecting appdirs==1.4.4 (from -r /usr/local/airflow/.local/bin (line 1))
   Downloading https://files.pythonhosted.org/packages/3b/00/2344469e2084fb28kjdsfiuyweb47389789vxbmnbjhsdgf5463acd6cf5e3db69324/appdirs-1.4.4-py2.py3-none-any.whl  
   Collecting astroid==2.4.2 (from -r /usr/local/airflow/.local/bin (line 2))
   ```

1. パッケージのリストを確認し、インストール中にエラーが発生したパッケージがないか確認してください。何か問題が発生した場合、以下のようなエラーが表示される場合があります。

   ```
   2021-03-05T14:34:42.731-07:00
   No matching distribution found for LibraryName==1.0.0 (from -r /usr/local/airflow/.local/bin (line 4))
   No matching distribution found for LibraryName==1.0.0 (from -r /usr/local/airflow/.local/bin (line 4))
   ```

## 次のステップ
<a name="monitoring-airflow-next-up"></a>
+ CloudWatch アラームの構成方法については、[Amazon CloudWatch アラームの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) を参照してください。
+ CloudWatch ダッシュボードの作成方法については、[CloudWatch ダッシュボードの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) をご参照ください。

# Amazon MWAA のモニタリングダッシュボードとアラーム
<a name="monitoring-dashboard"></a>

Amazon CloudWatch でカスタムダッシュボードを作成し、特定のメトリクスのアラームを追加して、Amazon Managed Workflows for Apache Airflow 環境のヘルスステータスをモニタリングできます。ダッシュボードにある場合、`ALARM` 状態になると、アラームは赤に変わるため、Amazon MWAA の環境の健全を事前にモニタリングしやすくなります。

Apache Airflow は、DAG プロセスの数、DAG バッグサイズ、現在実行中のタスク、タスクの失敗、成功など、さまざまなプロセスのメトリクスを公開します。環境を作成すると、Airflow は Amazon MWAA 環境のメトリクスを CloudWatch に自動的に送信します。このページでは、Amazon MWAA 環境の CloudWatch で Airflow メトリクスのヘルスステータスダッシュボードを作成する方法について説明します。

**Contents**
+ [メトリクス](#monitoring-dashboard-metrics)
+ [アラーム状態の概要](#monitoring-dashboard-states)
+ [カスタムダッシュボードとアラームの例](#monitoring-dashboard-custom)
  + [これらのメトリクスについて](#monitoring-dashboard-custom-about)
  + [ダッシュボードについて](#monitoring-dashboard-custom-about-dash)
  + [AWS チュートリアルの使用](#monitoring-dashboard-tutorials)
  + [の使用 CloudFormation](#monitoring-dashboard-cfn)
+ [メトリクスとダッシュボードの削除](#monitoring-dashboard-delete)
+ [次のステップ](#monitoring-dashboard-next-up)

## メトリクス
<a name="monitoring-dashboard-metrics"></a>

お使いの Apache Airflow バージョンで使用できるすべてのメトリクスについて、カスタムダッシュボードとアラームを作成できます。各メトリクスはApache Airflow キーパフォーマンスインジケーター (KPI) に対応しています。メトリクスのリストにアクセスするには、以下を参照してください。
+ [CloudWatch の Apache Airflow 環境メトリクス](access-metrics-cw.md)

## アラーム状態の概要
<a name="monitoring-dashboard-states"></a>

メトリクスアラームには次の状態があります。
+ `OK` – メトリクスや式は、定義されているしきい値の範囲内です。
+ `ALARM` – メトリクスまたは式が、定義されているしきい値を超えています。
+ `INSUFFICIENT_DATA` – アラームが開始直後であるか、メトリクスが利用できないか、メトリクス用のデータが不足しているため、アラームの状態を判定できません。

## カスタムダッシュボードとアラームの例
<a name="monitoring-dashboard-custom"></a>

Amazon MWAA 環境の選択したメトリクスのグラフを表示するカスタムモニタリングダッシュボードを構築できます。

### これらのメトリクスについて
<a name="monitoring-dashboard-custom-about"></a>

以下のリストでは、このセクションのチュートリアルとテンプレート定義によってカスタムダッシュボードに作成された各メトリクスについて説明します。
+ *QueuedTasks* — キューに入っている状態のタスクの数。`executor.queued_tasks` Apache Airflow メトリクスに対応します。
+ *TaskSpending* — エグゼキューターで保留中のタスクの数。`scheduler.tasks.pending` Apache Airflow メトリクスに対応します。
**注記**  
Apache Airflow v2.2 以降には適用されません。
+ *RunningTasks* — エグゼキューターで実行中のタスクの数。`executor.running_tasks` Apache Airflow メトリクスに対応します。
+ *SchedulerHeartbeat* — Apache Airflow がスケジューラジョブで実行するチェックインの回数。`scheduler_heartbeat` Apache Airflow メトリクスに対応します。
+ *TotalParseTime* — すべての DAG ファイルを 1 回スキャンしてインポートするのにかかった秒数。`dag_processing.total_parse_time` Apache Airflow メトリクスに対応します。

### ダッシュボードについて
<a name="monitoring-dashboard-custom-about-dash"></a>

以下の画像は、このセクションのチュートリアルとテンプレート定義によって作成されたモニタリングダッシュボードを示しています。

![\[この画像は、Amazon MWAA コンソールの プライベートネットワーク オプションが表示される場所を示しています。\]](http://docs.aws.amazon.com/ja_jp/mwaa/latest/userguide/images/cw-dashboard.png)


### AWS チュートリアルの使用
<a name="monitoring-dashboard-tutorials"></a>

次の AWS チュートリアルを使用して、現在デプロイされている Amazon MWAA 環境のヘルスステータスダッシュボードを自動的に作成できます。また、すべての Amazon MWAA 環境で、異常のあるワーカーやスケジューラーのハートビート障害に対して CloudWatch アラームを作成します。
+ [Amazon MWAA 向けCloudWatch ダッシュボードオートメーション](https://github.com/aws-samples/mwaa-dashboard)

### の使用 CloudFormation
<a name="monitoring-dashboard-cfn"></a>

このセクションの CloudFormation テンプレート定義を使用して CloudWatch でモニタリングダッシュボードを作成し、CloudWatch コンソールにアラームを追加して、メトリクスが特定のしきい値を超えたときに通知を受け取ることができます。このテンプレート定義を使用してスタックを作成するには、「 [CloudFormation コンソールでのスタックの作成](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)」を参照してください。ダッシュボードにアラームを追加するには、[アラームの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) を参照してください。

```
AWSTemplateFormatVersion: "2010-09-09"
Description: Creates MWAA Cloudwatch Dashboard
Parameters:
  DashboardName:
    Description: Enter the name of the CloudWatch Dashboard
    Type: String
  EnvironmentName:
    Description: Enter the name of the MWAA Environment
    Type: String    
Resources:
  BasicDashboard:
    Type: AWS::CloudWatch::Dashboard
    Properties:
      DashboardName: !Ref DashboardName
      DashboardBody:
        Fn::Sub: '{
              "widgets": [
                  {
                      "type": "metric",
                      "x": 0,
                      "y": 0,
                      "width": 12,
                      "height": 6,
                      "properties": {
                          "view": "timeSeries",
                          "stacked": true,
                          "metrics": [
                              [
                                  "AmazonMWAA",
                                  "QueuedTasks",
                                  "Function",
                                  "Executor",
                                  "Environment",
                                  "${EnvironmentName}"
                              ]
                          ],
                          "region": "${AWS::Region}",
                          "title": "QueuedTasks ${EnvironmentName}",
                          "period": 300
                      }
                  },
                  {
                      "type": "metric",
                      "x": 0,
                      "y": 6,
                      "width": 12,
                      "height": 6,
                      "properties": {
                          "view": "timeSeries",
                          "stacked": true,
                          "metrics": [
                              [
                                  "AmazonMWAA",
                                  "RunningTasks",
                                  "Function",
                                  "Executor",
                                  "Environment",
                                  "${EnvironmentName}"
                              ]
                          ],
                          "region": "${AWS::Region}",
                          "title": "RunningTasks ${EnvironmentName}",
                          "period": 300
                      }
                  },
                  {
                      "type": "metric",
                      "x": 12,
                      "y": 6,
                      "width": 12,
                      "height": 6,
                      "properties": {
                          "view": "timeSeries",
                          "stacked": true,
                          "metrics": [
                              [
                                  "AmazonMWAA",
                                  "SchedulerHeartbeat",
                                  "Function",
                                  "Scheduler",
                                  "Environment",
                                  "${EnvironmentName}"
                              ]
                          ],
                          "region": "${AWS::Region}",
                          "title": "SchedulerHeartbeat ${EnvironmentName}",
                          "period": 300
                      }
                  },
                  {
                      "type": "metric",
                      "x": 12,
                      "y": 0,
                      "width": 12,
                      "height": 6,
                      "properties": {
                          "view": "timeSeries",
                          "stacked": true,
                          "metrics": [
                              [
                                  "AmazonMWAA",
                                  "TasksPending",
                                  "Function",
                                  "Scheduler",
                                  "Environment",
                                  "${EnvironmentName}"
                              ]
                          ],
                          "region": "${AWS::Region}",
                          "title": "TasksPending ${EnvironmentName}",
                          "period": 300
                      }
                  },
                  {
                      "type": "metric",
                      "x": 0,
                      "y": 12,
                      "width": 24,
                      "height": 6,
                      "properties": {
                          "view": "timeSeries",
                          "stacked": true,
                          "region": "${AWS::Region}",
                          "metrics": [
                              [
                                  "AmazonMWAA",
                                  "TotalParseTime",
                                  "Function",
                                  "DAG Processing",
                                  "Environment",
                                  "${EnvironmentName}"
                              ]
                          ],
                          "title": "TotalParseTime  ${EnvironmentName}",
                          "period": 300
                      }
                  }
              ]
          }'
```

## メトリクスとダッシュボードの削除
<a name="monitoring-dashboard-delete"></a>

Amazon MWAA 環境を削除すると、対応するダッシュボードも削除されます。CloudWatch メトリクスは 15 か月間保存され、削除することはできません。CloudWatch コンソールでは、Amazon MWAA 環境の最新のインスタンスが表示されるように、メトリクスの検索は、メトリクスが最後に取り込まれてから 2 週間に制限されています。詳細については、[Amazon CloudWatch に関するよくある質問](https://aws.amazon.com/cloudwatch/faqs/) を参照してください。

## 次のステップ
<a name="monitoring-dashboard-next-up"></a>
+ お使いの環境の Amazon Aurora PostgreSQL メタデータデータベースにクエリを実行し、カスタムメトリクスを [DAG を使用して CloudWatch にカスタムメトリクスを書き込む](samples-custom-metrics.md) で CloudWatch に公開する DAG を作成する方法について説明します。

# 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 オペレーションをご覧ください。

# Amazon MWAA のコンテナ、キュー、およびデータベースメトリクス
<a name="accessing-metrics-cw-container-queue-db"></a>

Apache Airflow のメトリクスに加え、Amazon Managed Workflows for Apache Airflow 環境の基盤となるコンポーネントは、CloudWatch を使ってモニタリングすることができます。CloudWatch は、raw データを収集し、読み取り可能なほぼリアルタイムのメトリクスに加工することができます。これらの環境メトリクスを使用すると、主要業績評価指標の可視性が高まり、環境の適切な規模を決定し、ワークフローの問題をデバッグするのに役立ちます。これらのメトリクスは、Amazon MWAA でサポートされているすべての Apache Airflow バージョンに適用されます。



Amazon MWAA は、各 Amazon Elastic Container Service (Amazon ECS) コンテナと Amazon Aurora PostgreSQL インスタンスの CPU とメモリの使用率、メッセージの数と最も古いメッセージの経過時間に関する Amazon Simple Queue Service (Amazon SQS) メトリクス、データベース接続、ディスクキューの深さ、書き込みオペレーション、レイテンシー、スループットに関する Amazon Relational Database Service (Amazon RDS) のメトリクス、および Amazon RDS Proxy メトリクスを提供します。これらのメトリクスには、ベースワーカー、追加ワーカー、スケジューラー、およびウェブサーバーの数も含まれます。

これらの統計は 15 か月間保持されるため、履歴情報にアクセスして、スケジュールが失敗する理由をより的確に把握し、根本的な問題のトラブルシューティングを行うことができます。また、特定のしきい値をモニタリングするアラームを設定し、しきい値に達したときに通知を送信したりアクションを実行したりできます。詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/) を参照してください。

**Topics**
+ [用語](#accessing-metrics-cw-container-queue-db-terms)
+ [ディメンション](#accessing-metrics-cw-container-queue-db-dimensions)
+ [CloudWatch コンソールのメトリクスにアクセスする](#accessing-metrics-cw-container-queue-db-console)
+ [メトリクスのリスト](#accessing-metrics-cw-container-queue-db-list)

## 用語
<a name="accessing-metrics-cw-container-queue-db-terms"></a>

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

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

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

**Unit**  
1 つの統計には、測定単位があります。Amazon MWAA の場合、単位には *カウント* が含まれます。

## ディメンション
<a name="accessing-metrics-cw-container-queue-db-dimensions"></a>

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


| ディメンション | 説明 | 
| --- | --- | 
|  クラスター  |  Amazon MWAA 環境が Apache Airflow コンポーネントの実行に使用する、少なくとも 3 つの Amazon ECS コンテナのメトリクス (スケジューラー、ワーカー、ウェブサーバー)。  | 
|  [キュー]  |  スケジューラーをワーカーから切り離す Amazon SQS キューのメトリクス。ワーカーがメッセージを読むと、そのメッセージは処理中と見なされ、他のワーカーは使用できません。12 時間の可視性タイムアウトまでにメッセージを削除しないと、他のワーカーがメッセージを読むことができるようになります。  | 
|  データベース  |  Amazon MWAA が使用する Aurora クラスターのメトリクス。これには、プライマリデータベースインスタンスと読み取りオペレーションをサポートするリードレプリカのメトリクスが含まれます。Amazon MWAA は READER インスタンスと WRITER インスタンスの両方のデータベースメトリクスを公開します。  | 

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

このセクションでは、CloudWatch で Amazon MWAA メトリクスにアクセスする方法について説明します。

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

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

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

1. **AWS/MWAA** の名前空間を選択します。

1. **すべてのメトリクス** タブで、ディメンションを選択します。例えば、**クラスター** です。

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

1. パフォーマンスメトリックにアクセスするには、**グラフ化されたメトリクス** タブを選択します。

## メトリクスのリスト
<a name="accessing-metrics-cw-container-queue-db-list"></a>

次のテーブルは、Amazon MWAA のクラスター、キュー、データベースサービスのメトリクスを一覧表示されます。Amazon ECS、Amazon SQS、または Amazon RDS から直接生成されたメトリクスの説明にアクセスするには、それぞれのドキュメントリンクを選択してください。

**Topics**
+ [クラスターメトリクス](#container-list)
+ [データベースメトリクス](#db-list)
+ [キューメトリクス](#queue-list)
+ [Application Load Balancer のメトリクス](#alb-list)

### クラスターメトリクス
<a name="container-list"></a>

以下のメトリクスは、各スケジューラー、ベースワーカー、追加ワーカー、ウェブサーバーに適用されます。各クラスターメトリクスの詳細と説明については、*Amazon ECS ディベロッパーガイド* の [利用可能なメトリクスとディメンション](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-metrics.html#available_cloudwatch_metrics) を参照してください。


| 名前空間 | メトリクス | 単位 | 
| --- | --- | --- | 
|  `AWS/MWAA`  |  `CPUUtilization`  |  割合 (%)  | 
|  `AWS/MWAA`  |  `MemoryUtilization`  |  割合 (%)  | 

#### 追加のワーカーコンテナとウェブサーバーコンテナの数の評価
<a name="additional-worker-scheduler-sample-count"></a>

以下の手順で説明するように、**クラスター** ディメンションで提供されるコンポーネントメトリクスを用いて、特定の時点で環境で使用している追加のワーカーまたはウェブサーバーの数を評価できます。これは、**CPUUtilization** または **MemoryUtilization** メトリクスのいずれかをグラフ化し、統計タイプを **サンプル数** に設定して、行うことができます。結果の値は、`AdditionalWorker` コンポーネントの `RUNNING` タスク総数です。環境で使用されている追加のワーカーインスタンスの数を把握しておくと、環境がどのようにスケーリングされるかを判断し、追加ワーカーの数を最適化するのに役立ちます。

------
#### [ Workers ]

**を使用して追加のワーカーの数を評価するには AWS マネジメントコンソール**

1. **AWS/MWAA** の名前空間を選択します。

1. **すべてのメトリクス** タブで、**クラスター** ディメンションを選択します。

1. **クラスター** ディメンションの **AdditionalWorker** では、**CPUUtilization** または**MemoryUtilization** メトリクスのいずれかを選択します。

1. **グラフ化したメトリクス** タブで、**期間** を **1 分** に、**統計** を **サンプル数** に設定します。

------
#### [ webservers ]

**を使用して追加のウェブサーバーの数を評価するには AWS マネジメントコンソール**

1. **AWS/MWAA** の名前空間を選択します。

1. **すべてのメトリクス** タブで、**クラスター** ディメンションを選択します。

1. **クラスター** ディメンションの **AdditionalWebservers** では、**CPUUtilization** または **MemoryUtilization** メトリクスのいずれかを選択します。

1. **グラフ化したメトリクス** タブで、**期間** を **1 分** に、**統計** を **サンプル数** に設定します。

------

詳細については、*Amazon Elastic Container Service デベロッパーガイド* の [サービスの `RUNNING` タスク数](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/cloudwatch-metrics.html#cw_running_task_count) を参照してください。

### データベースメトリクス
<a name="db-list"></a>

以下のメトリクスは、Amazon MWAA 環境に関連付けられた各データベースインスタンスに適用されます。


| 名前空間 | メトリクス | 単位 | 
| --- | --- | --- | 
|  `AWS/MWAA`  |  `CPUUtilization`  |  割合 (%)  | 
|  `AWS/MWAA`  |  `DatabaseConnections`  |  カウント  | 
|  `AWS/MWAA`  |  `DiskQueueDepth`  |  カウント  | 
|  `AWS/MWAA`  |  `FreeableMemory`  |  バイト  | 
|  `AWS/MWAA`  |  `VolumeWriteIOPS`  |  5 分あたりのカウント  | 
|  `AWS/MWAA`  |  `WriteIOPS`  |  1 秒あたりのカウント数  | 
|  `AWS/MWAA`  |  `WriteLatency`  |  秒  | 
|  `AWS/MWAA`  |  `WriteThroughput`  |  1 秒あたりのバイト数  | 

### キューメトリクス
<a name="queue-list"></a>

以下のキューメトリクスの単位と説明に関する詳細は、*Amazon Simple Queue Service デベロッパーガイド* の [Amazon SQS で使用できる CloudWatch メトリクス](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) を参照してください。


| 名前空間 | メトリクス | 単位 | 
| --- | --- | --- | 
|  `AWS/MWAA`  |  `ApproximateAgeOfOldestTask`  |  秒  | 
|  `AWS/MWAA`  |  `RunningTasks`  |  カウント  | 
|  `AWS/MWAA`  |  `QueuedTasks`  |  カウント  | 

### Application Load Balancer のメトリクス
<a name="alb-list"></a>

Application Load Balancer のメトリクスは、環境で実行されているウェブサーバーに適用されます。Amazon MWAA は、これらのメトリクスを使用して、トラフィック量に基づいてウェブサーバーをスケールします。Load Balancer のメトリクスの詳細については、*Application Load Balancer のユーザーガイド* の [Application Load Balancer の CloudWatch メトリクス](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-cloudwatch-metrics.html) を参照してください。


| 名前空間 | メトリクス | 単位 | 
| --- | --- | --- | 
|  `AWS/MWAA`  |  `ActiveConnectionCount`  |  カウント  | 