Visualizar históricos de associação - AWS Systems Manager
Visualizar históricos de associação (console)Visualizar históricos de associação (linha de comando)

Visualizar históricos de associação

Você pode visualizar todas as execuções de determinado ID de associação usando a operação de API DescribeAssociationExecutions. Use esta operação para ver o status, o status detalhado, os resultados, o runtime mais recente e outras informações sobre uma associação do State Manager. O State Manager é um recurso do AWS Systems Manager. Essa operação de API também inclui filtros para ajudá-lo a localizar as associações de acordo com os critérios que você especifica. Por exemplo, você pode especificar uma data e hora e usar o filtro GREATER_THAN para visualizar as execuções processadas após a data e a hora especificadas.

Se, por exemplo, uma execução de associação falhou, você pode analisar os detalhes de determinada execução usando a operação de API DescribeAssociationExecutionTargets. Essa operação mostra os recursos, como IDs de nós, nos quais a associação executou e os vários status de associação. Assim você pode ver qual recurso ou nó não conseguiu executar uma associação. Com o ID do recurso, você pode visualizar os detalhes da execução do comando para ver qual etapa falhou em um comando.

Os exemplos desta seção também incluem informações sobre como usar a operação de API StartAssociationsOnce para executar uma associação uma vez no momento da criação. Você pode usar essa opração de API quando investigar execuções de associação com falha. Se você vir que uma associação falhou, poderá fazer uma alteração no recurso e, em seguida, executar imediatamente a associação para ver se a alteração no recurso faz com que a associação seja executada com êxito.

nota

As operações de API iniciadas pelo documento SSM durante uma execução de associação não são registradas em log no AWS CloudTrail.

Visualizar históricos de associação (console)

Use o seguinte procedimento para visualizar o histórico de execução de determinado ID de associação e, em seguida, visualizar os detalhes da execução de um ou mais recursos.

Para visualizar o histórico de execução de determinado ID de associação

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. Selecione State Manager.

  3. No campo Association id (ID da associação), escolha uma associação cujo histórico você deseja visualizar.

  4. Escolha o botão View details (Visualizar detalhes).

  5. Escolha a guia Execution history (Histórico de execução).

  6. Escolha uma associação da qual você deseja visualizar os detalhes da execução no nível de recurso. Por exemplo, escolha uma associação que mostra um status de Failed (Com falha). Em seguida, você pode visualizar os detalhes de execução dos nós que não conseguiram executar a associação.

    Use os filtros da caixa de pesquisa para localizar a execução cujos detalhes você deseja visualizar.

    Filtrar a lista de execuções de associações do State Manager.

  7. Escolha um ID de execução. A página Association execution targets (Destinos de execução da associação) é aberta. Essa página mostra todos os recursos que executaram a associação.

  8. Escolha um ID de recurso para visualizar as informações específicas sobre esse recurso.

    Use os filtros da caixa de pesquisa para localizar o recurso cujos detalhes você deseja visualizar.

    Filtrar a lista de destinos de execuções de associações do State Manager.

  9. Se você está investigando uma associação que não foi executada, pode usar o botão Apply association now (Aplicar associação agora) para executar uma associação uma vez no momento da criação. Depois que você fizer alterações no recurso que não conseguiu executar a associação, escolha o link Association ID (ID da associação) na navegação estruturada.

  10. Escolha o botão Apply association now (Aplicar associação agora). Após a execução ser concluída, verifique se a execução da associação foi bem-sucedida.

Visualizar históricos de associação (linha de comando)

O procedimento a seguir descreve como usar a AWS Command Line Interface (AWS CLI) (no Linux ou no Windows) ou o AWS Tools for PowerShell para visualizar o histórico de execução de um ID de associação específico. Depois disso, o procedimento descreve como visualizar detalhes de execução de um ou mais recursos.

Para visualizar o histórico de execução de determinado ID de associação

  1. Instale e configure a AWS CLI ou o AWS Tools for PowerShell, caso ainda não o tenha feito.

    Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI e Instalar o AWS Tools for PowerShell.

  2. Execute o comando a seguir para visualizar uma lista de execuções para determinado ID de associação.

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

    Esse comando inclui um filtro para limitar os resultados somente para as execuções que ocorreram após uma data e hora específicas. Para visualizar todas as execuções de um determinado ID de associação, remova o parâmetro --filters e o valor 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
    nota

    Esse comando inclui um filtro para limitar os resultados somente para as execuções que ocorreram após uma data e hora específicas. Para visualizar todas as execuções de um determinado ID de associação, remova o parâmetro --filters e o valor 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"}
    nota

    Esse comando inclui um filtro para limitar os resultados somente para as execuções que ocorreram após uma data e hora específicas. Para visualizar todas as execuções de um determinado ID de associação, remova o parâmetro -Filter e o valor @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}.

    O sistema retorna informações como estas.

    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

    Você pode limitar os resultados usando um ou mais filtros. O exemplo a seguir retorna todas as associações que foram executadas antes de uma data e hora específicas.

    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"}

    O exemplo a seguir retorna todas as associações que foram executadas com êxito após uma data e hora específicas.

    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"
    }

  3. Execute o seguinte comando para visualizar todos os destinos em que determinada execução foi realizada.

    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

    Você pode limitar os resultados usando um ou mais filtros. O exemplo a seguir retorna informações sobre todos os destinos em que a associação não foi executada.

    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"
    }

    O exemplo a seguir retorna informações sobre determinado nó gerenciado em que uma associação não foi executada.

    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"
    }

  4. Se você está investigando uma associação que não foi executada, pode usar a operação de API StartAssociationsOnce para executar uma associação imediatamente, e apenas uma vez. Depois de fazer alterações no recurso no qual a associação falhou, execute o seguinte comando para executar a associação imediatamente e apenas uma vez.

    Linux & macOS
    aws ssm start-associations-once \
  --association-id ID
    Windows
    aws ssm start-associations-once ^
  --association-id ID
    PowerShell
    Start-SSMAssociationsOnce `
  -AssociationId ID