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

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

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

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

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

キー名を に指定すると、Elastic Beanstalk 環境をキーペアに関連付ける効果eb migrateがあります。セキュリティ上の理由から、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 使用率、レイテンシー、リクエスト数、レスポンスコードなどの組み込みメトリクスを活用して、アプリケーションインスタンスの運用ステータスを継続的に追跡する自動ヘルスモニタリングシステムです。

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

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

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

デフォルトでは、 は c5.2xlarge インスタンスタイプeb migrateを選択して、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 環境でエフェメラルボリュームと 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 マネジメントコンソールの AWS CloudFormation イベントで特定のリソース作成の失敗を確認します。一般的な原因には、VPC 設定の問題やサービスの制限などがあります。

サポート情報

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

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