Risolvere problemi relativi agli snapshot EBS basati su Windows VSS - Amazon Elastic Compute Cloud
Verificare i file di registroRaccogliere log di diagnostica aggiuntiviUtilizzo di VSS su istanze con proxy configuratoErrore: timeout della connessione del thaw pipe, errore sul thaw, timeout in attesa di VSS Freeze o altri errori di timeoutErrore: impossibile richiamare il metodo. L'invocazione del metodo è supportata solo sui tipi principali in questa modalità di linguaggio

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.

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.

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 con il debug, puoi inviare il file .zip a AWS Support.

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 si utilizza Systems Manager con gli endpoint VPC e l'operazione API SendCommand di Systems Manager (Esegui comando nella console) non è riuscito, 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 nella AWS Systems ManagerGuida 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 Systems Manager AWSEC2-CreateVssSnapshot 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 tale che gli endpoint del servizio EC2 nella regione e nell'IMDS dell'istanza siano raggiungibili da AWS Tools for Windows PowerShell in esecuzione 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) 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:

  • I/O eccessivo per un volume

  • Reattività lenta dell'API EC2 sull'istanza

  • Volumi frammentati

  • Incompatibilità con alcuni software antivirus

  • Problemi con un autore di applicazioni VSS

  • Quando la registrazione dei moduli è abilitata per un numero elevato di moduli PowerShell, ciò può causare l'esecuzione degli script di PowerShell lentamente

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 velocità di Systems Manager per ridurre la simultaneità per servizi come 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 istanza più piccoli, come t2 | t3 | t3a.nano o t2 | t3 | t3a-micro, possono verificarsi timeout dovuti a limiti 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

Visualizzerai questo errore se la modalità di linguaggio di PowerShell non è impostata su FullLanguage. I documenti SSM AWSEC2-CreateVssSnapshot richiedono la configurazione di PowerShell in modalità FullLanguage.

Per verificare la modalità di linguaggio, esegui il comando seguente sull'istanza in una console di PowerShell:

$ExecutionContext.SessionState.LanguageMode

Per ulteriori informazioni sulle modalità di linguaggio, consulta about_Language_Modes nella documentazione di Microsoft.