• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

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

# 檢視關聯歷史記錄
<a name="state-manager-associations-history"></a>

您可以使用 [DescribeAssociationExecutions](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeAssociationExecutions.html) API 操作來檢視特定關聯 ID 的所有執行。使用此操作來查看 State Manager 關聯的狀態、詳細狀態、結果、最後執行時間以及詳細資訊。State Manager 是 AWS Systems Manager中的工具。此 API 操作還包括篩選條件，可協助您依據指定的條件找出關聯。例如，您可以指定確切的日期和時間，並使用 GREATER\_THAN (大於) 篩選條件來檢視指定日期和時間之後處理的執行。

例如，如果關聯執行失敗，您可以使用 [DescribeAssociationExecutionTargets](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeAssociationExecutionTargets.html) API 操作，深入探索特定執行的詳細資訊。此操作會顯示資源，例如節點 ID、關聯執行的位置和各種關聯狀態。接著，您可以查看哪些資源或節點無法執行關聯。透過資源 ID，您可以檢視命令執行詳細資訊，以查看命令中的哪一個步驟失敗。

本節中的範例也包括有關如何使用 [StartAssociationsOnce](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartAssociationsOnce.html) API 操作在建立時執行一次關聯的相關資訊。您可以使用此 API 操作來調查失敗的關聯執行。若您看到關聯失敗，您可以對資源進行變更，然後立即執行關聯來查看資源上的變更是否允許關聯成功執行。

**注意**  
在關聯執行期間由 SSM 文件啟動的 API 操作不會記錄在 AWS CloudTrail中。

## 檢視關聯歷史記錄 (主控台)
<a name="state-manager-associations-history-console"></a>

使用以下程序來檢視特定關聯 ID 的執行歷史記錄，然後檢視一或多個資源的執行詳細資訊。

**檢視特定關聯 ID 的執行歷史記錄**

1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。

1. 選擇 **State Manager**。

1. 在 **Association id (關聯 ID)** 欄位中，選擇您想檢視歷程記錄的關聯。

1. 選擇 **View details (檢視詳細資訊)** 按鈕。

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

1. 選擇您想檢視資源層級執行詳細資訊的關聯。例如，選擇狀態顯示為 **Failed (失敗)** 的關聯。接著，您可以檢視執行關聯失敗的節點的執行詳細資訊。

   使用搜尋方框篩選條件，找出您想檢視詳細資訊的執行。  
![篩選 State Manager 關聯執行清單。](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/sysman-state-executions-filter.png)

1. 選擇執行 ID。**Association execution targets (關聯執行目標)** 頁面隨即開啟。此頁面會顯示執行該關聯的所有資源。

1. 選擇資源 ID 來檢視該資源的特定資訊。

   使用搜尋方框篩選條件，找出您想檢視詳細資訊的資源。  
![篩選 State Manager 關聯執行目標的清單。](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/sysman-state-executions-targets-filter.png)

1. 如果您正在調查執行失敗的關聯，您可以使用 **Apply association now** (立即套用關聯) 按鈕，以便在建立時執行一次關聯。在您對執行關聯失敗的資源進行變更後，選擇導覽導航列中的 **Association ID (關聯 ID)** 連結。

1. 選擇 **Apply association now (立即套用關聯)** 按鈕。在執行完成後，驗證關聯執行已成功。

## 檢視關聯歷史記錄 (命令列)
<a name="state-manager-associations-history-commandline"></a>

下列程序說明如何使用 AWS Command Line Interface (AWS CLI) （在 Linux 或 上Windows Server) AWS Tools for PowerShell 或 檢視特定關聯 ID 的執行歷史記錄。在這之後，程序會說明如何檢視一或多個資源的執行詳細資訊。

**檢視特定關聯 ID 的執行歷史記錄**

1.  AWS Tools for PowerShell如果您尚未安裝和設定 AWS CLI 或 。

   如需相關資訊，請參閱[安裝或更新 AWS CLI的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)和[安裝 AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html)。

