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

トラブルシューティングと診断

このセクションでは、IIS アプリケーションの Elastic Beanstalk への移行中に発生する可能性がある一般的な問題のトラブルシューティングに関するガイダンスを提供します。

EC2 キーペアを環境に関連付ける

Elastic Beanstalk アプリケーション用にプロビジョンされた Amazon Elastic Compute Cloud (Amazon EC2) インスタンスには、Amazon EC2 キーペアを使用して安全にログインできます。キーペアを作成する手順については、「Amazon EC2 ユーザーガイド」の「Amazon EC2 を使用したキーペアの作成」を参照してください。

キー名を eb migrate に指定すると、Elastic Beanstalk 環境をキーペアに関連付ける効果があります。セキュリティ上の理由により、EC2 インスタンスのセキュリティグループでポート 3389 は開かれません。最初の移行後に、eb config を介してポート 3389 のトラフィックを許可する追加の EC2 セキュリティグループを関連付けることができます。

PS C:\migrations_workspace> eb migrate  `
    --keyname "my-keypair"  `
    --verbose

キーペアを作成すると、Amazon EC2 はパブリックキーのコピーを保存します。環境インスタンスに接続するためにこれを使用する必要がなくなった場合は、Amazon EC2 から削除できます。詳細については、「Amazon EC2 ユーザーガイド」の「キーペアの削除」を参照してください。

Windows Amazon EC2 インスタンスに接続する方法については、「Windows インスタンスに接続する」を参照してください。

ログへのアクセス

EB CLI には、EC2 インスタンスにログインせずに Elastic Beanstalk 環境からログを取得するために使用できる eb logs 機能が用意されています。eb migrate の実行後、 eb logs --zip コマンドを発行して、ログをダウンロードして .elasticbeanstalk\logs ディレクトリに保存できます。

または、Elastic Beanstalk AWS コンソールからログを表示することもできます。詳細については、「Elastic Beanstalk 環境の Amazon EC2 インスタンスからのログの表示」を参照してください。

クライアント側のアーティファクトにアクセスする

eb migrate コマンドは、msdeploy によって生成されたアプリケーションログとエラーログを移行アーティファクトディレクトリ内に保存します。

./migrations/
├── latest -> migration_20240308_123456/
└── migration_20240308_123456/
    ├── application.log
    ├── error.log
    └── upload_target\

環境の正常性をモニタリングする

Elastic Beanstalk は、拡張正常性モニタリング機能を使用して正常性をモニタリングするのに役立ちます。これは、CPU 使用率、レイテンシー、リクエスト数、レスポンスコードなどの組み込みメトリクスを活用して、アプリケーションインスタンスの運用ステータスを継続的に追跡する自動正常性モニタリングシステムです。

正常性モニタリングシステムは、エージェントベースのアプローチを利用してインスタンスレベルのデータを収集し、リアルタイムのログ記録とアラートと統合します。ELB (ELB) と Auto Scaling はヘルスステータスの変化に動的に対応し、高可用性と耐障害性を確保します。強化されたヘルスレポートなどの高度なモニタリングモードは、アプリケーションの動作をきめ細かく可視化し、プロアクティブなトラブルシューティングと自動復旧メカニズムを可能にします。

EB CLI eb health コマンドを実行して、環境の正常性を表示します。以下の情報が表示されます。

EC2 パフォーマンスの最適化

デフォルトでは、eb migrate は c5.2xlarge インスタンスタイプを選択して、Elastic Beanstalk を初めて使用するときに最適なエクスペリエンスを提供します。この動作は --instance-type 引数で上書きできます。

PS C:\migrations_workspace> eb migrate `
    --instance-type "t3.large"

本番環境では、インスタンスタイプを選択するときに次の要素を考慮してください。

EBS ボリュームの設定

デフォルトでは、Elastic Beanstalk は環境のルートブロックデバイスボリューム (C:\) のみを作成します。--ebs-snapshots オプションを使用して、追加の Amazon Elastic Block Store スナップショットボリュームを渡すことができます。

PS C:\migrations_workspace> eb migrate `
    --ebs-snapshots "snap-123456789abc"

Elastic Beanstalk でブロックデバイスマッピングを設定する方法の例については、ブログ記事「Elastic Beanstalk 環境で Ephemeral および EBS ボリュームをカスタマイズする」を参照してください。

高いストレージ要件のアプリケーションの場合は、次のオプションを検討してください。

一般的な の問題と解決策

イベント: Web Deploy のインストールがない

Web Deploy が見つからないことに関連するエラーが発生した場合は、Microsoft Web Platform Installer から Web Deploy 3.6 以降をインストールします。次の例では、考えられるエラーメッセージを表示します。

Couldn't find msdeploy.exe. Follow instructions here: https://learn.microsoft.com/en-us/iis/install/installing-publishing-technologies/installing-and-configuring-web-deploy

イベント: 移行中のアクセス許可の問題

アクセス許可関連のエラーが発生した場合は、EB CLI を管理権限で実行していることを確認してください。次の例では、考えられるエラーメッセージを表示します。

[ERROR] Access to the path 'C:\inetpub\wwwroot\web.config' is denied.

イベント: アプリケーションプール ID の問題

アプリケーションプール ID の問題が原因でアプリケーションが起動しない場合は、「カスタムアプリケーションプール設定」に示すように、アプリケーションプール ID を設定するカスタムスクリプトを作成します。

イベント: SSL 証明書設定エラー

HTTPS バインディングが機能しない場合は、eb mibrate オプション --ssl-certificates パラメータを使用して有効な ACM 証明書 ARN を指定していることを確認してください。

イベント: 環境作成タイムアウト

環境の作成がタイムアウトした場合は、 AWS マネジメントコンソールの CloudFormation イベントで特定のリソース作成の失敗を確認します。一般的な原因には、VPC 設定の問題やサービスの制限などがあります。

サポート情報

解決できない問題が発生した場合は、 に連絡する前に以下の情報を収集 AWS サポート してください。

Elastic Beanstalk のトラブルシューティングの詳細については、「Elastic Beanstalk 環境のトラブルシューティング」を参照してください。