View a markdown version of this page

AWSPremiumSupport-DiagnoseDiskUsageOnWindows - AWS Systems Manager Runbook-Referenz für Automation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSPremiumSupport-DiagnoseDiskUsageOnWindows

Beschreibung

Das AWSPremiumSupport-DiagnoseDiskUsageOnWindows Runbook analysiert die Amazon Elastic Block Store (Amazon EBS) -Volumes der Amazon Elastic Compute Cloud (Amazon EC2) -Instance, um festzustellen, ob sie erweitert werden müssen. Es überprüft die Nutzung, den Dateisystemtyp und den Erweiterungshistorie jedes Volumes anhand der in den Runbook-Eingabeparametern definierten Schwellenwerte. Das Skript berücksichtigt Faktoren wie aktuelle Änderungen, unterstützte Dateisysteme und AWS Volumenbeschränkungen. Anschließend gibt es die Volumes, falls vorhanden, aus, die für eine Erweiterung in Frage kommen, zusammen mit den entsprechenden Details für jedes Volume.

Wie funktioniert es?

Dieses Runbook führt die folgenden Operationen aus:

  • Überprüft, ob die Zielinstanz von Systems Manager verwaltet wird.

  • Ruft Instanzdetails ab, einschließlich Plattform und angehängter Volumes.

  • Verzweigt auf der Plattform und fährt nur fort, wenn die Zielinstanz läuftWindows.

  • Beschreibt alle laufenden oder kürzlich fehlgeschlagenen Amazon EBS-Volume-Änderungen auf den Instance-Volumes.

  • Führt Vorabprüfungen durchWindows, um die Festplattennutzung zu analysieren und Erweiterungskandidaten zu ermitteln.

  • Gibt Volumes aus, die für eine Erweiterung infrage kommen, mit relevanten Details.

Wichtig

Für den Zugriff auf AWSPremiumSupport-* Runbooks ist ein Abonnement für Business + Support, Enterprise Support oder Unified Operations erforderlich. Weitere Informationen finden Sie unter AWS Support Tarife https://aws.amazon.com/premiumsupport/plans/ vergleichen.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Windows

Parameter

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

  • ec2:DescribeVolumesModifications

  • ssm:SendCommand

  • ssm:ListCommandInvocations

Beispiel für eine IAM-Richtlinie


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

Anweisungen

Folgen Sie diesen Schritten, um die Automatisierung zu konfigurieren:

  1. Öffnen Sie AWSPremiumSupport-DiagnoseDiskUsageOnWindows im Systems Manager unter Dokumente.

  2. Wählen Sie Automatisierung ausführen.

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ):

      • Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

      • Typ: AWS::IAM::Role::Arn

    • InstanceId (Erforderlich):

      • Beschreibung: (Erforderlich) ID Ihrer Amazon EC2-Instance.

      • Typ: String

      • Muster zulassen: ^i-[a-z0-9]{8,17}$

    • VolumeExpansionUsageTrigger (Erforderlich):

      • Beschreibung: (Erforderlich) Mindestnutzung des Partitionsspeichers, der erforderlich ist, um die Erweiterung auszulösen (in Prozent).

      • Typ: String

      • Muster zulassen: ^[0-9]{1,2}$

    • VolumeExpansionCapSize (Erforderlich):

      • Beschreibung: (Erforderlich) Maximale Größe, auf die das Amazon EBS-Volume erhöht wird (in GiB).

      • Typ: String

      • Muster zulassen: ^[0-9]{1,4}$

    • VolumeExpansionGibIncrease (Erforderlich):

      • Beschreibung: (Erforderlich) Erhöhung des Volumens um GiB. Der größte Nettozuwachs zwischen VolumeExpansionGibIncrease und VolumeExpansionPercentageIncrease wird verwendet.

      • Typ: String

      • Muster zulassen: ^[0-9]{1,4}$

    • VolumeExpansionPercentageIncrease (Erforderlich):

      • Beschreibung: (Erforderlich) Erhöhung des Prozentsatzes des Volumens. Der größte Nettozuwachs zwischen VolumeExpansionGibIncrease und VolumeExpansionPercentageIncrease wird verwendet.

      • Typ: String

      • Muster zulassen: ^[0-9]{1,2}$

  4. Wählen Sie Ausführen.

  5. Die Automatisierung wird initiiert.

  6. Das Runbook führt die folgenden Schritte aus:

    • AssertInstanceIsManagedInstance:

      Prüft, ob die Zielinstanz von Systems Manager verwaltet wird.

    • DescribeInstance:

      Beschreibt die Amazon EC2-Zielinstanz und ruft die Instance-Details einschließlich PlatformInstanceType, und angehängt ab. VolumeIds

    • BranchOnPlatform:

      Prüft, ob es sich bei der Amazon EC2-Zielinstanzplattform um eine solche handelt, Windows Server und setzt die Ausführung in diesem Fall fort.

    • DescribeVolumesModifications:

      Beschreibt die laufenden oder kürzlich fehlgeschlagenen Amazon EBS-Volume-Änderungen auf den Instance-Volumes.

    • RunPreChecksOnWindows:

      Führt das PowerShell Skript auf der Amazon EC2-Zielinstanz aus, um die Festplattenauslastung zu analysieren und Erweiterungsempfehlungen zu generieren.

  7. Nach Abschluss des Vorgangs finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung.

Referenzen

Systems Manager Automation