AWSSupport-CollectEKSInstanceLogs - AWS Systems Manager 自動化ランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-CollectEKSInstanceLogs

説明

AWSSupport-CollectEKSInstanceLogs ランブックは、一般的な問題のトラブルシューティングに役立つように、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスからオペレーティングシステムと Amazon Elastic Kubernetes Service (Amazon EKS) に関連するログファイルを収集します。自動化によって関連するログファイルが収集される間、一時ディレクトリの作成、ログファイルの一時ディレクトリへのコピー、ログファイルのアーカイブへの圧縮など、ファイルシステム構造が変更されます。このアクティビティにより、EC2 インスタンスで CPUUtilization が増加する可能性があります。詳細についてはCPUUtilization、Amazon CloudWatch ユーザーガイドの 「インスタンスメトリックス」を参照してください。

LogDestination パラメータの値を指定すると、指定した Amazon Simple Storage Service (Amazon S3) バケットのポリシーステータスが自動化によって評価されます。EC2 インスタンスから収集されたログのセキュリティを支援するために、ポリシーステータス isPublic がtrue に設定されている場合、またはアクセスコントロールリスト (ACL) が All Users Amazon S3 事前定義済みグループに READ|WRITE アクセス許可を付与している場合、ログはアップロードされません。Amazon S3 の定義済みグループの詳細については、Amazon Simple Storage Service ユーザーガイドの「Amazon S3 の定義済みグループ」を参照してください。

注記

このオートメーションでは、EC2 インスタンスにアタッチされたルート Amazon Elastic Block Store (Amazon EBS) ボリュームの空きディスク容量の 10% 以上が必要です。ルートボリュームに十分な空きディスク容量がない場合、自動化は停止します。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

[Platforms] (プラットフォーム)

Linux

パラメータ

  • AutomationAssumeRole

    型: 文字列

    説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

  • EKS InstanceId

    型: 文字列

    説明: (必須) ログを収集する元の Amazon EKS EC2 インスタンスの ID。

  • LogDestination

    型: 文字列

    説明: (オプション) アーカイブされたログをアップロードするアカウントの S3 バケット。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:SendCommand

コマンドを受け取る EC2 インスタンスには、AmazonSSM ManagedInstanceCore Amazon 管理ポリシーがアタッチされた IAM ロールを持つことをお勧めします。LogDestination パラメータで指定した S3 バケットにログアーカイブをアップロードするには、s3:PutObject アクセス許可を追加する必要があります。

ドキュメントステップ

  • aws:assertAwsResourceProperty - EKSInstanceId パラメータで指定された値のオペレーティングシステムが Linux であることを確認します。

  • aws:runCommand - オペレーティングシステムおよび Amazon EKS に関連するログファイルを収集し、/var/log ディレクトリ内のアーカイブに圧縮します。

  • aws:branch - LogDestination パラメータに値が指定されたかどうかを確認します。

  • aws:runCommand - LogDestination パラメータで指定した S3 バケットにログアーカイブをアップロードします。