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 (Amazon EC2) 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'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 instance Amazon EC2, 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 : chaîne

  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.

• ECS InstanceId

  Type : chaîne

  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 : chaîne

  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'instance Amazon EC2 que vous spécifiez dans le ECSInstanceId paramètre possède un rôle IAM auquel est attachée 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.