本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 檢視排定的查詢執行歷史記錄
<a name="scheduled-queries-execution-history"></a>

使用執行歷史記錄來監控排程查詢的效能，並針對查詢執行或結果交付的任何問題進行疑難排解。

執行歷史記錄會顯示每個查詢執行的狀態，包括成功執行、失敗和目的地處理結果。您可以使用此資訊來識別模式、診斷問題，並確認查詢是否如預期般執行。

------
#### [ Console ]

**檢視執行歷史記錄 （主控台）**

1. 在 CloudWatch Logs 主控台中，選擇**排程查詢**、**檢視排程查詢**。

1. 選取您要檢查的排程查詢。

1. 選擇 **Execution history (執行歷程記錄)** 標記。

------
#### [ AWS CLI ]

**檢視執行歷史記錄 (AWS CLI)**

1. 使用 `get-scheduled-query-history`命令來擷取排程查詢的執行歷史記錄：

   ```
   aws logs get-scheduled-query-history \
       --identifier "DailyErrorMonitoring" \
       --start-time 1743379200 \
       --end-time 1743465600 \
       --max-results 10
   ```

1. 若要依執行狀態篩選，請新增 `--execution-statuses` 參數：

   ```
   aws logs get-scheduled-query-history \
       --identifier "DailyErrorMonitoring" \
       --start-time 1743379200 \
       --end-time 1743465600 \
       --max-results 1 \
       --execution-statuses "SUCCEEDED"
   ```

------
#### [ API ]

**檢視執行歷史記錄 (API)**
+ 使用 `GetScheduledQueryHistory`動作來擷取執行歷史記錄：

  ```
  {
      "identifier": "DailyErrorMonitoring",
      "startTime": 1743379200,
      "endTime": 1743465600,
      "maxResults": 10,
      "executionStatuses": ["SUCCEEDED", "FAILED"]
  }
  ```

------

執行歷史記錄會顯示：
+ **執行狀態** - 執行中、完成、失敗、逾時或 InvalidQuery
+ **觸發時間** - 執行查詢的時間
+ **目的地** - 每個已設定目的地的處理狀態，包括 S3 和 EventBridge
+ **錯誤訊息** - 有關查詢執行或目的地處理中任何失敗的詳細資訊