Quick Setup の結果のトラブルシューティング - AWS Systems Manager

Quick Setup の結果のトラブルシューティング

AWS Systems Manager の一機能である Quick Setup で問題が生じた場合にトラブルシューティングする際は、次の情報が役に立ちます。このトピックには、Quick Setup の問題のタイプに基づいて問題を解決するための特定のタスクが含まれています。

問題: デプロイの失敗

CloudFormation スタックセットの作成が失敗した場合、デプロイは失敗します。デプロイの失敗を調査するには、以下のステップを使用します。

  1. AWS CloudFormation コンソールに移動します。

  2. Quick Setup 設定で作成されたスタックを選択します。[Stack name] (スタックの名前) には、QuickSetup と、それに続き選択した設定のタイプ (例えば SSMHostMgmt) が含まれます。

    注記

    CloudFormation は、失敗したスタックのデプロイを削除することがあります。スタックが [Stacks] (スタック) テーブルに表示されない場合は、フィルターリストから [Deleted] (削除済み) を選択します。

  3. [Status] (ステータス) と [Status reason] (ステータス理由) を表示します。スタックのステータスの詳細については、「AWS CloudFormationユーザーガイド」の「スタックステータスコード」を参照してください。

  4. 失敗したステップを正確に把握するには、[Events] (イベント) タブを開き、各イベントの [Status] (ステータス) を確認します。

  5. 「AWS CloudFormationユーザーガイド」の「トラブルシューティング」を確認してください。

  6. CloudFormation のトラブルシューティングに関するステップによりデプロイの失敗を解決できない場合は、設定を削除した上で再設定を行います。

問題: 失敗した関連付け

セットアップ中にいずれかの関連付けが失敗した場合、[Configuration details] (設定の詳細) ページの [Configuration details] (設定の詳細) テーブルには、[Configuration status] (設定ステータス) として [Failed] (失敗) が表示されます。失敗した関連付けのトラブルシューティングを行うには、次のステップを実行します。

  1. [Configuration details] (設定の詳細) テーブルで、失敗した設定を選択し、[View Details] (詳細を表示) をクリックします。

  2. [Association name] (関連付け名) をコピーします。

  3. State Manager に移動し、その関連付け名を検索フィールドに貼り付けます。

  4. 関連付けを選択した上で、[Execution history] (実行履歴) タブを開きます。

  5. [Execution ID (実行 ID)] で、失敗した関連付けの実行を選択します。

  6. [Association execution targets] (関連付け実行ターゲット) ページには、関連付けが実行されたすべてのノードが一覧表示されます。実行に失敗した実行の [Output (出力)] ボタンを選択します。

  7. [Output (出力)] ページで、[Step - Output (ステップ - 出力)] を選択して、コマンド実行のステップのエラーメッセージを表示します。各ステップで異なるエラーメッセージを表示できます。すべてのステップのエラーメッセージを確認して、問題のトラブルシューティングに役立ててください。

ステップ出力を表示しても問題を解決しない場合は、関連付けを再作成できます。関連付けを再作成するには、まず、State Manager で失敗した関連付けを削除します。関連付けを削除したら、設定を編集して削除したオプションを指定し直し、その後、[Update] (更新) をクリックします。

注記

[Organization] (組織) に対して [Failed] (失敗) した関連付けを調査するには、先述のとおり、失敗した関連付けを持つアカウントにサインインし、以下の手順を行う必要があります。管理アカウントからの結果を表示する場合、[関連付け ID] はターゲットアカウントへのハイパーリンクではありません。

問題: ドリフトステータス

設定の詳細ページを開くと、各デプロイのドリフトステータスを表示できます。設定のドリフトは、Quick Setup で行った選択と競合するサービスまたは機能に対し、ユーザーが変更を加えるたびに発生します。初期設定後に関連付けが変更された場合、ドリフトした項目の数を示す警告アイコンがテーブルに表示されます。アイコンの上にカーソルを置くと、ドリフトの原因を見ることができます。

State Manager で関連付けが削除されると、関連するデプロイにはドリフトに関する警告が表示されます。これを修正するには、設定を編集し、関連付けとともに削除されたオプションを選択します。[Update] (更新) をクリックし、デプロイが完了するのを待ちます。