AWSSupport-CollectEKSInstanceLogs - 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-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 EC2 (Amazon) pour 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 CPUUtilization de l' EC2 instance. 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 EC2 instance, 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 : 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.

  • EKSInstanceId

    Type : String

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

  • LogDestination

    Type : String

    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' EC2 instance recevant la commande ait un rôle IAM associé à la politique gérée par SSMManagedInstanceCoreAmazon. 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.