View a markdown version of this page

AWSPremiumSupport-DiagnoseDiskUsageOnWindows - AWS Systems Manager Référence du dossier d’exploitation Automation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWSPremiumSupport-DiagnoseDiskUsageOnWindows

Description

Le AWSPremiumSupport-DiagnoseDiskUsageOnWindows runbook analyse les volumes Amazon Elastic Block Store (Amazon EBS) de l'instance Amazon Elastic Compute Cloud (Amazon EC2) cible afin de déterminer s'ils nécessitent une extension. Il vérifie l'utilisation, le type de système de fichiers et l'historique d'extension de chaque volume par rapport aux seuils définis dans les paramètres d'entrée du runbook. Le script prend en compte des facteurs tels que les modifications récentes, les systèmes de fichiers pris en charge et les limites de AWS volume. Il affiche ensuite les volumes, le cas échéant, susceptibles d'être étendus, ainsi que les détails pertinents pour chaque volume.

Fonctionnement

Ce runbook effectue les opérations suivantes :

  • Vérifie que l'instance cible est gérée par Systems Manager.

  • Récupère les détails de l'instance, y compris la plate-forme et les volumes associés.

  • Branche sur la plateforme et continue uniquement si l'instance cible est en cours d'exécutionWindows.

  • Décrit toutes les modifications de volumes Amazon EBS en cours ou ayant récemment échoué sur les volumes d'instance.

  • Exécute des prévérifications Windows pour analyser l'utilisation du disque et déterminer les extensions possibles.

  • Émet les volumes susceptibles d'être augmentés avec des informations pertinentes.

Important

L'accès aux AWSPremiumSupport-* runbooks nécessite un abonnement Business + Support, Enterprise Support ou Unified Operations. Pour plus d'informations, consultez la section Comparer les AWS Support forfaits.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Windows

Paramètres

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

  • ec2:DescribeVolumesModifications

  • ssm:SendCommand

  • ssm:ListCommandInvocations

Exemple de politique IAM


 {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ssm:DescribeInstanceInformation",
                 "ec2:DescribeInstances",
                 "ec2:DescribeVolumesModifications",
                 "ssm:SendCommand",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }

Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Ouvrez AWSPremiumSupport-DiagnoseDiskUsageOnWindows dans le Gestionnaire de systèmes sous Documents.

  2. Choisissez Execute automation (Exécuter l’automatisation).

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole (Facultatif) :

      • Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

      • Type : AWS::IAM::Role::Arn

    • InstanceId (Obligatoire) :

      • Description : ID (obligatoire) de votre instance Amazon EC2.

      • Type : String

      • Autoriser le schéma : ^i-[a-z0-9]{8,17}$

    • VolumeExpansionUsageTrigger (Obligatoire) :

      • Description : (Obligatoire) Utilisation minimale de l'espace de partition requise pour déclencher l'extension (en pourcentage).

      • Type : String

      • Autoriser le schéma : ^[0-9]{1,2}$

    • VolumeExpansionCapSize (Obligatoire) :

      • Description : (Obligatoire) Taille maximale à laquelle le volume Amazon EBS sera augmenté (en GiB).

      • Type : String

      • Autoriser le schéma : ^[0-9]{1,4}$

    • VolumeExpansionGibIncrease (Obligatoire) :

      • Description : (Obligatoire) Augmentation du volume en GiB. L'augmentation nette la plus importante entre VolumeExpansionGibIncrease et VolumeExpansionPercentageIncrease sera utilisée.

      • Type : String

      • Autoriser le schéma : ^[0-9]{1,4}$

    • VolumeExpansionPercentageIncrease (Obligatoire) :

      • Description : (Obligatoire) Augmentation du pourcentage du volume. L'augmentation nette la plus importante entre VolumeExpansionGibIncrease et VolumeExpansionPercentageIncrease sera utilisée.

      • Type : String

      • Autoriser le schéma : ^[0-9]{1,2}$

  4. Sélectionnez Execute (Exécuter).

  5. L'automatisation démarre.

  6. Le runbook exécute les étapes suivantes :

    • AssertInstanceIsManagedInstance:

      Vérifie si l'instance cible est gérée par Systems Manager.

    • DescribeInstance:

      Décrit l'instance Amazon EC2 cible et extrait les détails de l'instancePlatform, y comprisInstanceType, et les pièces jointes. VolumeIds

    • BranchOnPlatform:

      Vérifie si la plate-forme d'instance Amazon EC2 cible est Windows Server et poursuit l'exécution si c'est le cas.

    • DescribeVolumesModifications:

      Décrit les modifications de volume Amazon EBS en cours ou ayant récemment échoué sur les volumes d'instance.

    • RunPreChecksOnWindows:

      Exécute le PowerShell script sur l'instance Amazon EC2 cible pour effectuer une analyse de l'utilisation du disque et générer des recommandations d'extension.

  7. Une fois l'exécution terminée, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution.

Références

Systems Manager Automation