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

# `AWSSupport-TroubleshootLinuxMGNDRSAgentLogs`
<a name="automation-troublshoot-linux-mngdrs-agent-logs"></a>

 **説明** 

 `AWSSupport-TroubleshootLinuxMGNDRSAgentLogs` オートメーションランブックは、Linux サーバーに AWS Application Migration Service (AWS MGN) および AWS Elastic Disaster Recovery (AWS DRS) レプリケーションエージェントをインストールしてソースサーバーを AWS クラウドに移行するときに一般的なエラーを検出するために使用されます。

 **動作の仕組み** 

 ランブック`AWSSupport-TroubleshootLinuxMGNDRSAgentLogs`は、MGN または AWS DRS インストールログ`aws_replication_agent_installer.log`がパラメータとしてアップロードされる Amazon Simple Storage Service (Amazon S3) AWS パスを取得します。次に、次のタスクを実行します。
+ **検証:** 提供されたログファイルが有効で、少なくとも 1 つのエージェントインストールが含まれているかどうかを確認します。
+ **解析:** 既知の AWS MGN または AWS DRS エラーについて、ログファイル内の最新のエージェントインストールを徹底的に解析します。
+ **エラーの検出と解決:** 解析に基づいて、エージェントのインストールプロセス中にエラーや問題を検出して一覧表示します。検出されたエラーごとに、ランブックには問題の解決または軽減に役立つ詳細な手順が記載されています。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootLinuxMGNDRSAgentLogs) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

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

Linux

**パラメータ**

**必要な IAM アクセス許可**

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

 **指示** 

次の手順に従って自動化を設定します。

1. ドキュメントの Systems Manager [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootLinuxMGNDRSAgentLogs/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootLinuxMGNDRSAgentLogs/description)で に移動します。

1. [Execute automation] (オートメーションを実行) を選択します。

1. 入力パラメータには、次のように入力します。
   + **AutomationAssumeRole（オプション):**

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

     レプリケーションエージェントログが保存されている Amazon S3 バケットの名前。
   + **S3ObjectKey (必須):**

     レプリケーションエージェントのインストーラログファイルが保存されている Amazon S3 オブジェクトのキー。例: Amazon S3 URI が の場合`s3://bucket_name/path/to/file/aws_replication_agent_installer.log`、 を入力する必要があります`path/to/file/aws_replication_agent_installer.log`。
   + **ServiceName (必須):**

     レプリケーションエージェントがインストールされているサービスの名前。使用できる値: `AWS MGN` または `AWS DRS`  
![\[Input parameters form for AWS replication agent with fields for role, bucket name, object key, and service.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/automation-troublshoot-linux-mngdrs-agent-logs_input_parameters.png)

1. [実行] を選択します。

1. 自動化が開始されます。

1. ドキュメントは以下のステップを実行します。
   + **`ValidateInput`**

     指定された Amazon S3 バケット名とオブジェクトへのパスを使用して、レプリケーションエージェントのログファイルが有効でアクセス可能であることを確認し、最新のエージェントインストールのバイト数を返します。
   + **`CheckReplicationAgentLogErrors`**

     最新のインストールバイトからレプリケーションエージェントのログファイルを読み取り、既知の AWS MGN または AWS DRS エラーを検索します。
   + **`MakeFinalOutput`**

      見つかったエラーに関する情報やトラブルシューティングの推奨事項など、前のチェックからの出力を作成します。

1. 完了したら、出力セクションで実行の詳細な結果を確認します。  
![\[Output showing validation step, error detection, and troubleshooting steps for kernel package installation.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/automation-troublshoot-linux-mngdrs-agent-logs_outputs.png)

 **リファレンス** 

Systems Manager Automation
+ [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootLinuxMGNDRSAgentLogs/description)
+ [オートメーションを実行する](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [オートメーションの設定](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [「自動化ワークフローをサポート」ランディングページ](https://aws.amazon.com/premiumsupport/technology/saw/)