Résoudre les problèmes liés aux instantanés VSS basés sur EBS Windows

Avant d’essayer d’autres étapes de résolution des problèmes, nous vous recommandons de vérifier les informations suivantes.

• Assurez-vous d’avoir respecté toutes les Conditions requises pour créer des instantanés VSS basés sur EBS Windows.

• Vérifiez que vous utilisez la dernière version de Prise en charge de la version du système d’exploitation Windows du package AwsVssComponents correspondant à votre système d’exploitation. Le problème que vous avez observé a peut-être été résolu dans les versions plus récentes.

Vérifier les fichiers journaux

Si vous rencontrez des problèmes ou recevez des messages d'erreur lorsque vous créez des EBS instantanés VSS basés, vous pouvez consulter le résultat de la commande dans la console Systems Manager.

Pour les documents Systems Manager qui créent des VSS instantanés, vous pouvez définir le CollectDiagnosticLogs paramètre sur « True » lors de l'exécution. Lorsque le CollectDiagnosticLogs paramètre est défini sur True « », VSS collecte des journaux supplémentaires pour faciliter le débogage. Pour de plus amples informations, veuillez consulter Collectez des journaux de diagnostic supplémentaires.

Si vous collectez des journaux de diagnostic, le document Systems Manager les stocke sur votre instance à l'emplacement suivant : C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip La valeur par défaut du CollectDiagnosticLogs paramètre est « False ».

Note

Pour obtenir de l'aide supplémentaire pour le débogage, vous pouvez envoyer le .zip fichier à AWS Support.

Les journaux supplémentaires suivants sont disponibles, que vous recueilliez des journaux de diagnostic ou non :

• %ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stdout

• %ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stderr

Vous pouvez également ouvrir l’application Observateur d’événements de Windows et sélectionner Journaux Windows, Application pour afficher les journaux supplémentaires. Pour voir les événements provenant spécifiquement du VSS fournisseur EC2 Windows et du service Volume Shadow Copy, filtrez par source selon les termes Ec2VssSoftwareProvider etVSS.

Si vous utilisez Systems Manager avec des VPC points de terminaison et que l'SendCommandAPIaction Systems Manager (Exécuter la commande dans la console) a échoué, vérifiez que vous avez correctement configuré le point de terminaison suivant : com.amazonaws.region.ec2.

Si le point de EC2 terminaison Amazon n'est pas défini, l'appel pour énumérer les EBS volumes attachés échoue, ce qui entraîne l'échec de la commande Systems Manager. Pour plus d'informations sur la configuration des VPC points de terminaison avec Systems Manager, voir Create a Virtual Private Cloud Endpoint dans le guide de l'AWS Systems Manager utilisateur.

Collectez des journaux de diagnostic supplémentaires

Pour collecter des journaux de diagnostic supplémentaires lorsque vous utilisez la commande d'envoi de Systems Manager pour exécuter le document VSS instantané, définissez le paramètre CollectDiagnosticLogs d'entrée sur « True » lors de l'exécution. Nous vous recommandons de définir ce paramètre sur « True » lors de la résolution des problèmes.

Pour voir un exemple de ligne de commande, sélectionnez l'un des onglets suivants.

AWS CLI

L'exemple suivant exécute le document AWSEC2-CreateVssSnapshot Systems Manager dans le 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'exemple suivant exécute le document AWSEC2-CreateVssSnapshot Systems Manager dans 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'}

Utilisation VSS sur des instances avec un proxy configuré

Si vous rencontrez des problèmes lors de la création de EBS snapshots VSS basés sur des instances qui utilisent un proxy pour atteindre les EC2 points de terminaison, vérifiez les paramètres suivants sur votre instance :

• Vérifiez que le proxy est configuré de manière à ce que les points de terminaison du EC2 service situés dans la région de l'instance IMDS soient accessibles en AWS Tools for Windows PowerShell exécutant sous SYSTEM le nom de.

• Pour prendre en charge l'utilisation du HTTP proxy Win configuré par le système, assurez-vous d'avoir installé la dernière AwsVssComponents version sur votre instance. Pour plus d'informations sur la configuration du HTTP proxy Win, consultez la section Commandes Netsh pour le protocole de transfert hypertexte Windows (WINHTTP) sur le site Web de Microsoft.

Erreur : le délai de connexion au canal de dégel a expiré, erreur lors du dégel, délai d'attente pour le VSS gel ou autres erreurs de délai