1. 執行以下命令來檢視特定關聯 ID 的執行清單。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-executions \
     --association-id {{ID}} \
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN
   ```

**注意**  
此命令包含篩選條件，可將篩選結果為僅限在特定日期和時間之後發生的執行。若要檢視特定關聯 ID 的所有執行，請移除 `--filters` 參數和 ` Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN` 值。

------
#### [ Windows ]

   ```
   aws ssm describe-association-executions ^
     --association-id {{ID}} ^
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN
   ```

**注意**  
此命令包含篩選條件，可將篩選結果為僅限在特定日期和時間之後發生的執行。若要檢視特定關聯 ID 的所有執行，請移除 `--filters` 參數和 ` Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN` 值。

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecution `
     -AssociationId {{ID}} `
     -Filter @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}
   ```

**注意**  
此命令包含篩選條件，可將篩選結果為僅限在特定日期和時間之後發生的執行。若要檢視特定關聯 ID 的所有執行，請移除 `-Filter` 參數和 ` @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}` 值。

------

   系統會傳回如下資訊。

------
#### [ Linux & macOS ]

   ```
   {
      "AssociationExecutions":[
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"76a5a04f-caf6-490c-b448-92c02EXAMPLE",
            "CreatedTime":1523986028.219,
            "AssociationVersion":"1"
         },
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE",
            "CreatedTime":1523984226.074,
            "AssociationVersion":"1"
         },
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"ecec60fa-6bb0-4d26-98c7-140308EXAMPLE",
            "CreatedTime":1523982404.013,
            "AssociationVersion":"1"
         }
      ]
   }
   ```

------
#### [ Windows ]

   ```
   {
      "AssociationExecutions":[
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"76a5a04f-caf6-490c-b448-92c02EXAMPLE",
            "CreatedTime":1523986028.219,
            "AssociationVersion":"1"
         },
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE",
            "CreatedTime":1523984226.074,
            "AssociationVersion":"1"
         },
         {
            "Status":"Success",
            "DetailedStatus":"Success",
            "AssociationId":"c336d2ab-09de-44ba-8f6a-6136cEXAMPLE",
            "ExecutionId":"ecec60fa-6bb0-4d26-98c7-140308EXAMPLE",
            "CreatedTime":1523982404.013,
            "AssociationVersion":"1"
         }
      ]
   }
   ```

------
#### [ PowerShell ]

   ```
   AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
   AssociationVersion    : 1
   CreatedTime           : 8/18/2019 2:00:50 AM
   DetailedStatus        : Success
   ExecutionId           : 76a5a04f-caf6-490c-b448-92c02EXAMPLE
   LastExecutionDate     : 1/1/0001 12:00:00 AM
   ResourceCountByStatus : {Success=1}
   Status                : Success
   
   AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
   AssociationVersion    : 1
   CreatedTime           : 8/11/2019 2:00:54 AM
   DetailedStatus        : Success
   ExecutionId           : 791b72e0-f0da-4021-8b35-f95dfEXAMPLE
   LastExecutionDate     : 1/1/0001 12:00:00 AM
   ResourceCountByStatus : {Success=1}
   Status                : Success
   
   AssociationId         : c336d2ab-09de-44ba-8f6a-6136cEXAMPLE
   AssociationVersion    : 1
   CreatedTime           : 8/4/2019 2:01:00 AM
   DetailedStatus        : Success
   ExecutionId           : ecec60fa-6bb0-4d26-98c7-140308EXAMPLE
   LastExecutionDate     : 1/1/0001 12:00:00 AM
   ResourceCountByStatus : {Success=1}
   Status                : Success
   ```

------

   您可以使用一或多個篩選條件來限制結果。以下範例傳回所有於特定日期和時間之前執行的關聯。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-executions \
     --association-id {{ID}} \
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THAN
   ```

------
#### [ Windows ]

   ```
   aws ssm describe-association-executions ^
     --association-id {{ID}} ^
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=LESS_THAN
   ```

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecution `
     -AssociationId {{14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE}} `
     -Filter @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="LESS_THAN"}
   ```

