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à.
# Risolvere problemi relativi agli snapshot EBS basati su Windows VSS
Prima di provare qualsiasi altra procedura di risoluzione dei problemi, consigliamo di verificare le seguenti informazioni.
+ Assicurati di aver soddisfatto tutti i [Prerequisiti per creare snapshot EBS basati su Windows VSS](application-consistent-snapshots-prereqs.md).
+ Verifica di utilizzare la [Supporto della versione del sistema operativo Windows](vss-comps-history.md#windows-version-support) più recente del pacchetto `AwsVssComponents` per il sistema operativo. Il problema riscontrato potrebbe essere stato risolto nelle versioni più recenti.
**Topics**
+ [Verificare i file di registro](#general-log-files)
+ [Raccogliere log di diagnostica aggiuntivi](#vss-ts-collect-diagnostic-logs)
+ [Utilizzo di VSS su istanze con proxy configurato](#general-using-vss-with-proxy)
+ [Errore: timeout della connessione del thaw pipe, errore sul thaw, timeout in attesa di VSS Freeze o altri errori di timeout](#error-thaw)
+ [Errore: impossibile richiamare il metodo. L'invocazione del metodo è supportata solo sui tipi principali in questa modalità di linguaggio](#error-invoke)
## Verificare i file di registro
Se si verificano problemi o si ricevono messaggi di errore durante la creazione di snapshot EBS basati su VSS, è possibile visualizzare l'output del comando nella console di Systems Manager.
Per i documenti Systems Manager che creano snapshot VSS, è possibile impostare il parametro `CollectDiagnosticLogs` su "`True`" al runtime. Quando il parametro `CollectDiagnosticLogs` è impostato su "`True`", VSS raccoglie registri aggiuntivi per facilitare il debug. Per ulteriori informazioni, consulta [Raccogliere log di diagnostica aggiuntivi](#vss-ts-collect-diagnostic-logs).
Se raccogli registri di diagnostica, il documento Systems Manager li archivia sulla tua istanza nella seguente posizione: `C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip`. Il valore predefinito per il parametro `CollectDiagnosticLogs` è "`False`".
**Nota**
Per ulteriore assistenza sul debug, puoi inviare il `.zip` file a. Supporto
Sono disponibili i seguenti registri aggiuntivi, indipendentemente dal fatto che si raccolgano o meno registri di diagnostica:
+ `%ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stdout`
+ `%ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stderr`
È inoltre possibile aprire l'applicazione Visualizzatore eventi di Windows e scegliere **Registri di Windows**, **Applicazione** per visualizzare i registri aggiuntivi. Per visualizzare gli eventi specificatamente dal provider VSS Windows EC2 e dal servizio Copia shadow del volume, filtrare in base all' **origine** con i termini **Ec2VssSoftwareProvider** e **VSS**.
**Se utilizzi Systems Manager con endpoint VPC e l'azione dell'API [send-command di Systems Manager (**Esegui comando**](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html) nella console) non è riuscita, verifica di aver configurato correttamente il seguente endpoint: com.amazonaws. *region*.ec2.**
Se non è definito l'endpoint Amazon EC2, la chiamata per enumerare i volumi EBS collegati ha esito negativo e causa un errore del comando Systems Manager. Per ulteriori informazioni sulla configurazione degli endpoint VPC con Systems Manager, consulta [Creazione di un endpoint VPC](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-create-vpc.html) nella *AWS Systems Manager Guida per l'utente di *.
## Raccogliere log di diagnostica aggiuntivi
Per raccogliere log di diagnostica aggiuntivi quando si utilizza il comando di invio di Systems Manager per eseguire il documento di snapshot VSS, imposta il parametro di input `CollectDiagnosticLogs` su "`True`" al runtime. Ti consigliamo di impostare questo parametro su "`True`" durante la risoluzione dei problemi.
Per visualizzare un esempio di riga di comando, seleziona una delle seguenti schede.
------
#### [ AWS CLI ]
L'esempio seguente esegue il documento Systems Manager `AWSEC2-CreateVssSnapshot` in AWS CLI:
```
aws ssm send-command \
--document-name "AWSEC2-CreateVssSnapshot" \
--instance-ids "i-1234567890abcdef0" \
--parameters '{"description":["Example - create diagnostic logs at runtime."],"tags":["Key=tag_name,Value=tag_value"],"CollectDiagnosticLogs":["True"]}'
```
------
#### [ PowerShell ]
L'esempio seguente esegue il documento `AWSEC2-CreateVssSnapshot` Systems Manager in PowerShell:
```
Send-SSMCommand `
-DocumentName "AWSEC2-CreateVssSnapshot" `
-InstanceId "i-1234567890abcdef0" `
-Parameter @{'description'='Example - create diagnostic logs at runtime.';'tags'='Key=tag_name,Value=tag_value';'CollectDiagnosticLogs'='True'}
```
------
## Utilizzo di VSS su istanze con proxy configurato
Se riscontri problemi durante la creazione di snapshot EBS basati su VSS su istanze che utilizzano un proxy per raggiungere gli endpoint EC2, verifica le seguenti impostazioni sulla tua istanza:
+ Verifica che il proxy sia configurato in modo che gli endpoint del servizio EC2 nella regione e nell'IMDS dell'istanza siano raggiungibili eseguendo AWS Tools for Windows PowerShell come SYSTEM.
+ Per supportare l'utilizzo del proxy WinHTTP configurato dal sistema, assicurati di aver installato la versione `AwsVssComponents` più recente sull'istanza. Per ulteriori informazioni sulla configurazione del proxy WinHTTP, consulta la pagina [Netsh Commands for Windows Hypertext Transfer Protocol (WINHTTP)](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc731131(v=ws.10)) sul sito web di Microsoft.
## Errore: timeout della connessione del thaw pipe, errore sul thaw, timeout in attesa di VSS Freeze o altri errori di timeout
Il provider VSS Windows EC2 potrebbe scadere a causa di attività o servizi sull'istanza che impediscono agli snapshot basati su VSS di procedere in modo tempestivo. Il framework VSS Windows fornisce una finestra di 10 secondi non configurabile durante la quale la comunicazione con il file system viene sospesa. Durante questo periodo, `AWSEC2-CreateVssSnapshot` crea gli snapshot dei volumi.
I seguenti problemi possono causare il superamento dei limiti di tempo da parte del provider VSS Windows EC2 durante uno snapshot:
+ Eccessivo rispetto a un volume I/O
+ Reattività lenta dell'API EC2 sull'istanza
+ Volumi frammentati
+ Incompatibilità con alcuni software antivirus
+ Problemi con un autore di applicazioni VSS
+ Quando il Module Logging è abilitato per un gran numero di PowerShell moduli, ciò può causare un rallentamento dell' PowerShell esecuzione degli script
La maggior parte dei problemi che si verificano quando si esegue il documento di comando `AWSEC2-CreateVssSnapshot` è legata a un carico di lavoro eccessivamente elevato sull'istanza al momento del backup. Le seguenti azioni consentono di eseguire con successo lo snapshot:
+ Riprovare a eseguire il comando `AWSEC2-CreateVssSnapshot` per verificare se il tentativo di snapshot ha esito positivo. Se in alcuni casi il tentativo ha esito positivo, la riduzione del carico dell'istanza potrebbe rendere più efficace gli snapshot.
+ Attendere che il carico di lavoro sull'istanza diminuisca e riprovare a eseguire il comando `AWSEC2-CreateVssSnapshot`. In alternativa, è possibile scattare gli snapshot quando si è certi che l'istanza è in una fase di carico ridotto.
+ Provare a scattare gli snapshot VSS dopo avere disattivato il software antivirus del sistema. Se questo risolve il problema, fare riferimento alle istruzioni del software antivirus e configurarlo per consentire gli snapshot VSS.
+ Se nell'account è presente un volume elevato di chiamate API Amazon EC2 nella stessa regione in cui si esegue uno snapshot, la limitazione (della larghezza di banda della rete) delle API può ritardare le operazioni di snapshot. Per ridurre l'impatto sulla limitazione, utilizza il pacchetto `AwsVssComponents` più recente. Questo pacchetto utilizza l'operazione API `CreateSnapshots` di EC2 per ridurre il numero di operazioni mutevoli, come la creazione e l'applicazione di tag per volume.
+ Se vi sono più script di comando `AWSEC2-CreateVssSnapshot` in esecuzione contemporaneamente, è possibile seguire questa procedura per ridurre i problemi di simultaneità.
+ Valutare la possibilità di programmare gli snapshot durante periodi di minore attività delle API.
+ Se si utilizza **Run Command** nella console Systems Manager (oppure **SendCommand** nell'API) per eseguire lo script di comando, è possibile utilizzare i controlli di velocità di Systems Manager per ridurre la simultaneità.
È inoltre possibile utilizzare i controlli di frequenza di Systems Manager per ridurre la concorrenza per servizi come quelli AWS Backup che utilizzano Systems Manager per eseguire lo script di comando.
+ Eseguire il comando `vssadmin list writers` in una shell e verificare se segnala eventuali errori nel campo **Ultimo errore** per tutti gli autori del sistema. Se un autore segnala un errore di **timeout**, è consigliabile scattare nuovi snapshot quando l'istanza è sotto un carico minore.
+ Quando si utilizzano tipi di istanze più piccoli come *t2 \$1 t3 \$1 t3a* .nano o *t2 \$1 t3 \$1 t3a* .micro, possono verificarsi dei timeout dovuti a vincoli di memoria e CPU. Le seguenti operazioni potrebbero contribuire a ridurre i problemi di timeout.
+ Provare a chiudere le applicazioni con un uso intensivo di memoria e CPU prima di acquisire snapshot.
+ Provare ad acquisire snapshot durante i periodi di minore attività dell'istanza.
## Errore: impossibile richiamare il metodo. L'invocazione del metodo è supportata solo sui tipi principali in questa modalità di linguaggio
Questo errore si verificherà quando la modalità della PowerShell lingua non è impostata su. `FullLanguage` Il documento `AWSEC2-CreateVssSnapshot` SSM deve PowerShell essere configurato in `FullLanguage` modalità.
Per verificare la modalità della lingua, esegui il seguente comando sull'istanza in una PowerShell console:
```
$ExecutionContext.SessionState.LanguageMode
```
Per ulteriori informazioni sulle modalità di linguaggio, consulta [about\$1Language\$1Modes](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_language_modes) nella documentazione di Microsoft.