Le VSS fournisseur EC2 Windows peut expirer en raison d'une activité ou de services sur l'instance empêchant le traitement des instantanés VSS basés dans les délais impartis. Le Windows VSS Framework fournit une fenêtre non configurable de 10 secondes pendant laquelle la communication avec le système de fichiers est interrompue. Pendant ce temps, AWSEC2-CreateVssSnapshot crée des instantanés de vos volumes.

Les problèmes suivants peuvent faire en sorte que le VSS fournisseur EC2 Windows se heurte à des limites de temps lors d'un instantané :

• I/O excessives vers un volume

• Faible réactivité de EC2 API l'instance

• Volumes fragmentés

• Incompatibilité avec certains logiciels antivirus

• Problèmes avec un rédacteur VSS d'applications

• Lorsque la journalisation des modules est activée pour un grand nombre de PowerShell modules, cela peut entraîner un ralentissement de l'exécution PowerShell des scripts

La plupart des délais d’expiration qui se produisent lorsque vous exécutez le document de commande AWSEC2-CreateVssSnapshot sont liés au fait que la charge de travail sur l’instance est trop élevée au moment de la sauvegarde. Pour vous aider à créer un instantané avec succès, vous pouvez procéder comme suit :

• Réessayez la commande AWSEC2-CreateVssSnapshot pour voir si la tentative d’instantané réussit. Si une nouvelle tentative réussit dans certains cas, la réduction de la charge de l’instance peut favoriser la réussite des instantanés.

• Patientez le temps que la charge globale sur l’instance diminue, puis réessayez la commande AWSEC2-CreateVssSnapshot. Vous pouvez également essayer des instantanés lorsque vous savez que l’instance est soumise à une faible contrainte.

• Essayez de VSS créer des instantanés lorsque le logiciel antivirus du système est éteint. Si cela résout le problème, reportez-vous aux instructions du logiciel antivirus et configurez-le pour autoriser les VSS instantanés.

• S'il y a un volume élevé d'EC2APIappels Amazon sur votre compte dans la même région que celle où vous exécutez un instantané, la API limitation peut retarder les opérations de capture instantanée. Pour réduire l'impact de la régulation, utilisez le package le plus récentAwsVssComponents. Ce package utilise cette EC2 CreateSnapshots API action pour réduire le nombre d'actions mutantes telles que la création et le balisage d'instantanés par volume.

• Si plusieurs scripts de commande AWSEC2-CreateVssSnapshot s’exécutent en même temps, vous pouvez suivre les étapes suivantes pour réduire les problèmes de simultanéité.

  • Envisagez de planifier des instantanés pendant les périodes de faible API activité.

  • Si vous exécutez le script de commande Run Command dans la console Systems Manager (ou SendCommand dans leAPI), vous pouvez utiliser les contrôles de débit de Systems Manager pour réduire la simultanéité.

    Vous pouvez également utiliser les contrôles de débit de Systems Manager pour réduire la simultanéité des services tels AWS Backup que ceux qui utilisent Systems Manager pour exécuter le script de commande.

• Exécutez la commande vssadmin list writers dans un shell et voyez si celle-ci signale des erreurs dans le champ Last error pour tous les enregistreurs sur le système. Si des enregistreurs signalent une erreur time out, vous pouvez éventuellement réessayer de créer des instantanés lorsque l’instance sera moins chargée.

• Lorsque vous utilisez des types d'instances plus petits tels que t2 | t3 | t3a.nano ou t2 | t3 | t3a.micro, des délais d'attente dus à la mémoire et à des CPU contraintes peuvent survenir. Les actions suivantes peuvent contribuer à réduire les problèmes de délai d’expiration.

  • Essayez de fermer la mémoire ou de fermer les applications CPU intensives avant de prendre des instantanés.

  • Essayez de prendre des instantanés pendant les périodes de faible activité de l’instance.

Erreur : impossible d’invoquer la méthode. L’invocation de méthodes n’est prise en charge que sur les types principaux dans ce mode de langue.

Vous rencontrerez cette erreur lorsque le mode de PowerShell langue n'est pas défini surFullLanguage. Le AWSEC2-CreateVssSnapshot SSM document doit PowerShell être configuré en FullLanguage mode.

Pour vérifier le mode de langue, exécutez la commande suivante sur l'instance dans une PowerShell console :

$ExecutionContext.SessionState.LanguageMode

Pour plus d’informations sur les modes de langue, veuillez consulter la rubrique about_Language_Modes dans la documentation Microsoft.