Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Utilice los documentos SSM de Systems Manager con AWS ARREGLA
AWS El FIS admite tipos de errores personalizados a través del agente AWS Systems Manager SSM y la acción del FIS. AWS [aws:ssm:send-command](fis-actions-reference.md#ssm-send-command) Pre-configured Los documentos SSM de Systems Manager (documentos SSM) que se pueden utilizar para crear acciones comunes de inyección de errores están disponibles como AWS documentos públicos que comienzan con el prefijo AWSFIS-.
SSM Agent es software de Amazon que se puede instalar y configurar en instancias de Amazon EC2, en servidores en las instalaciones o en máquinas virtuales (VM). Esto posibilita que Systems Manager administre estos recursos. Agent procesa las solicitudes de Systems Manager y, a continuación, las ejecuta como se especifica en la solicitud. Puede incluir su propio documento SSM para detectar errores personalizados o hacer referencia a uno de los documentos públicos. Amazon-owned
**Requisitos**
Para las acciones que requieren que SSM Agent ejecute la acción en el destino, debe asegurarse de lo siguiente:
+ Agent está instalado en el destino. De forma predeterminada, SSM Agent se instala en algunas imágenes de máquina de Amazon (AMI). Si no, puede instalar SSM Agent en sus instancias. Para obtener más información, consulte [Instalación manual de SSM Agent en instancias de EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) en la *Guía del usuario de AWS Systems Manager *.
+ Systems Manager tiene permiso para realizar acciones en sus instancias. Puede otorgar acceso con un perfil de instancia de IAM. Para obtener más información, consulte [Creación de un perfil de instancia de IAM para Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-profile.html) y [Adjuntar un perfil de instancia de IAM a una instancia de EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-launch-managed-instance.html) en la *Guía del usuario de AWS Systems Manager *.
## Use la aws:ssm:send-command acción
Un documento de SSM define las acciones que Systems Manager realiza en las instancias administradas. Systems Manager incluye una serie de documentos preconfigurados, o también puede crear los suyos propios. Para obtener más información sobre cómo crear su propio documento de SSM, consulte [Creación de documentos de Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/create-ssm-doc.html) en la *Guía del usuario de AWS Systems Manager *. Para obtener más información sobre los documentos de SSM en general, consulte [Documentos de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-ssm-docs.html) en la *Guía del usuario de AWS Systems Manager *.
AWS FIS proporciona documentos SSM preconfigurados. **Puede ver los documentos SSM preconfigurados en Documentos de la consola:. AWS Systems Manager [https://console.aws.amazon.com/systems-manager/documents](https://console.aws.amazon.com/systems-manager/documents)** También puede elegir entre una selección de documentos preconfigurados en la AWS consola FIS. Para obtener más información, consulte [Pre-configured AWS Documentos FIS SSM](#fis-ssm-docs).
Para utilizar un documento SSM en sus experimentos con el AWS FIS, puede utilizar la acción. [aws:ssm:send-command](fis-actions-reference.md#ssm-send-command) Esta acción recupera el documento de SSM especificado en las instancias de destino y lo ejecuta.
Al utilizar la acción `aws:ssm:send-command` en la plantilla de experimento, debe especificar parámetros adicionales para la acción, incluidos los siguientes:
+ **documentArn**: obligatorio. El nombre de recurso de Amazon (ARN) del documento de SSM.
+ **documentParameters**: condicional. Los parámetros obligatorios y opcionales que el documento de SSM acepta. El formato es un objeto JSON con claves que son cadenas, y valores que son cadenas o matrices de cadenas.
+ **documentVersion**: opcional. La versión del documento de SSM que se va a ejecutar.
Puede ver la información de un documento de SSM (incluidos los parámetros del documento) con la consola de Systems Manager o la línea de comandos.
**Para ver información acerca de un documento de SSM con la consola**
1. Abre la AWS Systems Manager consola en. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. En el panel de navegación, elija **Documentos**.
1. Seleccione el documento y elija la pestaña **Detalles**.
**Para ver información acerca de un documento de SSM con la línea de comandos**
Utilice el comando [describe-document](https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-document.html) de SSM.
**Más información sobre el estado de la acción**
El estado de acción del SSM viene determinado por los estados de los [comandos del SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-commands.html).
## Pre-configured AWS Documentos FIS SSM
Puede utilizar documentos FIS SSM AWS preconfigurados con la `aws:ssm:send-command` acción en las plantillas de sus experimentos.
**Requisitos**
+ Los documentos SSM preconfigurados proporcionados por el AWS FIS solo son compatibles con los siguientes sistemas operativos:
+ Amazon Linux 2023, Amazon Linux 2
+ Ubuntu
+ RHEL 8, 9
+ CentOS 9
+ Los documentos SSM preconfigurados proporcionados por la AWS FIS solo son compatibles con las instancias EC2. No se admiten en otros tipos de nodos gestionados, como servidores en las instalaciones.
Para utilizar estos documentos de SSM en experimentos sobre tareas de ECS, utilice las [Acciones de Amazon ECS](fis-actions-reference.md#ecs-actions-reference) correspondientes. Por ejemplo, la acción **aws:ecs:task-cpu-stress** usa el documento AWSFIS-Run-CPU-Stress.
**Topics**
+ [AWSFIS-Run-CPU-Stress](#awsfis-run-cpu-stress)
+ [AWSFIS-Run-Disk-Fill](#awsfis-run-disk-fill)
+ [AWSFIS-Run-IO-Stress](#awsfis-run-io-stress)
+ [AWSFIS-Run-Kill-Process](#awsfis-run-kill-process)
+ [AWSFIS-Run-Memory-Stress](#awsfis-run-memory-stress)
+ [AWSFIS-Run-Network-Blackhole-Port](#awsfis-run-network-blackhole-port)
+ [AWSFIS-Run-Network-Latency](#awsfis-run-network-latency)
+ [AWSFIS-Run-Network-Latency-Sources](#awsfis-run-network-latency-sources)
+ [AWSFIS-Run-Network-Packet-Loss](#awsfis-run-network-packet-loss)
+ [AWSFIS-Run-Network-Packet-Loss-Sources](#awsfis-run-network-packet-loss-sources)
**Diferencia entre la duración de la acción y la duración DurationSeconds AWS Documentos FIS SSM**
Algunos documentos SSM limitan su propio tiempo de ejecución; por ejemplo, algunos de los documentos SSM del FIS AWS preconfigurados utilizan el DurationSeconds parámetro. Como resultado, es necesario especificar dos duraciones independientes en la definición de la acción del FIS: AWS
+ **Action duration**: para los experimentos con una sola acción, la duración de la acción es equivalente a la duración del experimento. En el caso de varias acciones, la duración del experimento depende de la duración de las acciones individuales y del orden en que se ejecuten. AWS El FIS supervisa cada acción hasta que haya transcurrido su duración.
+ Parámetro del documento **DurationSeconds**: la duración, especificada en segundos, durante la que se ejecutará el documento de SSM.
Puede elegir valores diferentes para los dos tipos de duración:
+ **Action duration exceeds DurationSeconds**: La ejecución del documento SSM finaliza antes de que se complete la acción. AWS El FIS espera a que transcurra la duración de la acción antes de iniciar las siguientes acciones.
+ **Action duration is shorter than DurationSeconds**: el documento de SSM continúa con la ejecución una vez completada la acción. Si la ejecución del documento SSM sigue en curso y ha transcurrido la duración de la acción, el estado de la acción se establece en Completada. AWS El FIS solo supervisa la ejecución hasta que transcurra la duración de la acción.
Tenga en cuenta que algunos documentos de SSM tienen duraciones variables. Por ejemplo, los documentos SSM del AWS FIS tienen la opción de instalar requisitos previos, lo que puede prolongar la duración total de la ejecución más allá del parámetro especificado. DurationSeconds Por lo tanto, si establece la duración de la acción y DurationSeconds el mismo valor, es posible que el script SSM se ejecute durante más tiempo que la duración de la acción.
### AWSFIS-Run-CPU-Stress
Ejecuta esfuerzo de la CPU en una instancia con la herramienta **stress-ng**. Utiliza el documento [AWSFIS-Run-CPU-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-CPU-Stress/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-CPU-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-CPU-Stress
**Parámetros de documento**
+ **DurationSeconds**: obligatorio. La duración de la prueba de esfuerzo de la CPU, en segundos.
+ **CPU**: opcional. El número de factores de esfuerzo de la CPU que se van a utilizar. El valor predeterminado es 0, que utiliza todos los factores de esfuerzo de la CPU.
+ **LoadPercent**: opcional. El porcentaje de carga de la CPU de destino, de 0 (sin carga) a 100 (carga completa). El valor predeterminado es 100.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. La dependencia es **stress-ng**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Disk-Fill
Asigna espacio en disco en el volumen raíz de una instancia para simular un error de disco lleno. Utiliza el documento [AWSFIS-Run-Disk-Fill](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Disk-Fill/description)SSM.
Si el experimento en el que se ha introducido este error se detiene, ya sea manualmente o mediante una condición de parada, el AWS FIS intenta revertirlo cancelando el documento SSM en ejecución. Sin embargo, si el disco está lleno al 100 %, ya sea debido al error o al error más la actividad de la aplicación, es posible que Systems Manager no pueda completar la operación de cancelación. Por lo tanto, si necesita detener el experimento, asegúrese de que el disco no se llene al 100 %.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Disk-Fill
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Disk-Fill
**Parámetros de documento**
+ **DurationSeconds**: obligatorio. La duración de la prueba de llenado de disco, en segundos.
+ **Percent**: opcional. El porcentaje del disco que se debe asignar durante la prueba de llenado de disco. El valor predeterminado es 95 %.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. Las dependencias son, y. **atd** **kmod** **fallocate**
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-IO-Stress
Ejecuta esfuerzo de E/S en una instancia con la herramienta **stress-ng**. Utiliza el documento [AWSFIS-Run-IO-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-IO-Stress/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-IO-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-IO-Stress
**Parámetros de documento**
+ **DurationSeconds**: obligatorio. La duración de la prueba de esfuerzo de E/S, en segundos.
+ **Workers**: opcional. El número de trabajadores que realizan una combinación de read/write operaciones secuenciales, aleatorias y mapeadas en memoria, sincronización forzada y pérdida de memoria caché. Varios procesos secundarios realizan diferentes I/O operaciones en el mismo archivo. El valor predeterminado de es 1.
+ **Percent**: opcional. El porcentaje de espacio libre en el sistema de archivos que se utilizará durante la prueba de esfuerzo de E/S. El valor predeterminado es 80 %.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. La dependencia es **stress-ng**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"Workers":"1", "Percent":"80", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Kill-Process
Detiene el proceso especificado en la instancia con el comando **killall**. Utiliza el documento [AWSFIS-Run-Kill-Process](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Kill-Process/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Kill-Process
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Kill-Process
**Parámetros de documento**
+ **ProcessName**: obligatorio. El nombre del proceso que se va a detener.
+ **Signal**: opcional. La señal que se va a enviar junto con el comando. Los valores posibles son `SIGTERM` (que el receptor puede elegir ignorar) y `SIGKILL` (que no se pueden ignorar). El valor predeterminado es `SIGTERM`.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. La dependencia es **killall**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"ProcessName":"myapplication", "Signal":"SIGTERM"}
```
### AWSFIS-Run-Memory-Stress
Ejecuta esfuerzo de la memoria en una instancia con la herramienta **stress-ng**. Utiliza el documento [AWSFIS-Run-Memory-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Memory-Stress/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Memory-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Memory-Stress
**Parámetros de documento**
+ **DurationSeconds**: obligatorio. La duración de la prueba de esfuerzo de la memoria, en segundos.
+ **Workers**: opcional. El número de factores de esfuerzo de la memoria virtual. El valor predeterminado de es 1.
+ **Percent**: obligatorio. El porcentaje de memoria virtual que se utilizará durante la prueba de esfuerzo de la memoria.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. La dependencia es **stress-ng**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"Percent":"80", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Blackhole-Port
Elimina el tráfico entrante o saliente del protocolo y el puerto con la herramienta **iptables**. Utiliza el documento [AWSFIS-Run-Network-Blackhole-Port](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Blackhole-Port/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Network-Blackhole-Port
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Blackhole-Port
**Parámetros de documento**
+ **Protocol**: obligatorio. El protocolo. Los valores posibles son `tcp` y `udp`.
+ **Port**: obligatorio. El número de puerto.
+ **TrafficType**: opcional. El tipo de tráfico. Los valores posibles son `ingress` y `egress`. El valor predeterminado es `ingress`.
+ **DurationSeconds**: obligatorio. La duración de la prueba de agujero negro de red, en segundos.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. Las dependencias son **atd**, **dig**, **lsof** y **iptables**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"Protocol":"tcp", "Port":"8080", "TrafficType":"egress", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Latency
Agrega latencia a la interfaz de red con la **tc** herramienta. Utiliza el documento [AWSFIS-Run-Network-Latency](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Latency/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Network-Latency
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Latency
**Parámetros de documento**
+ **Interface**: opcional. Interfaz de red. El valor predeterminado es `eth0`.
+ **DelayMilliseconds**: opcional. El retraso, en milisegundos. El valor predeterminado es 200.
+ **DurationSeconds**: obligatorio. La duración de la prueba de latencia de red, en segundos.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. Las dependencias son **atd**, **dig** e **tc**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"DelayMilliseconds":"200", "Interface":"eth0", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Latency-Sources
Agrega latencia y fluctuación a la interfaz de red con la herramienta **tc** para el tráfico hacia fuentes específicas o desde ellas. Utiliza el documento [AWSFIS-Run-Network-Latency-Sources](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Latency-Sources/description)SSM.
Utilice el `FlowsPercent` parámetro para añadir latencia a un porcentaje de las conexiones.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Network-Latency-Sources
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Latency-Sources
**Parámetros de documento**
+ **Interface**: opcional. Las interfaces de red, separadas por comas. Se admiten los valores ALL y DEFAULT. El valor predeterminado es`DEFAULT`, que se dirigirá a la interfaz de red principal del sistema operativo.
+ **DelayMilliseconds**: opcional. El retraso, en milisegundos. El valor predeterminado es 200.
+ **JitterMilliseconds**: opcional. La fluctuación, en milisegundos. El valor predeterminado es 10.
+ **FlowsPercent**: opcional. El porcentaje de flujos de red que se verán afectados por la acción. El valor de predeterminado es el 100 %.
+ **Sources**: obligatorio. Las fuentes, separadas por comas, sin espacios. Los valores posibles son: una dirección IPv4, un bloque CIDR IPv4, un nombre de dominio, un nombre AZ (us-east-1a), un ID AZ (use1-az1), ALL y. `DYNAMODB` `S3` Si especifica `DYNAMODB` o `S3`, solo se aplicará al punto de conexión regional de la región actual.
+ **TrafficType**: opcional. El tipo de tráfico. Los valores posibles son `ingress` y `egress`. El valor predeterminado es `ingress`.
+ **DurationSeconds**: obligatorio. La duración de la prueba de latencia de red, en segundos.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino, si aún no están instaladas. El valor predeterminado es `True`. Las dependencias son,, y. **atd** **dig** **jq** **lsof** **tc**
Al utilizar este documento, la función de experimento requiere los siguientes permisos:
+ `ec2:DescribeInstances`
+ `ec2:DescribeSubnets`
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"DelayMilliseconds":"200", "JitterMilliseconds":"15", "Sources":"S3,www.example.com,72.21.198.67", "Interface":"eth0", "TrafficType":"egress", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Packet-Loss
Agrega la pérdida de paquetes a la interfaz de red con la herramienta **tc**. Utiliza el documento [AWSFIS-Run-Network-Packet-Loss](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Packet-Loss/description)SSM.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Network-Packet-Loss
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Packet-Loss
**Parámetros de documento**
+ **Interface**: opcional. Interfaz de red. El valor predeterminado es `eth0`.
+ **LossPercent**: opcional. El porcentaje de pérdida de paquetes. El valor predeterminado es 7 %.
+ **DurationSeconds**: obligatorio. La duración de la prueba de pérdida de paquetes, en segundos.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino. El valor predeterminado es `True`. Las dependencias son **atd**, **lsof**, **dig** y **tc**.
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"LossPercent":"15", "Interface":"eth0", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Packet-Loss-Sources
Agrega pérdida de paquetes a la interfaz de red con la herramienta **tc** para el tráfico hacia fuentes específicas o desde ellas. Utiliza el documento [AWSFIS-Run-Network-Packet-Loss-Sources](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Packet-Loss-Sources/description)SSM.
Utilice el `FlowsPercent` parámetro para inyectar la pérdida de paquetes en un porcentaje de las conexiones.
**Tipo de acción (solo en la consola)**
aws:ssm:send-command/AWSFIS-Run-Network-Packet-Loss-Sources
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Packet-Loss-Sources
**Parámetros de documento**
+ **Interface**: opcional. Las interfaces de red, separadas por comas. Se admiten los valores ALL y DEFAULT. El valor predeterminado es`DEFAULT`, que se dirigirá a la interfaz de red principal del sistema operativo.
+ **LossPercent**: opcional. El porcentaje de pérdida de paquetes. El valor predeterminado es 7 %.
+ **FlowsPercent**: opcional. El porcentaje de flujos de red que se verán afectados por la acción. El valor de predeterminado es el 100 %.
+ **Sources**: obligatorio. Las fuentes, separadas por comas, sin espacios. Los valores posibles son: una dirección IPv4, un bloque CIDR IPv4, un nombre de dominio, un nombre AZ (us-east-1a), un ID AZ (use1-az1), ALL y. `DYNAMODB` `S3` Si especifica `DYNAMODB` o `S3`, solo se aplicará al punto de conexión regional de la región actual.
+ **TrafficType**: opcional. El tipo de tráfico. Los valores posibles son `ingress` y `egress`. El valor predeterminado es `ingress`.
+ **DurationSeconds**: obligatorio. La duración de la prueba de pérdida de paquetes, en segundos.
+ **InstallDependencies**: opcional. Si este valor es `True`, Systems Manager instala las dependencias necesarias en las instancias de destino. El valor predeterminado es `True`. Las dependencias son,, y. **atd** **dig** **jq** **lsof** **tc**
Al utilizar este documento, la función de experimento requiere los siguientes permisos:
+ `ec2:DescribeInstances`
+ `ec2:DescribeSubnets`
A continuación, un ejemplo de la cadena que se puede introducir en la consola.
```
{"LossPercent":"15", "Sources":"S3,www.example.com,72.21.198.67", "Interface":"eth0", "TrafficType":"egress", "DurationSeconds":"60", "InstallDependencies":"True"}
```
## Ejemplos
Para obtener un ejemplo de plantilla de experimento, consulte [Ejecute un documento AWS FIS SSM preconfigurado](experiment-template-example.md#cpu-fault-injection).
Para ver un tutorial de ejemplo, consulte [Ejecutar esfuerzo de la CPU en una instancia](fis-tutorial-run-cpu-stress.md).
## Limitaciones
+ Los siguientes documentos no se pueden ejecutar en paralelo:
+ AWSFIS-Run-Network-Blackhole-Port
+ AWSFIS-Run-Network-Latency
+ AWSFIS-Run-Network-Latency-Sources
+ AWSFIS-Run-Network-Packet-Loss
+ AWSFIS-Run-Network-Packet-Loss-Sources
## Secuencias de comandos de reversión
AWS Los documentos SSM del FIS crean automáticamente scripts de reversión como mecanismo de seguridad para restaurar el estado del sistema después de los experimentos de inyección de errores. Estos scripts garantizan que se eliminen los errores introducidos, incluso si la acción falla o finaliza inesperadamente.
### Revertir la creación de scripts
Los scripts de reversión se crean automáticamente cuando comienzan los experimentos de inyección de errores.
**Detalles de creación**
+ **Ubicación**: los scripts se crean en el `/var/lib/amazon/ssm/` directorio.
+ **Patrón de nomenclatura**: `{{FAULT_NAME}}-{{FAULT_IDENTIFIER}}-Rollback.sh` ¿dónde {{FAULT\_IDENTIFIER}} se encuentra una cadena de 32 caracteres generada aleatoriamente
+ **Sincronización**: se crea al principio de cada experimento de inyección de fallas, antes de que comience la inyección de fallas.
+ **Contenido**: contiene todas las variables de entorno y los comandos necesarios para revertir la falla específica.
Por ejemplo, un experimento de latencia de red podría crear un script de reversión en`/var/lib/amazon/ssm/NetworkLatency-abc123-Rollback.sh`.
### Registro de reversión
Los scripts de reversión implementan un registro doble para capturar todas las actividades de reversión con fines de solución de problemas y auditoría.
**Ubicaciones de archivo de registro**
Cuando se ejecuta un script de reversión, crea registros en dos ubicaciones:
+ **Archivos temporales**: `/tmp/aws-fis-rollback-{{TIMESTAMP}}-{{PID}}.log`
+ **Registros del sistema**: se envían a syslog con facilidad `local0.info`
**Denominación de archivos de registro**
Los archivos de registro temporales utilizan la siguiente convención de nomenclatura:
```
/tmp/aws-fis-rollback-{{YYYY-MM-DDTHH:MM:SSZ}}-{{PID}}.log
```
¿Dónde {{YYYY-MM-DDTHH:MM:SSZ}} está la marca de tiempo UTC y {{PID}} el ID de proceso del script de reversión?
**Configuración de Syslog**
Los registros de reversión se envían a syslog con la siguiente configuración:
+ **Etiqueta:** `aws-fis-rollback`
+ **Prioridad**: `local0.info`
+ **Formato** — `[YYYY-MM-DDTHH:MM:SSZ] {{log_message}}`
**Para ver los registros de reversión**
Utilice el siguiente comando para ver todos los registros de reversión del diario de systemd:
```
sudo journalctl -t aws-fis-rollback
```
## Resolución de problemas
Use el siguiente procedimiento para solucionar problemas.
**Para solucionar problemas con los documentos de SSM**
1. Abra la AWS Systems Manager consola en. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. En el panel de navegación, elija **Administración de nodos**, **Run Command**.
1. En la pestaña **Historial de comandos**, utilice los filtros para localizar la ejecución del documento.
1. Elija el ID del comando para abrir la página de detalles.
1. Elija el ID de la instancia. Revise el resultado y los errores de cada paso.