View a markdown version of this page

AWSSupport-CollectElasticBeanstalkLogs - 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.

AWSSupport-CollectElasticBeanstalkLogs

Beschreibung

Das AWSSupport-CollectElasticBeanstalkLogs Runbook sammelt AWS Elastic Beanstalk zugehörige Protokolldateien von einer Amazon Elastic Compute Cloud (Amazon EC2) Windows Server -Instance, die von Elastic Beanstalk gestartet wurde, um Sie bei der Behebung häufig auftretender Probleme zu unterstützen. Während die Automatisierung die zugehörigen Protokolldateien sammelt, werden Änderungen an der Dateisystemstruktur vorgenommen, einschließlich der Erstellung temporärer Verzeichnisse, des Kopierens von Protokolldateien in die temporären Verzeichnisse und des Komprimierens der Protokolldateien in ein Archiv. Diese Aktivität kann zu einer Zunahme der CPUUtilization Amazon EC2-Instance führen. Weitere Informationen dazu finden Sie CPUUtilization unter Instance-Metriken im CloudWatch Amazon-Benutzerhandbuch.

Wenn Sie einen Wert für den S3BucketName Parameter angeben, wertet die Automatisierung den Policy-Status des von Ihnen angegebenen Amazon Simple Storage Service (Amazon S3) -Buckets aus. Um die Sicherheit der von Ihrer Amazon EC2-Instance gesammelten Protokolle zu gewährleisten, werden die Protokolle nicht hochgeladentrue, wenn der Richtlinienstatus auf gesetzt isPublic ist oder wenn die Zugriffskontrollliste (ACL) READ|WRITE Berechtigungen für die vordefinierte All Users Amazon S3-Gruppe gewährt. Weitere Informationen zu vordefinierten Amazon S3-Gruppen finden Sie unter Vordefinierte Amazon S3-Gruppen im Amazon Simple Storage Service-Benutzerhandbuch.

Wenn Sie keinen Wert für den S3BucketName Parameter angeben, lädt die Automatisierung das Protokollpaket in den standardmäßigen Elastic Beanstalk Amazon S3-Bucket hoch, in AWS-Region dem Sie die Automatisierung ausführen. Das Verzeichnis ist gemäß der folgenden Struktur benannt:. elasticbeanstalk- region - accountID Die accountID Werte region und unterscheiden sich je nach Region, in der AWS-Konto Sie die Automatisierung ausführen. Das Protokollpaket wird im resources/environments/logs/bundle/ environmentID / instanceID Verzeichnis gespeichert. Die instanceID Werte environmentID und unterscheiden sich je nach Ihrer Elastic Beanstalk-Umgebung und der Amazon EC2-Instance, von der Sie Protokolle sammeln.

Standardmäßig verfügt das AWS Identity and Access Management (IAM-) Instance-Profil, das an die Amazon EC2-Instances der Elastic Beanstalk-Umgebung angehängt ist, über die erforderlichen Berechtigungen, um das Paket in den standardmäßigen Elastic Beanstalk Amazon S3-Bucket für Ihre Umgebung hochzuladen. Wenn Sie einen Wert für den S3BucketName Parameter angeben, muss das an die Amazon EC2-Instance angehängte Instanzprofil die s3:PutObject Aktionens3:GetBucketAcl, s3:GetBucketPolicys3:GetBucketPolicyStatus, und für den angegebenen Amazon S3-Bucket und -Pfad zulassen.

Anmerkung

Für diese Automatisierung sind mindestens 500 MB verfügbarer Festplattenspeicher auf dem Amazon Elastic Block Store (Amazon EBS) -Root-Volume erforderlich, das mit Ihrer Amazon EC2-Instance verknüpft ist. Wenn auf dem Root-Volume nicht genügend Speicherplatz verfügbar ist, wird die Automatisierung beendet.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Windows

Parameter

  • AutomationAssumeRole

    Typ: Zeichenfolge

    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.

  • EnvironmentId

    Typ: Zeichenfolge

    Beschreibung: (Erforderlich) Die ID Ihrer Elastic Beanstalk-Umgebung, aus der Sie das Log-Paket abrufen möchten.

  • InstanceId

    Typ: Zeichenfolge

    (Erforderlich) Die ID der Amazon EC2-Instance in Ihrer Elastic Beanstalk-Umgebung, aus der Sie das Log-Paket abrufen möchten.

  • S3BucketName

    Typ: Zeichenfolge

    (Optional) Der Amazon S3-Bucket, in den Sie die archivierten Protokolle hochladen möchten.

  • S3BucketPath

    Typ: Zeichenfolge

    (Optional) Der Amazon S3-Bucket-Pfad, in den Sie das Protokollpaket hochladen möchten. Dieser Parameter wird ignoriert, wenn Sie keinen Wert für den S3BucketName Parameter angeben.

Erforderliche IAM-Berechtigungen

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

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:SendCommand

  • ssm:DescribeInstanceInformation

  • ec2:DescribeInstances

Dokumentschritte

  • aws:assertAwsResourceProperty— Bestätigt, dass die Amazon EC2-Instance, die Sie im InstanceId Parameter angeben, von verwaltet wird. AWS Systems Manager

  • aws:assertAwsResourceProperty— Bestätigt, dass es sich bei der Amazon EC2-Instance, die Sie im InstanceId Parameter angeben, um eine Windows Server Instance handelt.

  • aws:runCommand— Prüft, ob die Instance Teil einer Elastic Beanstalk-Umgebung ist, ob ausreichend Speicherplatz zum Bündeln der Protokolle vorhanden ist und ob der Amazon S3-Bucket, in den die Protokolle hochgeladen werden, öffentlich ist.

  • aws:runCommand— Sammelt die Protokolldateien und lädt das Archiv in den im S3BucketName Parameter angegebenen Amazon S3-Bucket hoch oder in den Standard-Bucket für Ihre Elastic Beanstalk-Umgebung, falls kein Wert angegeben ist.