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 de la API. Utilice esta operación para ver el estado, el estado detallado, los resultados, el momento de la última ejecución y para obtener más información acerca de una asociación de State Manager. State Manager es una capacidad 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 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 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
Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/
. -
Elija State Manager.
-
En el campo Association id (ID de asociación), elija la asociación cuyo historial desea ver.
-
Elija el botón View details (Ver detalles).
-
Elija la pestaña Execution history (Historial de ejecución).
-
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.
-
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.
-
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.
-
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.
-
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) o AWS Tools for 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
Si aún no lo ha hecho, instale y configure la AWS CLI o AWS Tools for PowerShell.
Para obtener información, consulte Instalación o actualización de la última versión de la AWS CLI e Instalación de AWS Tools for PowerShell.
-
Ejecute el siguiente comando para ver una lista de las ejecuciones de un determinado ID de asociación.
El sistema devuelve información similar a la siguiente.
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.
El comando siguiente devuelve todas las asociaciones que se ejecutaron correctamente después de una fecha y hora determinadas.
-
Ejecute el comando siguiente para ver todos los destinos a los que se aplicó una ejecución específica.
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.
En el ejemplo siguiente, se devuelve información sobre un nodo administrado específico en que no se pudo ejecutar una asociación.
-
Si está investigando una asociación que no se ha podido ejecutar, puede utilizar la operación StartAssociationsOnce 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.
