AWSSupport-CollectECSInstanceLogs - AWS Systems Manager Guide de référence du manuel d'automatisation

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.

AWSSupport-CollectECSInstanceLogs

Description

Le AWSSupport-CollectECSInstanceLogs runbook collecte les fichiers journaux relatifs au système d'exploitation et à Amazon Elastic Container Service (Amazon ECS) à partir d'une instance Amazon Elastic Compute Cloud ( EC2Amazon) afin de vous aider à résoudre les problèmes courants liés à Amazon ECS. Pendant que l'automatisation collecte les fichiers journaux associés, des modifications sont apportées au système de fichiers. Ces modifications incluent la création de répertoires temporaires et d'un répertoire de journaux, la copie de fichiers journaux dans ces répertoires et la compression des fichiers journaux dans une archive.

Si vous spécifiez une valeur pour le LogDestination paramètre, l'interface de ligne de AWS commande (AWS CLI) pour les instances Linux ou les AWS outils pour Windows PowerShell pour les instances Windows doivent être installés sur l'instance cible. L'automatisation évalue l'état de la politique du bucket Amazon Simple Storage Service (Amazon S3) que vous spécifiez. Pour renforcer la sécurité des journaux collectés depuis votre EC2 instance Amazon, si le statut de la politique isPublic est défini surtrue, ou si la liste de contrôle d'accès (ACL) accorde des READ|WRITE autorisations au groupe prédéfini All Users Amazon S3, les journaux ne sont pas chargés. De plus, si le bucket fourni n'est pas disponible dans votre compte, les journaux ne sont pas chargés. Pour plus d'informations sur les groupes prédéfinis Amazon S3, consultez les groupes prédéfinis Amazon S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux, Windows

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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 lance ce runbook.

  • ECSInstanceId

    Type : String

    Description : (Obligatoire) L'ID de l'instance à partir de laquelle vous souhaitez collecter des journaux. L'instance que vous spécifiez doit être gérée par Systems Manager.

  • LogDestination

    Type : String

    Description : (Facultatif) Le compartiment Amazon S3 dans lequel vous Compte AWS souhaitez télécharger les journaux archivés.

Autorisations IAM requises

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

  • ssm:ListCommandInvocations

  • ssm:ListCommands

  • ssm:SendCommand

  • ssm:DescribeInstanceInformation

Nous recommandons que l' EC2 instance Amazon que vous spécifiez dans le ECSInstanceId paramètre ait un rôle IAM associé à la politique gérée par AmazonSSMManagedInstanceCore Amazon. Pour télécharger l'archive du journal dans le compartiment Amazon S3 que vous spécifiez dans le LogDestination paramètre, vous devez ajouter les autorisations suivantes :

  • s3:PutObject

  • s3:ListBucket

  • s3:GetBucketPolicyStatus

  • s3:GetBucketAcl

Étapes de document

  • assertInstanceIsManaged- Vérifie si l'instance que vous spécifiez dans le ECSInstanceId paramètre est gérée par Systems Manager.

  • getInstancePlatform- Obtient des informations sur la plate-forme du système d'exploitation (OS) de l'instance spécifiée dans le ECSInstanceId paramètre.

  • verifyInstancePlatform- Branche l'automatisation en fonction de la plate-forme du système d'exploitation.

  • runLogCollectionScriptOnLinux- Rassemble les fichiers journaux liés au système d'exploitation et à Amazon ECS sur les instances Linux et crée un fichier d'archive dans le /var/log/collectECSlogs répertoire.

  • runLogCollectionScriptOnWindows- Rassemble les fichiers journaux liés au système d'exploitation et à Amazon ECS sur les instances Windows et crée un fichier d'archive dans le C:\ProgramData\collectECSlogs répertoire.

  • verifyIfS3BucketProvided- Vérifie si une valeur a été spécifiée pour le LogDestination paramètre.

  • runUploadScript- Branche l'étape d'automatisation en fonction de la plate-forme du système d'exploitation.

  • runUploadScriptOnLinux- Télécharge l'archive du journal dans le compartiment Amazon S3 spécifié dans le LogDestination paramètre et supprime le fichier journal archivé du système d'exploitation.

  • runUploadScriptOnWindows- Télécharge l'archive du journal dans le compartiment Amazon S3 spécifié dans le LogDestination paramètre et supprime le fichier journal archivé du système d'exploitation.