Visualizzazione della cronologia delle associazioni - AWS Systems Manager

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Visualizzazione della cronologia delle associazioni

È possibile visualizzare tutte le esecuzioni di un ID di associazione specifico utilizzando l'operazione API DescribeAssociationExecutions. Utilizzare questa operazione per vedere lo stato e i relativi dettagli, i risultati, l'ora dell'ultima esecuzione e altre informazioni per un'associazione State Manager. State Manager è una funzionalità diAWS Systems Manager. L'operazione API include inoltre filtri che consentono di individuare le associazioni in base ai criteri specificati. Ad esempio, è possibile specificare una data e un'ora esatte e utilizzare il filtro GREATER_THAN per visualizzare le esecuzioni elaborate dopo la data e l'ora specificate.

Se, per esempio, l'esecuzione di un'associazione ha avuto esito negativo, è possibile esaminare i dettagli di un'esecuzione specifica tramite l'operazione API DescribeAssociationExecutionTargets. Questa operazione mostra le risorse, come gli ID di nodo, in cui l'associazione è stata eseguita e i diversi stati dell'associazione. Puoi quindi visualizzare la risorsa o il nodo che non è riuscito a eseguire un'associazione. Mediante l'ID risorsa puoi visualizzare i dettagli di esecuzione del comando per vedere quale passaggio del comando ha avuto esito negativo.

Gli esempi in questa sezione includono anche informazioni su come utilizzare l'operazione API StartAssociationsOnce per eseguire un'associazione una volta al momento della creazione. Puoi utilizzare questa operazione API per esaminare le esecuzioni di associazioni con esito negativo. Se vedi un'associazione non riuscita, puoi modificare la risorsa ed eseguire immediatamente l'associazione per verificare se la modifica alla risorsa consente la corretta esecuzione dell'associazione.

Nota

Le operazioni API avviate dal documento SSM durante un'esecuzione di associazione non vengono registrate in AWS CloudTrail.

Visualizzazione della cronologia delle associazioni (console)

Segui la procedura riportata sotto per visualizzare la cronologia delle esecuzioni di un ID associazione specifico e visualizzare i dettagli delle esecuzioni per una o più risorse.

Per visualizzare la cronologia di esecuzioni per un ID associazione specifico
  1. Apri la console AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Scegli State Manager.

  3. Nel campo Association id (ID associazione), scegliere un'associazione di cui si desidera visualizzare la cronologia.

  4. Selezionare il pulsante View details (Visualizza dettagli).

  5. Scegliere la scheda Execution history (Cronologia esecuzioni).

  6. Scegliere un'associazione di cui si desidera visualizzare i dettagli delle esecuzioni a livello di risorsa. Ad esempio, scegliere un'associazione che mostri uno stato Failed (Non riuscito). È possibile quindi visualizzare i dettagli delle esecuzioni per i nodi che non sono riusciti a eseguire l'associazione.

    Utilizzare i filtri della casella di ricerca per individuare l'esecuzione di cui visualizzare i dettagli.

    Filtraggio dell'elenco delle esecuzioni di associazioni State Manager
  7. Scegliere un ID di esecuzione. Viene aperta la pagina Association execution targets (Target di esecuzione dell'associazione. In questa pagina sono mostrate tutte le risorse che hanno eseguito l'associazione.

  8. Scegliere un ID risorsa per visualizzare informazioni specifiche sulla risorsa.

    Utilizzare i filtri della casella di ricerca per individuare la risorsa di cui visualizzare i dettagli.

    Filtraggio dell'elenco di target delle esecuzioni di associazioni State Manager.
  9. Se si sta esaminando un'associazione che non è stato possibile eseguire, è possibile utilizzare il pulsante Apply association now (Applica associazione) per eseguire un'associazione una volta al momento della creazione. Dopo avere effettuato le modifiche alla risorsa in cui non è stato possibile eseguire l'associazione, scegliere il collegamento Association ID (ID associazione) nel percorso di navigazione.

  10. Scegliere il pulsante Apply association now (Applica associazione). Dopo il completamento dell'esecuzione, verificare che l'associazione sia stata eseguita correttamente.

Visualizzazione della cronologia delle associazioni (riga di comando)

La procedura seguente descrive come utilizzare il AWS Command Line Interface (AWS CLI) (su Linux o Windows) o AWS Tools for PowerShell per visualizzare la cronologia delle esecuzioni per un ID di associazione specifico. In seguito, la procedura descrive come visualizzare i dettagli di esecuzione per una o più risorse.

Per visualizzare la cronologia di esecuzioni per un ID associazione specifico
  1. Se non è stato ancora fatto, installare e configurare il AWS CLI o il AWS Tools for PowerShell.

    Per informazioni, consulta le pagine Installazione o aggiornamento della versione più recente di AWS CLI e Installazione di AWS Tools for PowerShell.

  2. Eseguire il comando riportato sotto per visualizzare un elenco di esecuzioni per un ID associazione specifico.

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

    Questo comando include un filtro per limitare i risultati solo alle esecuzioni che si sono verificate dopo una data e un'ora specifiche. Per visualizzare tutte le esecuzioni per un determinato ID associazione, rimuovere il parametro --filters e il valore 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

    Questo comando include un filtro per limitare i risultati solo alle esecuzioni che si sono verificate dopo una data e un'ora specifiche. Per visualizzare tutte le esecuzioni per un determinato ID associazione, rimuovere il parametro --filters e il valore 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

    Questo comando include un filtro per limitare i risultati solo alle esecuzioni che si sono verificate dopo una data e un'ora specifiche. Per visualizzare tutte le esecuzioni per un determinato ID associazione, rimuovere il parametro -Filter e il valore @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}.

    Il sistema restituisce informazioni simili alle seguenti.

    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

    È possibile limitare i risultati utilizzando uno o più filtri. L'esempio seguente restituisce tutte le associazioni eseguite prima di una data e un'ora specifiche.

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

    L'esempio seguente restituisce tutte le associazioni eseguite correttamente dopo una data e un'ora specifiche.

    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. Eseguire il comando riportato seguente per visualizzare tutti i target in cui l'associazione specifica è stata eseguita.

    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

    È possibile limitare i risultati utilizzando uno o più filtri. L'esempio seguente restituisce informazioni su tutti i target in cui l'associazione specifica non è stata eseguita.

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

    L'esempio seguente restituisce informazioni su un nodo gestito specifico in cui un'associazione non è stata eseguita.

    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 si sta esaminando un'associazione che non è stato possibile eseguire, è possibile utilizzare l'operazione API StartAssociationsOnce per eseguire un'associazione immediatamente e una sola volta. Dopo aver modificato la risorsa in cui non è stato possibile eseguire l'associazione, eseguire il comando riportato sotto per eseguire l'associazione immediatamente e una sola volta.

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