AWSSupport-CollectEKSInstanceLogs

Description

Le AWSSupport-CollectEKSInstanceLogs runbook rassemble les fichiers journaux relatifs au système d'exploitation et à Amazon Elastic Kubernetes Service (Amazon EKS) à partir d'une instance Amazon Elastic Compute Cloud (Amazon EC2) afin de vous aider à résoudre les problèmes courants. Pendant que l'automatisation collecte les fichiers journaux associés, des modifications sont apportées à la structure du système de fichiers, notamment la création de répertoires temporaires, la copie des fichiers journaux dans les répertoires temporaires et la compression des fichiers journaux dans une archive. Cette activité peut entraîner une augmentation de CPUUtilization l'instance EC2. Pour plus d'informationsCPUUtilization, consultez la section Mesures relatives aux instances dans le guide de CloudWatch l'utilisateur Amazon.

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

Note

Cette automatisation nécessite au moins 10 % de l'espace disque disponible sur le volume racine Amazon Elastic Block Store (Amazon EBS) attaché à votre instance EC2. Si l'espace disque disponible sur le volume racine est insuffisant, l'automatisation s'arrête.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux

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.

• EKS InstanceId

  Type : chaîne

  Description : ID (obligatoire) de l'instance Amazon EKS EC2 à partir de laquelle vous souhaitez collecter des journaux.

• LogDestination

  Type : chaîne

  Description : (Facultatif) Le compartiment S3 de votre compte dans lequel vous 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:StartAutomationExecution

• ssm:GetAutomationExecution

• ssm:SendCommand

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

Étapes de document

• aws:assertAwsResourceProperty- Confirme que le système d'exploitation de la valeur spécifiée dans le EKSInstanceId paramètre est Linux.

• aws:runCommand- Rassemble les fichiers journaux liés au système d'exploitation et à Amazon EKS, en les compressant dans une archive dans le /var/log répertoire.

• aws:branch- Confirme si une valeur a été spécifiée pour le LogDestination paramètre.

• aws:runCommand- Télécharge l'archive du journal dans le compartiment S3 que vous spécifiez dans le LogDestination paramètre.