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à.
# Usa i documenti SSM di Systems Manager con AWS FIS
AWS FIS supporta tipi di errore personalizzati tramite l'agente AWS Systems Manager SSM e l' AWS azione FIS. [aws:ssm:send-command](fis-actions-reference.md#ssm-send-command) Pre-configured I documenti SSM di Systems Manager (documenti SSM) che possono essere utilizzati per creare azioni di errore comuni sono disponibili come AWS documenti pubblici che iniziano con il prefisso AWSFIS-.
SSM Agent è un software Amazon che può essere installato e configurato su istanze Amazon EC2, server locali o macchine virtuali (VM). Ciò consente a Systems Manager di gestire queste risorse. L'agente elabora le richieste provenienti da Systems Manager e quindi le esegue come specificato nella richiesta. È possibile includere il proprio documento SSM per inserire errori personalizzati o fare riferimento a uno dei documenti pubblici. Amazon-owned
**Requisiti**
Per le azioni che richiedono l'esecuzione dell'azione da parte dell'agente SSM sulla destinazione, è necessario assicurarsi di quanto segue:
+ L'agente è installato sulla destinazione. L'agente SSM è installato per impostazione predefinita su alcune Amazon Machine Images (AMI). Altrimenti, puoi installare l'agente SSM sulle tue istanze. *Per ulteriori informazioni, consulta [Installare manualmente l'agente SSM per le istanze EC2 nella Guida per](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) l'utente.AWS Systems Manager *
+ Systems Manager è autorizzato a eseguire azioni sulle istanze. Concedi l'accesso utilizzando un profilo di istanza IAM. Per ulteriori informazioni, consulta [Creare un profilo di istanza IAM per Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-profile.html) e [Collegare un profilo di istanza IAM a un'istanza EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-launch-managed-instance.html) nella *Guida per l'AWS Systems Manager utente*.
## Usa il aws:ssm:send-command operazione
Un documento SSM definisce le operazioni eseguite da Systems Manager sulle istanze gestite. Systems Manager include una serie di documenti preconfigurati oppure è possibile crearne di personalizzati. Per ulteriori informazioni sulla creazione del proprio documento SSM, vedere [Creating Systems Manager documents](https://docs.aws.amazon.com/systems-manager/latest/userguide/create-ssm-doc.html) nella *Guida per l'AWS Systems Manager utente*. Per ulteriori informazioni sui documenti SSM in generale, consultate [AWS Systems Manager i documenti nella Guida](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-ssm-docs.html) per l'*AWS Systems Manager utente*.
AWS FIS fornisce documenti SSM preconfigurati. **È possibile visualizzare i documenti SSM preconfigurati in Documenti nella console:. AWS Systems Manager [https://console.aws.amazon.com/systems-manager/documents](https://console.aws.amazon.com/systems-manager/documents)** Puoi anche scegliere tra una selezione di documenti preconfigurati nella console FIS. AWS Per ulteriori informazioni, consulta [Pre-configured AWS Documenti FIS SSM](#fis-ssm-docs).
Per utilizzare un documento SSM nei vostri esperimenti AWS FIS, potete usare l'azione. [aws:ssm:send-command](fis-actions-reference.md#ssm-send-command) Questa azione recupera ed esegue il documento SSM specificato sulle istanze di destinazione.
Quando si utilizza l'`aws:ssm:send-command`azione nel modello di esperimento, è necessario specificare parametri aggiuntivi per l'azione, inclusi i seguenti:
+ **documentArn**: obbligatorio L'Amazon Resource Name (ARN) del documento SSM.
+ **documentParameters**— Condizionale. I parametri obbligatori e facoltativi accettati dal documento SSM. Il formato è un oggetto JSON con chiavi che sono stringhe e valori che sono stringhe o matrici di stringhe.
+ **documentVersion** : Opzionale. La versione del documento SSM da eseguire.
È possibile visualizzare le informazioni per un documento SSM (inclusi i parametri del documento) utilizzando la console Systems Manager o la riga di comando.
**Per visualizzare informazioni su un documento SSM utilizzando la console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **Documenti**.
1. Seleziona il documento e scegli la scheda **Dettagli**.
**Per visualizzare informazioni su un documento SSM utilizzando la riga di comando**
Usa il comando SSM [describe-document](https://docs.aws.amazon.com/cli/latest/reference/ssm/describe-document.html).
**Scopri di più sullo stato dell'azione**
Lo stato di azione SSM è determinato dagli stati dei [comandi SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitor-commands.html).
## Pre-configured AWS Documenti FIS SSM
È possibile utilizzare documenti AWS FIS SSM preconfigurati con l'`aws:ssm:send-command`azione nei modelli di esperimento.
**Requisiti**
+ I documenti SSM preconfigurati forniti da AWS FIS sono supportati solo sui seguenti sistemi operativi:
+ Amazon Linux 2023, Amazon Linux 2
+ Ubuntu
+ REGOLA 8, 9
+ CentOS 9
+ I documenti SSM preconfigurati forniti da AWS FIS sono supportati solo sulle istanze EC2. Non sono supportati su altri tipi di nodi gestiti, come i server locali.
Per utilizzare questi documenti SSM in esperimenti sulle attività ECS, usa il corrispondente. [Azioni Amazon ECS](fis-actions-reference.md#ecs-actions-reference) Ad esempio, l'**aws:ecs:task-cpu-stress**azione utilizza il AWSFIS-Run-CPU-Stress documento.
**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)
**Differenza tra la durata e la durata DurationSeconds dell'azione AWS Documenti FIS SSM**
Alcuni documenti SSM limitano il proprio tempo di esecuzione, ad esempio il DurationSeconds parametro viene utilizzato da alcuni documenti FIS SSM preconfigurati AWS . Di conseguenza, è necessario specificare due durate indipendenti nella definizione dell'azione FIS: AWS
+ **Action duration**: Per gli esperimenti con una singola azione, la durata dell'azione è equivalente alla durata dell'esperimento. Nel caso di azioni multiple, la durata dell'esperimento dipende dalla durata delle singole azioni e dall'ordine in cui vengono eseguite. AWS Il FIS monitora ogni azione fino al termine della sua durata.
+ Parametro del documento**DurationSeconds**: la durata, specificata in secondi, per la quale verrà eseguito il documento SSM.
Puoi scegliere valori diversi per i due tipi di durata:
+ **Action duration exceeds DurationSeconds**: L'esecuzione del documento SSM termina prima del completamento dell'azione. AWS FIS attende che sia trascorsa la durata dell'azione prima di avviare le azioni successive.
+ **Action duration is shorter than DurationSeconds**: Il documento SSM continua l'esecuzione dopo il completamento dell'azione. Se l'esecuzione del documento SSM è ancora in corso e la durata dell'azione è scaduta, lo stato dell'azione viene impostato su Completato. AWS FIS monitora l'esecuzione solo fino alla scadenza della durata dell'azione.
Si noti che alcuni documenti SSM hanno durate variabili. Ad esempio, i documenti AWS FIS SSM hanno la possibilità di installare i prerequisiti, che possono estendere la durata complessiva dell'esecuzione oltre il parametro specificato. DurationSeconds Pertanto, se si imposta la durata dell'azione e DurationSeconds lo stesso valore, è possibile che lo script SSM venga eseguito più a lungo della durata dell'azione.
### AWSFIS-Run-CPU-Stress
Esegue lo stress della CPU su un'istanza utilizzando lo **stress-ng** strumento. Utilizza il documento [AWSFIS-Run-CPU-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-CPU-Stress/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-CPU-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-CPU-Stress
**Parametri del documento**
+ **DurationSeconds**: obbligatorio La durata dello stress test della CPU, in secondi.
+ **CPU** : Opzionale. Il numero di fattori di stress della CPU da utilizzare. L'impostazione predefinita è 0, che utilizza tutti i fattori di stress della CPU.
+ **LoadPercent** : Opzionale. La percentuale di carico della CPU di destinazione, da 0 (senza carico) a 100 (a pieno carico). Il valore di default è 100.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. La dipendenza è. **stress-ng**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Disk-Fill
Alloca lo spazio su disco sul volume principale di un'istanza per simulare un guasto completo del disco. Utilizza il documento [AWSFIS-Run-Disk-Fill](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Disk-Fill/description)SSM.
Se l'esperimento che inietta questo errore viene interrotto, manualmente o tramite una condizione di arresto, AWS FIS tenta di ripristinare il sistema annullando il documento SSM in esecuzione. Tuttavia, se il disco è pieno al 100%, a causa dell'errore o dell'attività dell'applicazione, Systems Manager potrebbe non essere in grado di completare l'operazione di annullamento. Pertanto, se è necessario interrompere l'esperimento, assicuratevi che il disco non si riempia al 100%.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Disk-Fill
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Disk-Fill
**Parametri del documento**
+ **DurationSeconds**: obbligatorio La durata del test di riempimento del disco, in secondi.
+ **Percent** : Opzionale. La percentuale del disco da allocare durante il test di riempimento del disco. L'impostazione predefinita è 95%.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. Le dipendenze sono, e. **atd** **kmod** **fallocate**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-IO-Stress
Esegue lo stress IO su un'istanza utilizzando lo **stress-ng** strumento. Utilizza il documento [AWSFIS-Run-IO-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-IO-Stress/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-IO-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-IO-Stress
**Parametri del documento**
+ **DurationSeconds**: obbligatorio La durata dello stress test IO, in secondi.
+ **Workers** : Opzionale. Il numero di lavoratori che eseguono una combinazione di read/write operazioni sequenziali, casuali e mappate in memoria, sincronizzazione forzata e eliminazione della cache. Più processi secondari eseguono operazioni diverse sullo stesso file. I/O Il valore di default è 1.
+ **Percent** : Opzionale. La percentuale di spazio libero sul file system da utilizzare durante lo stress test IO. L'impostazione predefinita è 80%.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. La dipendenza è. **stress-ng**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"Workers":"1", "Percent":"80", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Kill-Process
Arresta il processo specificato nell'istanza, utilizzando il **killall** comando. Utilizza il documento [AWSFIS-Run-Kill-Process](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Kill-Process/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Kill-Process
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Kill-Process
**Parametri del documento**
+ **ProcessName**: obbligatorio Il nome del processo da interrompere.
+ **Signal** : Opzionale. Il segnale da inviare insieme al comando. I valori possibili sono `SIGTERM` (che il ricevitore può scegliere di ignorare) e `SIGKILL` (che non possono essere ignorati). Il valore predefinito è `SIGTERM`.
+ **InstallDependencies** Facoltativo. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. La dipendenza è. **killall**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"ProcessName":"myapplication", "Signal":"SIGTERM"}
```
### AWSFIS-Run-Memory-Stress
Esegue lo stress della memoria su un'istanza utilizzando lo **stress-ng** strumento. Utilizza il documento [AWSFIS-Run-Memory-Stress](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Memory-Stress/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Memory-Stress
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Memory-Stress
**Parametri del documento**
+ **DurationSeconds**: obbligatorio La durata dello stress test della memoria, in secondi.
+ **Workers** : Opzionale. Il numero di fattori di stress della memoria virtuale. Il valore di default è 1.
+ **Percent**: obbligatorio La percentuale di memoria virtuale da utilizzare durante il test di stress della memoria.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. La dipendenza è. **stress-ng**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"Percent":"80", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Blackhole-Port
Elimina il traffico in entrata o in uscita per il protocollo e la porta utilizzando lo **iptables** strumento. Utilizza il documento [AWSFIS-Run-Network-Blackhole-Port](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Blackhole-Port/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Network-Blackhole-Port
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Blackhole-Port
**Parametri del documento**
+ **Protocol**: obbligatorio Il protocollo. I valori possibili sono `tcp` e `udp`.
+ **Port**: obbligatorio Il numero di porta.
+ **TrafficType** : Opzionale. Il tipo di traffico. I valori possibili sono `ingress` e `egress`. Il valore di default è `ingress`.
+ **DurationSeconds**: obbligatorio Durata del test del buco nero della rete, in secondi.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. Le dipendenze sono**atd**,, e**dig**. **lsof** **iptables**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"Protocol":"tcp", "Port":"8080", "TrafficType":"egress", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Latency
Aggiunge latenza all'interfaccia di rete utilizzando lo **tc** strumento. Utilizza il documento [AWSFIS-Run-Network-Latency](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Latency/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Network-Latency
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Latency
**Parametri del documento**
+ **Interface** : Opzionale. L'interfaccia di rete. Il valore predefinito è `eth0`.
+ **DelayMilliseconds** Facoltativo. Il ritardo, in millisecondi. L'impostazione predefinita è 200.
+ **DurationSeconds**: obbligatorio La durata del test di latenza della rete, in secondi.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. Le dipendenze sono**atd**, e. **dig** **tc**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"DelayMilliseconds":"200", "Interface":"eth0", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Latency-Sources
Aggiunge latenza e jitter all'interfaccia di rete utilizzando **tc** lo strumento per il traffico da o verso fonti specifiche. Utilizza il documento [AWSFIS-Run-Network-Latency-Sources](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Latency-Sources/description)SSM.
Utilizzate il `FlowsPercent` parametro per aggiungere latenza su una percentuale delle connessioni.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Network-Latency-Sources
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Latency-Sources
**Parametri del documento**
+ **Interface** : Opzionale. Le interfacce di rete, separate da virgole. I valori ALL e DEFAULT sono supportati. L'impostazione predefinita è `DEFAULT` che avrà come target l'interfaccia di rete principale per il sistema operativo.
+ **DelayMilliseconds** : Opzionale. Il ritardo, in millisecondi. L'impostazione predefinita è 200.
+ **JitterMilliseconds** : Opzionale. Il jitter, in millisecondi. Il valore predefinito è 10.
+ **FlowsPercent** : Opzionale. La percentuale di flussi di rete che saranno influenzati dall'azione. Il valore di default è 100%.
+ **Sources**: obbligatorio Le fonti, separate da virgole, senza spazi. I valori possibili sono: un indirizzo IPv4, un blocco CIDR IPv4, un nome di dominio, un nome AZ (us-east-1a), un ID AZ (use1-az1), ALL e. `DYNAMODB` `S3` Se si specifica `DYNAMODB` o, ciò si applica solo all'endpoint `S3` regionale nella regione corrente.
+ **TrafficType** : Opzionale. Il tipo di traffico. I valori possibili sono `ingress` e `egress`. Il valore di default è `ingress`.
+ **DurationSeconds**: obbligatorio La durata del test di latenza della rete, in secondi.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione se non sono già installate. Il valore predefinito è `True`. Le dipendenze sono**atd**,,**dig**, **jq** e. **lsof** **tc**
Quando si utilizza questo documento, il ruolo dell'esperimento richiede le seguenti autorizzazioni:
+ `ec2:DescribeInstances`
+ `ec2:DescribeSubnets`
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"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
Aggiunge la perdita di pacchetti all'interfaccia di rete utilizzando lo **tc** strumento. Utilizza il documento [AWSFIS-Run-Network-Packet-Loss](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Packet-Loss/description)SSM.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Network-Packet-Loss
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Packet-Loss
**Parametri del documento**
+ **Interface** : Opzionale. L'interfaccia di rete. Il valore predefinito è `eth0`.
+ **LossPercent** Facoltativo. La percentuale di perdita di pacchetti. L'impostazione predefinita è 7%.
+ **DurationSeconds**: obbligatorio La durata del test di perdita di pacchetti di rete, in secondi.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione. Il valore predefinito è `True`. Le dipendenze sono**atd**,, e**lsof**. **dig** **tc**
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"LossPercent":"15", "Interface":"eth0", "DurationSeconds":"60", "InstallDependencies":"True"}
```
### AWSFIS-Run-Network-Packet-Loss-Sources
Aggiunge la perdita di pacchetti all'interfaccia di rete utilizzando lo **tc** strumento per il traffico da o verso fonti specifiche. Utilizza il documento [AWSFIS-Run-Network-Packet-Loss-Sources](https://console.aws.amazon.com/systems-manager/documents/AWSFIS-Run-Network-Packet-Loss-Sources/description)SSM.
Utilizzate il `FlowsPercent` parametro per iniettare la perdita di pacchetti su una percentuale delle connessioni.
**Tipo di azione (solo console)**
aws:ssm:send-command/AWSFIS-Run-Network-Packet-Loss-Sources
**ARN**
arn:aws:ssm:*region*::document/AWSFIS-Run-Network-Packet-Loss-Sources
**Parametri del documento**
+ **Interface** : Opzionale. Le interfacce di rete, separate da virgole. I valori ALL e DEFAULT sono supportati. L'impostazione predefinita è `DEFAULT` che avrà come target l'interfaccia di rete principale per il sistema operativo.
+ **LossPercent** : Opzionale. La percentuale di perdita di pacchetti. L'impostazione predefinita è 7%.
+ **FlowsPercent** : Opzionale. La percentuale di flussi di rete che saranno interessati dall'azione. Il valore di default è 100%.
+ **Sources**: obbligatorio Le fonti, separate da virgole, senza spazi. I valori possibili sono: un indirizzo IPv4, un blocco CIDR IPv4, un nome di dominio, un nome AZ (us-east-1a), un ID AZ (use1-az1), ALL e. `DYNAMODB` `S3` Se si specifica `DYNAMODB` o, ciò si applica solo all'endpoint `S3` regionale nella regione corrente.
+ **TrafficType** : Opzionale. Il tipo di traffico. I valori possibili sono `ingress` e `egress`. Il valore di default è `ingress`.
+ **DurationSeconds**: obbligatorio La durata del test di perdita di pacchetti di rete, in secondi.
+ **InstallDependencies** : Opzionale. Se il valore è`True`, Systems Manager installa le dipendenze richieste sulle istanze di destinazione. Il valore predefinito è `True`. Le dipendenze sono**atd**,,**dig**, **jq** e. **lsof** **tc**
Quando si utilizza questo documento, il ruolo dell'esperimento richiede le seguenti autorizzazioni:
+ `ec2:DescribeInstances`
+ `ec2:DescribeSubnets`
Di seguito è riportato un esempio della stringa che è possibile immettere nella console.
```
{"LossPercent":"15", "Sources":"S3,www.example.com,72.21.198.67", "Interface":"eth0", "TrafficType":"egress", "DurationSeconds":"60", "InstallDependencies":"True"}
```
## Esempi
Per un esempio di modello di esperimento, vedi[Esegui un documento FIS SSM preconfigurato AWS](experiment-template-example.md#cpu-fault-injection).
Per un esempio di tutorial, consultare [Esegui lo stress della CPU su un'istanza](fis-tutorial-run-cpu-stress.md).
## Limitazioni
+ I seguenti documenti non possono essere eseguiti in parallelo:
+ 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
## Script di rollback
AWS I documenti FIS SSM creano automaticamente script di rollback come meccanismo di sicurezza per ripristinare lo stato del sistema dopo esperimenti di failinjection. Questi script assicurano che gli errori iniettati vengano rimossi, anche se l'azione fallisce o viene interrotta in modo imprevisto.
### Creazione di script di rollback
Gli script di rollback vengono creati automaticamente quando iniziano gli esperimenti di iniezione dei guasti.
**Dettagli sulla creazione**
+ **Posizione**: gli script vengono creati nella `/var/lib/amazon/ssm/` directory.
+ **Schema di denominazione**: `{{FAULT_NAME}}-{{FAULT_IDENTIFIER}}-Rollback.sh` {{FAULT\_IDENTIFIER}} dov'è una stringa di 32 caratteri generata casualmente
+ **Tempistica**: creata all'inizio di ogni esperimento di iniezione del guasto, prima che inizi l'iniezione del guasto.
+ **Contenuto**: contiene tutte le variabili di ambiente e i comandi necessari per invertire l'errore specifico.
Ad esempio, un esperimento di latenza di rete potrebbe creare uno script di rollback su. `/var/lib/amazon/ssm/NetworkLatency-abc123-Rollback.sh`
### Registrazione del rollback
Gli script di rollback implementano la doppia registrazione per acquisire tutte le attività di rollback a fini di risoluzione dei problemi e controllo.
**Posizioni dei file di registro**
Quando viene eseguito uno script di rollback, crea i log in due posizioni:
+ **File temporanei:** `/tmp/aws-fis-rollback-{{TIMESTAMP}}-{{PID}}.log`
+ **Registri di sistema: inviati a syslog** con funzionalità `local0.info`
**Denominazione dei file di registro**
I file di registro temporanei utilizzano la seguente convenzione di denominazione:
```
/tmp/aws-fis-rollback-{{YYYY-MM-DDTHH:MM:SSZ}}-{{PID}}.log
```
{{YYYY-MM-DDTHH:MM:SSZ}}Dov'è il timestamp UTC e {{PID}} l'ID di processo dello script di rollback.
**Configurazione Syslog**
I log di rollback vengono inviati a syslog con la seguente configurazione:
+ **Etichetta:** `aws-fis-rollback`
+ **Priorità** — `local0.info`
+ **Formato** — `[YYYY-MM-DDTHH:MM:SSZ] {{log_message}}`
**Per visualizzare i registri di rollback**
Usa il seguente comando per visualizzare tutti i log di rollback dal journal systemd:
```
sudo journalctl -t aws-fis-rollback
```
## Risoluzione dei problemi
Utilizzare la procedura seguente per risolvere i problemi.
**Per risolvere i problemi relativi ai documenti SSM**
1. Apri la console all' AWS Systems Manager indirizzo. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Nel riquadro di navigazione, scegli **Gestione dei nodi**, **Esegui comando**.
1. Nella scheda **Cronologia dei comandi**, utilizza i filtri per individuare l'esecuzione del documento.
1. Scegli l'ID del comando per aprirne la pagina dei dettagli.
1. Scegli l'ID dell'istanza. Controlla l'output e gli errori per ogni passaggio.