• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Visualización de los historiales de asociación
Puede ver todas las ejecuciones correspondientes a un ID de asociación específico mediante la operación [DescribeAssociationExecutions](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeAssociationExecutions.html) de la API. Utilice esta operación para ver el estado, el estado detallado, los resultados, la hora de la última ejecución y para obtener más información acerca de una asociación de State Manager. State Manager es una herramienta de AWS Systems Manager. Esta operación de la API también incluye filtros para ayudarlo a encontrar las asociaciones que cumplan los criterios que especifique. Por ejemplo, puede especificar una fecha y hora exactas y utilizar un filtro GREATER\_THAN para ver las ejecuciones que se procesaron después dicha fecha y hora.
Si, por ejemplo, se produce un error en la ejecución de una asociación, puede desglosar los detalles de una ejecución específica mediante la operación [DescribeAssociationExecutionTargets](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeAssociationExecutionTargets.html) de la API. Esta operación muestra los recursos, como, por ejemplo, los ID de nodo, en los que se ejecutó la asociación y los diferentes estados de la asociación. A continuación, puede ver en qué recurso o nodo no se pudo ejecutar la asociación. Con el ID de recurso puede ver los detalles de la ejecución del comando para ver en qué paso de un comando se ha producido el error.
En los ejemplos de esta sección, también se incluye información sobre cómo utilizar la operación [StartAssociationsOnce](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartAssociationsOnce.html) de la API para ejecutar una asociación una sola vez al momento de la creación. Puede utilizar esta operación de la API cuando investigue ejecuciones de asociaciones que produzcan errores. Si ve que se ha producido un error en una asociación, puede hacer un cambio en el recurso y, a continuación, ejecutar inmediatamente la asociación para ver si el cambio en el recurso permite que la asociación se ejecute correctamente.
**nota**
Las operaciones de la API que inicia el documento SSM durante la ejecución de una asociación no se registran en AWS CloudTrail.
## Visualización de los historiales de asociación (consola)
Utilice el siguiente procedimiento para ver el historial de ejecución de un ID de asociación específico y, a continuación, los detalles de ejecución de uno o varios recursos.
**Para ver el historial de ejecución de un ID de asociación específico**
1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Elija **State Manager**.
1. En el campo **Association id (ID de asociación)**, elija la asociación cuyo historial desea ver.
1. Elija el botón **View details (Ver detalles)**.
1. Elija la pestaña **Execution history (Historial de ejecución)**.
1. Elija la asociación para la que desea ver los detalles de ejecución en el nivel de recursos. Por ejemplo, elija una asociación con el estado **Failed (Error)**. Una vez hecho esto, podrá ver los detalles de ejecución para los nodos en que no se pudo ejecutar la asociación.
Utilice los filtros del cuadro de búsqueda para localizar la ejecución cuyos detalles desea ver.
1. Elija un ID de ejecución. Se abre la página **Association execution targets (Destinos de la ejecución de la asociación)**. Esta página muestra todos los recursos en que se ha ejecutado la asociación.
1. Elija un ID de recurso para ver información específica sobre dicho recurso.
Utilice los filtros del cuadro de búsqueda para localizar el recurso cuyos detalles desea ver.
1. Si está investigando una asociación que no se ha podido ejecutar, puede utilizar el botón **Apply association now** (Aplicar asociación ahora) para ejecutar una asociación una sola vez al momento de la creación. Una vez que haya realizado los cambios en el recurso en que no se pudo ejecutar la asociación, elija el enlace **Association ID (ID de asociación)** en la ruta de navegación.
1. Haga clic en el botón **Apply association now (Aplicar asociación ahora)**. Cuando finalice la ejecución, verifique que la ejecución de la asociación se ha realizado correctamente.
## Visualización de los historiales de asociación (línea de comandos)
En el siguiente procedimiento se describe cómo utilizar la AWS Command Line Interface (AWS CLI) (en Linux o Windows Server) o Herramientas de AWS para PowerShell para ver el historial de ejecución de un ID de asociación determinado. A continuación, el procedimiento describe cómo ver los detalles de ejecución de uno o varios recursos.
**Para ver el historial de ejecución de un ID de asociación específico**
1. Si aún no lo ha hecho, instale y configure la AWS CLI o Herramientas de AWS para PowerShell.
Para obtener información, consulte [Instalación o actualización de la última versión de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Instalación de Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html).
1. Ejecute el siguiente comando para ver una lista de las ejecuciones de un determinado ID de asociación.
------
#### [ Linux & macOS ]
```
aws ssm describe-association-executions \
--association-id {{ID}} \
--filters Key=CreatedTime,Value="2018-04-10T19:15:38.372Z",Type=GREATER_THAN
```
**nota**
Este comando incluye un filtro para limitar los resultados únicamente a las ejecuciones que han tenido lugar después de una fecha y hora determinadas. Si desea ver todas las ejecuciones de un ID de asociación específico, elimine el parámetro `--filters` y el 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**
Este comando incluye un filtro para limitar los resultados únicamente a las ejecuciones que han tenido lugar después de una fecha y hora determinadas. Si desea ver todas las ejecuciones de un ID de asociación específico, elimine el parámetro `--filters` y el 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**
Este comando incluye un filtro para limitar los resultados únicamente a las ejecuciones que han tenido lugar después de una fecha y hora determinadas. Si desea ver todas las ejecuciones de un ID de asociación específico, elimine el parámetro `-Filter` y el valor ` @{"Key"="CreatedTime";"Value"="2019-06-01T19:15:38.372Z";"Type"="GREATER_THAN"}`.
------
El sistema devuelve información similar a la siguiente.
------
#### [ 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
```
------
Puede limitar los resultados mediante el uso de uno o varios filtros. En el siguiente ejemplo, se devuelven todas las asociaciones que se ejecutaron antes de una fecha y hora determinada.
------
#### [ 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"}
```
------
El comando siguiente devuelve todas las asociaciones que se ejecutaron *correctamente* después de una fecha y hora determinadas.
------
#### [ 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. Ejecute el comando siguiente para ver todos los destinos a los que se aplicó una ejecución específica.
------
#### [ 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}}
```
------
Puede limitar los resultados mediante el uso de uno o varios filtros. En el ejemplo siguiente, se devuelve información sobre todos los destinos en que no se pudo ejecutar la asociación específica.
------
#### [ 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"
}
```
------
En el ejemplo siguiente, se devuelve información sobre un nodo administrado específico en que no se pudo ejecutar una asociación.
------
#### [ 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. Si está investigando una asociación que no se ha podido ejecutar, puede utilizar la operación [StartAssociationsOnce](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartAssociationsOnce.html) de la API para ejecutar una asociación inmediatamente una sola vez. Después de cambiar el recurso en el que no se pudo ejecutar la asociación, ejecute el comando siguiente para ejecutar la asociación inmediatamente una sola 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}}
```
------