AWSSupport-TroubleshootWindowsPerformance

AutomationAssumeRole（オプション):

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

InstanceId (必須):

オートメーションを実行するターゲット Amazon EC2 Windows インスタンスの ID。オートメーションを実行するには、インスタンスを Systems Manager によって管理する必要があります。

CaptureProcessDump (オプション):

キャプチャするプロセスダンプタイプ。自動化は、自動化の開始時にパフォーマンスに影響を与える可能性のあるプロセスの 1 つのプロセスダンプをキャプチャできます。インスタンスのルートボリュームには、少なくとも 10 GB の空き領域が必要です (ルートボリュームサイズが 100 GB を超える場合はディスクサイズの 10% を超え、プロセスが 10 GB を超えるメモリを消費する場合にプロセスで消費される合計メモリサイズを加えた値）。

LogCaptureDuration (オプション):

この自動化が問題の発生中にログをキャプチャ15する 1 から までの分数。デフォルトは 5 です。

LogUploadBucketName (オプション):

ログをアップロードするアカウントの Amazon S3 バケット。バケットはサーバー側の暗号化 (SSE) で設定する必要があり、バケットポリシーは、キャプチャされたログへのアクセスを必要としない当事者に不要な読み取り/書き込みアクセス許可を付与してはいけません。Amazon EC2 Windows インスタンスはAmazon S3バケットにアクセスできる必要があります。

InstallEC2RescueTool (オプション):

Yes ランブックが最新バージョンのEC2Rescueツールをインストールして Windows イベントとシステムログをキャプチャできるようにするには、 に設定します。デフォルトは No です。

確認 (必須):

このオートメーションランブックによって実行されるアクションの完全な詳細を読み、同意する場合は「」と入力しますYes, I understand and acknowledge。

CheckConcurrency:

インスタンスをターゲットとするこのランブックの実行が 1 つだけであることを確認します。ランブックが同じインスタンスをターゲットとする別の実行を検出した場合、エラーが返されて終了します。

AssertInstanceIsWindows:

Amazon EC2 インスタンスが Windows オペレーティングシステムで実行されていることをアサートします。それ以外の場合、自動化は終了します。

AssertInstanceIsManagedInstance:

Amazon EC2 インスタンスが管理対象であることをアサートします AWS Systems Manager。それ以外の場合、オートメーションは終了します。

VerifyPrerequisites:

インスタンス OS で PowerShell バージョンを検証し、インスタンスを Systems Manager 経由で接続して PowerShell コマンドを実行できることを確認します。このオートメーションは、Windows 8.1 / Server 2012 R2 (6.3) 以降で実行されている PowerShell 4.0 以降をサポートしています。バージョンが古い場合、自動化は失敗します。Amazon S3 バケットにログをアップロードすることを選択すると、このオートメーションは AWS Tools for PowerShell モジュールが利用可能であることを確認します。そうでない場合、オートメーションは終了します。

BranchOnProcessDump:

パフォーマンスに影響を与えたプロセスのダンプをキャプチャするように設定した場合に基づいて分岐します。

CaptureProcessDump:

インスタンスに、この自動化を実行するのに十分なスペースがあるかどうかを確認します (CPU/メモリの最大値を選択した場合）。

CapturePerformanceLogs:

ディスク容量を再度チェックし、インスタンスで PowerShell スクリプトを実行して perfmon カウンターを作成し、Performance Monitor と Windows Performance Recorder のログ記録を開始します。スクリプトLogCaptureDurationは、定義された が満たされると停止します。

SummarizePerformanceLogs:

前のステップ で生成された XML レポートを要約しCapturePerformanceLogs、オートメーションの出力として表示される WorkingSet64 (メモリ) と % プロセッサ時間 (CPU) を最も多く消費する責任あるプロセスを見つけます。LogicalDisk、Network Interface、Memory、TCPv4, IPv4UDPv4 の使用に関する同様の情報を生成し、出力フォルダanalysis_output.logに保存します。

BranchOnInstallEC2Rescue:

Amazon EC2 インスタンスに最新のEC2Rescueツールをインストールするように設定すると分岐します。

InstallEC2RescueTool:

インスタンス OS に EC2Rescue ツールをインストールして、 を使用してEC2RescueログをキャプチャしますAWS-ConfigureAWSPackage。

RunEC2RescueTool:

インスタンス OS でEC2Rescueツールを実行して、必要なすべてのログをキャプチャします。 は、スペースを節約するために必要なログのみをEC2Rescueキャプチャします。

BranchOnIfS3BucketProvided:

のユーザー入力に基づいて分岐LogUploadBucketNameし、ログをアップロードできるバケット名があるかどうかを確認します。

GetS3BucketPublicStatus:

Amazon S3 バケットが提供されているかどうかを判断し、提供されている場合は、Amazon S3 バケットがパブリックではなく、SSE で設定されていることを確認します。

UploadLogResult:

提供された Amazon S3 バケットにログをアップロードします。PowerShell バージョンが 5.0 以上の場合、ログは ZIP アーカイブに圧縮され、アップロードされます。アップロードが完了すると、ZIP ファイルを削除します。PowerShell バージョンが 5.0 未満の場合、ファイルはフォルダに直接アップロードされます。

CleanUpLogsOnFailure:

CapturePerformanceLogs ステップが失敗したときに生成されたすべてのログをクリーンアップします。SSM エージェントが正しく動作しない場合、または Windows システムが応答しない場合、CleanUpLogsOnFailureステップが失敗またはタイムアウトすることがあります。