AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

查看关联历史记录

您可以使用 DescribeAssociationExecutions API 操作查看特定关联 ID 的所有执行。此操作可让您快速查看 状态管理器 关联的状态、详细状态、结果、上次执行时间以及其他信息。此 API 操作还包括筛选器,帮助您根据指定的条件快速找到关联。例如,您可以指定一个确切的日期和时间,并使用 GREATER_THAN 筛选器以仅查看在该指定的日期和时间之后处理的那些执行。

例如,如果一个关联执行失败,则可使用 DescribeAssociationExecutionTargets API 操作来深入了解特定执行的详细信息。此操作将为您显示资源,例如实例 ID、关联运行的位置和各种关联状态。随后,您可以快速查看哪些资源或实例无法运行关联。利用资源 ID,您随后可以查看命令执行详细信息,以准确了解命令中的哪个步骤已失败。

此部分中的示例还包括有关如何使用 StartAssociationsOnce API 操作立即运行且仅运行一次关联的信息。在调查失败的关联执行时,可以使用此 API 操作。如果发现一个关联失败,则可以在资源上进行更改,然后立即运行关联以查看对资源所做的更改是否可让关联成功运行。

使用 Systems Manager 控制台查看关联历史记录

使用以下过程可查看特定关联 ID 的执行历史记录,然后查看一个或多个资源的执行详细信息。

查看特定关联 ID 的执行历史记录

  1. https://console.www.amazonaws.cn/systems-manager/ 上打开 AWS Systems Manager 控制台。

  2. 选择 状态管理器

  3. Association id (关联 ID) 字段中,选择要查看其历史记录的关联。

  4. 选择 View details (查看详细信息) 按钮。

  5. 选择 Execution history (执行历史记录) 选项卡。

  6. 选择要查看其资源级别执行详细信息的关联。例如,选择显示 Failed (失败) 状态的关联。然后,您可以查看无法运行关联的实例的执行详细信息。

    注意

    使用搜索框筛选条件以找到要查看其详细信息的执行。

     筛选 State Manager 关联执行的列表。
  7. 选择执行 ID。此时将打开 Association execution targets (关联执行目标) 页面。此页面显示所有已运行关联的资源。

  8. 选择一个资源 ID 以查看有关此资源的特定信息。

    注意

    使用搜索框筛选条件以找到要查看其详细信息的资源。

     筛选 State Manager 关联执行目标的列表。
  9. 如果您正在调查无法运行的关联,则可使用 Apply association now (立即应用关联) 按钮来立即运行且仅运行一次关联。在对无法运行关联的资源进行更改后,在导航位置提示中选择 Association ID (关联 ID) 链接。

  10. 选择 Apply association now (立即应用关联) 按钮。在执行完成后,验证关联执行是否成功。

使用 AWS CLI 查看关联历史记录

使用以下过程可查看特定关联 ID 的执行历史记录,然后查看一个或多个资源的执行详细信息。

查看特定关联 ID 的执行历史记录

  1. 在您的本地计算机上,下载最新版本的 AWS CLI。

  2. 打开 AWS CLI 并运行以下命令指定您的凭证和区域。

    aws configure

    系统将提示您指定以下内容。

    AWS Access Key ID [None]: key_name AWS Secret Access Key [None]: key_name Default region name [None]: region Default output format [None]: ENTER
  3. 执行以下命令以查看特定关联 ID 的执行列表。此命令包含一个筛选器,可将结果限定为仅在特定日期和时间之后发生的那些执行。如果您希望查看特定关联 ID 的所有执行,请删除 --filter parameter.

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

    系统将返回类似于以下内容的信息。

    { "AssociationExecutions":[ { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"12345-abcdef-6789-ghij", "ExecutionId":"abcde-12345-fghi-6789", "CreatedTime":1523986028.219, "AssociationVersion":"1" }, { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"12345-abcdef-6789-ghij", "ExecutionId":"zzzz-333-xxxx-4444", "CreatedTime":1523984226.074, "AssociationVersion":"1" }, { "Status":"Success", "DetailedStatus":"Success", "AssociationId":"12345-abcdef-6789-ghij", "ExecutionId":"4545-a4a4a4-3636", "CreatedTime":1523982404.013, "AssociationVersion":"1" } ] }

    您可以使用一个或多个筛选条件来限制结果。以下示例返回在特定日期和时间之前运行的所有关联。

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

    下面返回在特定日期和时间之后成功 运行的所有关联。

    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
  4. 执行以下命令可查看已运行特定执行的所有目标。

    aws ssm describe-association-execution-targets --association-id ID --execution-id ID

    您可以使用一个或多个筛选条件来限制结果。以下示例返回有关所有无法运行特定关联的目标的信息。

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

    以下示例返回有关无法运行关联的特定托管实例的信息。

    aws ssm describe-association-execution-targets --association-id ID --execution-id ID --filters Key=Status,Value=Failed Key=ResourceId,Value="instance ID" Key=ResourceType,Value=ManagedInstance
  5. 如果您正在调查无法运行的关联,则可使用 StartAssociationsOnce API 操作来立即运行且仅运行一次关联。在对无法运行关联的资源进行更改后,运行以下命令可立即运行且仅运行一次关联。

    aws ssm start-associations-once --association-id ID