Athena メトリクスを使用した CloudWatch クエリのモニタリング - Amazon Athena

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

Athena メトリクスを使用した CloudWatch クエリのモニタリング

Athena は、[Amazon CloudWatchPublish to (CloudWatch に発行)] が選択されている場合に、クエリ関連メトリクスを に発行します。カスタムダッシュボードを作成したり、CloudWatch でメトリクスにアラームやトリガーを設定したり、Athena コンソールから事前に入力されているダッシュボードを使用できます。

ワークグループでクエリのクエリメトリクスを有効にすると、 コンソールの各ワークグループの [ワークグループ] パネルの [メトリクスAthena] タブにメトリクスが表示されます。

Athena は、次のメトリクスを CloudWatch コンソールに発行します。

  • EngineExecutionTime – ミリ秒単位

  • ProcessedBytes – DML クエリごとにスキャンされたデータの合計量

  • QueryPlanningTime – ミリ秒単位

  • QueryQueueTime – ミリ秒単位

  • ServiceProcessingTime – ミリ秒単位

  • TotalExecutionTime – DDL および DML クエリの場合、ミリ秒単位

これらのメトリクスには、次のディメンションがあります。

  • QueryStateQUEUEDRUNNINGSUCCEEDEDFAILED、またはCANCELLED

  • QueryTypeDML または DDL

  • WorkGroup – ワークグループの名前

詳細については、このトピックで後述する「CloudWatch メトリクスと Athena のディメンションの一覧表示」を参照してください。

ワークグループのクエリメトリクスをコンソールに表示するには

  1. Athena コンソール (https://console.aws.amazon.com/athena/) を開きます。

  2. [Workgroup: (ワークグループ:)<name>] タブを選択します。

    ワークグループのメトリクスを表示するために、そのワークグループに切り替える必要はなく、別のワークグループにとどまることができます。リストからワークグループを選択する必要があります。また、メトリクスを表示するアクセス権限が必要です。

  3. リストからワークグループを選択して、[View details (詳細を表示).] を選択します。アクセス権限がある場合、ワークグループの詳細が [Overview (概要)] タブに表示されます。

  4. [Metrics] タブを選択します。

    
                        コンソールのワークグループの詳細ページで [メトリクス] タブを選択します。Athena

    メトリクスダッシュボードが表示されます。

    注記

    ワークグループのメトリクスを最近有効にした場合や、最近のクエリアクティビティがない場合は、ダッシュボードのグラフが空になる可能性があります。クエリアクティビティは、次のステップで指定した間隔に応じて CloudWatch から取得されます。

  5. Athena からクエリメトリクスをフェッチするために CloudWatch が使用するメトリクス間隔を選択するか、カスタム間隔を指定します。

    
                        コンソールでのワークグループのメトリクス取得間隔の指定。Athena
  6. 表示されたメトリクスを更新するには、更新アイコンを選択します。

    
                        更新アイコンを選択します。
  7. 更新アイコンの横にある下向き矢印をクリックして、[自動更新] オプションとメトリクス表示の更新間隔を選択します。

    
                        ワークグループメトリクスの更新間隔を選択すると、Athena コンソールに表示されます。

Amazon CloudWatch コンソールでメトリクスを表示するには

  1. Amazon CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/.) を開きます。

  2. ナビゲーションペインで メトリクス.を選択します。

  3. AWS/Athena 名前空間を選択します。

CLI を使用してメトリクスを表示するには

  • コマンドプロンプトを開き、次のコマンドを使用します。

    aws cloudwatch list-metrics --namespace "AWS/Athena"
  • すべての使用可能なメトリクスのリストを表示するには、次のコマンドを使用します。

    aws cloudwatch list-metrics --namespace "AWS/Athena"

CloudWatch メトリクスと Athena のディメンションの一覧表示

CloudWatch の Athena メトリクスを有効にしている場合、ワークグループごとに CloudWatch に次のメトリクスを送信します。メトリクスは AWS/Athena 名前空間を使用します。

メトリクス名 説明
EngineExecutionTime

クエリの実行にかかったミリ秒数。

ProcessedBytes

Athena が DML クエリごとにスキャンしたデータの量 (メガバイト) (ユーザーによって、または制限に達した場合は自動的に) キャンセルされたクエリの場合、キャンセル前にスキャンされたデータの量も含まれます。このメトリクスは、DDL または CTAS クエリではレポートされません。

QueryPlanningTime Athena でクエリ処理フローの計画にかかったミリ秒数。データソースからテーブルパーティションを取得するのにかかる時間も含みます。クエリエンジンがクエリの計画を実行するため、クエリの計画時間は EngineExecutionTime のサブセットであることに注意してください。
QueryQueueTime クエリがリソースを待ってキューに並んでいたミリ秒数。一時的なエラーが発生した場合は、クエリを自動的にキューに追加し直すことができます。
ServiceProcessingTime クエリエンジンがクエリの実行を終了した後に Athena がクエリ結果の処理にかかったミリ秒数。
TotalExecutionTime Athena が DDL クエリまたは DML クエリの実行にかかったミリ秒数。TotalExecutionTime には、QueryQueueTime、QueryPlanningTime、EngineExecutionTime、および ServiceProcessingTime が含まれています。

CloudWatch の Athena メトリクスには、次のディメンションがあります。

ディメンション 説明
QueryState

クエリの状態。

有効な統計情報: QUEUED、RUNNING、SUCCEEDED、FAILED、CANCELLED。

注記

Athena は、特定の一時的なエラーの場合、クエリを自動的に再試行します。その結果、クエリの状態が「実行中」または「失敗」から「キューに追加済み」に移行することがあります。

QueryType

クエリタイプ。

有効な統計: DDL または DML.

WorkGroup

ワークグループの名前。