使用 CloudWatch 指標監控 Athena 查詢

選取將查詢指標發佈到 CloudWatch選項後 CloudWatch，Athena 會將查詢相關指標發佈至 Amazon。您可以建立自訂儀表板、在中設定指標的警示和觸發器 CloudWatch，或直接從 Athena 主控台使用預先填入的儀表板。

當您為工作群組中的查詢啟用查詢指標時，Athena 主控台中每個工作群組的指標會顯示在 Workgroups (工作群組) 面板中的 Metrics (指標) 索引標籤中。

Athena 會將下列指標發佈至主 CloudWatch 控台：

• DPUAllocated – 在容量保留中佈建的用於執行查詢的 DPU (資料處理單位) 總數。

• DPUConsumed – 在指定的時間，容量保留中處於 RUNNING 狀態的查詢主動使用的 DPU 數目。僅當工作群組與容量保留相關聯，並包含與保留關聯的所有工作群組時，才會發出指標。

• DPUCount – 查詢使用的 DPU 數目上限，僅當查詢完成時發布一次。

• EngineExecutionTime – 執行查詢所花費的毫秒數。

• ProcessedBytes – Athena 在每次 DML 查詢所掃描的位元組。

• QueryPlanningTime – Athena 規劃查詢處理流程所花費的毫秒數。

• QueryQueueTime – 查詢在查詢佇列中等待資源的毫秒數。

• ServicePreProcessingTime – 提交查詢至查詢引擎之前，Athena 預先處理查詢所花費的毫秒數。

• ServiceProcessingTime – 查詢引擎完成查詢的執行後，Athena 處理查詢結果所花費的毫秒數。

• TotalExecutionTime – Athena 執行 DDL 或 DML 查詢所花費的毫秒數。

如需更完整的描述，請參閱本文件稍後的 Athena 的 CloudWatch 度量和維度清單。

這些指標具有下列維度：

• CapacityReservation– 用於執行查詢的容量保留名稱 (如果適用)。

• QueryState – SUCCEEDED、FAILED 或 CANCELED

• QueryType – DML、DDL 或 UTILITY

• WorkGroup – 工作群組的名稱

Athena 會將下列指標發佈至命AmazonAthenaForApacheSpark名空間下的 CloudWatch 主控台：

• DPUCount – 工作階段期間用來執行計算所消耗的 DPU 數目。

該指標具有下列兩個維度：

• SessionId – 要提交計算的工作階段 ID。

• WorkGroup – 工作群組的名稱。

如需詳細資訊，請參閱本主題稍後的Athena 的 CloudWatch 度量和維度清單。如需有關 Athena 用量指標的資訊，請參閱監控 Athena 用量指標。

在主控台檢視工作群組的查詢指標

1. 前往 https://console.aws.amazon.com/athena/ 開啟 Athena 主控台。

2. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

   

3. 在導覽窗格中，選擇 Workgroups (工作群組)。

4. 從清單中選擇所需的工作群組，然後選擇 Metrics (指標) 索引標籤。

   指標儀表板隨即顯示。

   注意

   如果您最近剛啟用工作群組的指標，且/或最近沒有任何查詢活動，儀表板上的圖形可能會是空白的狀態。系統會 CloudWatch 根據您在下一個步驟中指定的間隔擷取查詢活動。

5. 在「量度」區段中，選擇 Athena 用來擷取查詢指標的度量間隔 CloudWatch，或指定自訂間隔。

   

6. 若要重新整理顯示的指標，請選擇重新整理圖示。

   

7. 按一下重新整理圖示旁的箭頭，以選擇您希望指標顯示的更新頻率。

   

若要在 Amazon CloudWatch 主控台中檢視指標

1. 請在以下位置開啟 CloudWatch 主控台。 https://console.aws.amazon.com/cloudwatch/

2. 在導覽窗格中，選擇 Metrics (指標)、All metrics (所有指標)。

3. 選取 AWS/Athena 命名空間。

使用 CLI 來檢視指標

• 執行以下任意一項：

  • 若要列出 Athena 的指標，請開啟命令提示，然後使用下列命令：

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

  • 若要列出所有可用的指標，請使用以下命令：

    aws cloudwatch list-metrics"

Athena 的 CloudWatch 度量和維度清單

如果您已在 Athena 中啟用 CloudWatch 指標，則會將下列指標傳送給 CloudWatch 每個工作群組。下列指標使用 AWS/Athena 命名空間。

指標名稱	描述
DPUAllocated	在容量保留中佈建的用於執行查詢的 DPU (資料處理單位) 總數。
DPUConsumed	在給定的時間，保留區中處於 RUNNING 狀態的查詢主動使用的 DPU 數目。僅當工作群組與容量保留相關聯並包含與保留關聯的所有工作群組時，才會發出這個指標。如果您將工作群組從一個保留區移至另一個保留區，則該指標會包含該工作群組屬於第一個保留區時的資料。如需有關容量保留的詳細資訊，請參閱 管理查詢處理容量。
DPUCount	查詢使用的 DPU 數目上限，僅當查詢完成時發布一次。只有附加至容量保留的工作群組才會發出此指標。
EngineExecutionTime	查詢執行所花費的毫秒數。
ProcessedBytes	Athena 在每次 DML 查詢所掃描的位元組。對於取消的查詢 (無論是由使用者取消，或達到上限時自動取消)，這包括取消前掃描的資料量。DDL 查詢不會報告此指標。
QueryPlanningTime	Athena 規劃查詢處理流程所花費的毫秒數。這包括從資料來源擷取資料表分割區所花費的時間。請注意，由於查詢引擎會執行查詢計劃，因此查詢計劃時間是的子集 EngineExecutionTime。
QueryQueueTime	查詢在查詢佇列中等待資源的毫秒數。請注意，如果發生暫時性錯誤，查詢可能自動加回到佇列。
ServicePreProcessingTime	提交查詢至查詢引擎之前，Athena 預先處理查詢所花費的毫秒數。
ServiceProcessingTime	查詢引擎完成查詢的執行後，Athena 處理查詢結果所花費的毫秒數。
TotalExecutionTime	Athena 執行 DDL 或 DML 查詢所花費的毫秒數。 TotalExecutionTime 包括 QueryQueueTime QueryPlanningTime、 EngineExecutionTime、和 ServiceProcessingTime。

Athena 的這些指標具有下列維度。

維度	描述
CapacityReservation	用於執行查詢的容量保留名稱 (如果適用)。當未使用容量保留時，此維度不會傳回任何資料。
QueryState	查詢狀態。 有效的統計資訊：已成功、已失敗、已取消。
QueryType	查詢類型。 有效的統計資訊：DDL、DML 或 UTILITY。執行的查詢陳述式類型。DDL 表示 DDL (資料定義語言) 查詢陳述式。DML 表示 DML (資料處理語言) 查詢陳述式，例如 CREATE TABLE AS SELECT。UTILITY 表示除 DDL 和 DML 以外的查詢陳述式，例如 SHOW CREATE TABLE 或 DESCRIBE TABLE。
WorkGroup	工作群組的名稱。