------

   以下範例傳回所有於特定日期和時間之後*成功*執行的關聯。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-executions \
     --association-id {{ID}} \
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN Key=Status,Value=Success,Type=EQUAL
   ```

------
#### [ Windows ]

   ```
   aws ssm describe-association-executions ^
     --association-id {{ID}} ^
     --filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN Key=Status,Value=Success,Type=EQUAL
   ```

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecution `
     -AssociationId {{14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE}} `
     -Filter @{
         "Key"="CreatedTime";
         "Value"="2019-06-01T19:15:38.372Z";
         "Type"="GREATER_THAN"
       },
       @{
         "Key"="Status";
         "Value"="Success";
         "Type"="EQUAL"
       }
   ```

------

1. 執行以下命令來檢視執行特定執行的所有目標。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-execution-targets \
     --association-id {{ID}} \
     --execution-id {{ID}}
   ```

------
#### [ Windows ]

   ```
   aws ssm describe-association-execution-targets ^
     --association-id {{ID}} ^
     --execution-id {{ID}}
   ```

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecutionTarget `
     -AssociationId {{14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE}} `
     -ExecutionId {{76a5a04f-caf6-490c-b448-92c02EXAMPLE}}
   ```

------

   您可以使用一或多個篩選條件來限制結果。以下範例傳回所有執行特定關聯失敗的目標相關資訊。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-execution-targets \
     --association-id {{ID}} \
     --execution-id {{ID}} \
     --filters Key=Status,Value="Failed"
   ```

------
#### [ Windows ]

   ```
   aws ssm describe-association-execution-targets ^
     --association-id {{ID}} ^
     --execution-id {{ID}} ^
     --filters Key=Status,Value="Failed"
   ```

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecutionTarget `
     -AssociationId {{14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE}} `
     -ExecutionId {{76a5a04f-caf6-490c-b448-92c02EXAMPLE}} `
     -Filter @{
         "Key"="Status";
         "Value"="Failed"
       }
   ```

------

   以下範例傳回執行關聯失敗的特定受管節點相關資訊。

------
#### [ Linux & macOS ]

   ```
   aws ssm describe-association-execution-targets \
     --association-id {{ID}} \
     --execution-id {{ID}} \
     --filters Key=Status,Value=Failed Key=ResourceId,Value="{{i-02573cafcfEXAMPLE}}" Key=ResourceType,Value=ManagedInstance
   ```

------
#### [ Windows ]

   ```
   aws ssm describe-association-execution-targets ^
     --association-id {{ID}} ^
     --execution-id {{ID}} ^
     --filters Key=Status,Value=Failed Key=ResourceId,Value="{{i-02573cafcfEXAMPLE}}" Key=ResourceType,Value=ManagedInstance
   ```

------
#### [ PowerShell ]

   ```
   Get-SSMAssociationExecutionTarget `
     -AssociationId {{14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE}} `
     -ExecutionId {{76a5a04f-caf6-490c-b448-92c02EXAMPLE}} `
     -Filter @{
         "Key"="Status";
         "Value"="Success"
       },
       @{
         "Key"="ResourceId";
         "Value"="{{i-02573cafcfEXAMPLE}}"
       },
       @{
         "Key"="ResourceType";
         "Value"="ManagedInstance"
       }
   ```

------

1. 若您正在調查執行失敗的關聯，您可以使用 [StartAssociationsOnce](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartAssociationsOnce.html) API 操作來立即執行關聯 (僅限一次)。在您變更關聯執行失敗的資源後，請執行以下命令來立即執行關聯，並僅限一次。

------
#### [ Linux & macOS ]

   ```
   aws ssm start-associations-once \
     --association-id {{ID}}
   ```

------
#### [ Windows ]

   ```
   aws ssm start-associations-once ^
     --association-id {{ID}}
   ```

------
#### [ PowerShell ]

   ```
   Start-SSMAssociationsOnce `
     -AssociationId {{ID}}
   ```

------