Risolvi i problemi relativi alle istantanee EBS basate 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.

• Verifica di utilizzare la Supporto della versione del sistema operativo Windows più recente del pacchetto AwsVssComponents per il sistema operativo. Il problema riscontrato potrebbe essere stato risolto nelle versioni più recenti.

Controlla i file di registro

Se si verificano problemi o si ricevono messaggi di errore durante la creazione di istantanee EBS abilitate per VSS, è possibile visualizzare l'output del comando nella console Systems Manager.

Per i documenti Systems Manager che creano istantanee VSS, è possibile impostare il CollectDiagnosticLogs parametro su "True" in fase di esecuzione. Quando il CollectDiagnosticLogs parametro è impostato su "True«, VSS raccoglie registri aggiuntivi per facilitare il debug. Per ulteriori informazioni, consulta Raccogli registri diagnostici aggiuntivi.

Se raccogli registri di diagnostica, il documento Systems Manager li memorizza sulla tua istanza nella seguente posizione:C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip. L'impostazione predefinita per il CollectDiagnosticLogs parametro è "False».

Nota

Per ulteriore assistenza sul debug, puoi inviare il .zip file a. AWS Support

Sono disponibili i seguenti registri aggiuntivi, indipendentemente dal fatto che vengano raccolti 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'SendCommandAPI Systems Manager (Esegui comando nella console) non è riuscita, verifica di aver configurato correttamente il seguente endpoint: com.amazonaws. regione .ec2.

Senza l'endpoint Amazon EC2 definito, la chiamata per enumerare i volumi EBS collegati ha esito negativo, causando il fallimento del comando Systems Manager. Per ulteriori informazioni sulla configurazione degli endpoint VPC con Systems Manager, consulta Creazione di un endpoint VPC nella AWS Systems Manager Guida per l'utente di .

Raccogli registri diagnostici aggiuntivi

Per raccogliere registri diagnostici aggiuntivi quando si utilizza il comando send di Systems Manager per eseguire il documento snapshot VSS, impostare il parametro di CollectDiagnosticLogs input su "True" in fase di esecuzione. Si consiglia di impostare questo parametro su "True" durante la risoluzione dei problemi.

Per vedere un esempio di riga di comando, seleziona una delle seguenti schede.

AWS CLI

L'esempio seguente esegue il documento AWSEC2-CreateVssSnapshot Systems Manager 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'}

Utilizza VSS su istanze con proxy configurato

Se riscontri problemi durante la creazione di snapshot EBS compatibili con VSS su istanze che utilizzano un proxy per raggiungere gli endpoint EC2, assicurati di quanto segue:

• Il proxy è configurato in modo che gli endpoint del servizio EC2 nella regione e nell'IMDS dell'istanza siano raggiungibili eseguendo come SYSTEM. AWS Tools for Windows PowerShell

• È installato AwsVssComponents versione 2.0.1 o successiva. A partire da AwsVssComponents versione 2.0.1, il provider VSS EC2 supporta l'utilizzo del proxy WinHTTP configurato dal sistema. 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 abilitati per 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 il Module Logging è abilitato per un gran numero di PowerShell moduli, ciò può causare un rallentamento dell'esecuzione degli script PowerShell

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 della limitazione, utilizzare la versione più recente del pacchetto AwsVssComponents (versione 2.1.0 e successive, con autorizzazioni di prerequisito). 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 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

Questo errore si verificherà quando la modalità della PowerShell lingua non è impostata su. FullLanguage I documenti AWSEC2-CreateVssSnapshot e AWSEC2-ManageVssIo SSM devono PowerShell essere configurati 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_Language_Modes nella documentazione di Microsoft.