このページでは、App Engine の使用中に発生する可能性のあるエラーのトラブルシューティング プロセスについて説明します。 Google Cloudサービスに影響するインシデントについては、Google Cloud Service Health ダッシュボードと App Engine に関して報告されているすべてのインシデントをご覧ください。
アプリに関連する問題を解決する方法については、次のページをご覧ください。
App Engine のトラブルシューティング戦略
以降のセクションでは、一般的なトラブルシューティング戦略を適用してエラーを解決する方法を説明します。トラブルシューティング ガイドの手順で操作してもエラーが解決しない場合は、次のステップをご覧ください。
Cloud Logging を使用して適切なログを出力する
デバッグ用の適切なアプリケーション ログがあると、App Engine で実行されているアプリのトラブルシューティングが容易になります。アプリケーションでリクエストログとアプリケーション ログを関連付ける形でログを書き込むようにしてください。
関連付けられたログを使用すると、詳細な分析が必要なリクエストを特定し、リクエストのトレースを見つけて、問題の根本原因を分析できます。ログの書き込みの詳細については、アプリケーション ログを書き込むをご覧ください。
予期しないレイテンシを解決する
レイテンシに関する問題が発生した場合は、次の操作を行います。
レイテンシがサービスに対するすべてのリクエストに影響しているのか、ごく一部のリクエストにのみ影響しているのかを確認します。App Engine レイテンシ ダッシュボードには、50 パーセンタイル、95 パーセンタイル、99 パーセンタイルのレイテンシが表示されます。
これらの 3 つの指標のすべてでレイテンシが高い場合、リクエストの 50% 以上でレイテンシが高いことになります。99 パーセンタイルのグラフにのみ高いレイテンシが表示される場合は、リクエストの 1% で高いレイテンシが発生しています。
レイテンシが高いリクエストを特定して、レイテンシの原因を把握します。Cloud Trace または Cloud Logging を使用して、特定のリクエストに要した時間を把握できます。詳細については、アプリのレイテンシについてをご覧ください。
Cloud Logging を使用してレイテンシの高いリクエストを特定するには、
traceSampled=trueフィルタを適用して、Cloud Logging のログを Cloud Trace のトレースと関連付けます。詳細については、Cloud Logging との統合をご覧ください。レイテンシの問題を解決し、サービスのパフォーマンスを改善するには、次の手順を試してください。
インスタンス クラスの設定を増やします。
ウォームアップ リクエストを構成してコールド スタートのレイテンシを減らします。
スケーリング設定を調整します。
プロファイラの使用を検討します。
ソースコードを変更します。
レイテンシの増加に関する問題のトラブルシューティング方法については、アプリにおけるレイテンシの増加をトラブルシューティングするをご覧ください。
接続に関する問題を解決する
App Engine サービスは、デフォルトでは公共のインターネットからアクセスできますが、上り（内向き）と下り（外向き）のネットワーク接続に対する制限を追加するように変更できます。
上り（内向き）接続は、上り（内向き）設定または App Engine ファイアウォール ルールで制限できます。VPC ネットワークまたはインターネット リソースから App Engine サービスに接続できない場合は、以下を確認してください。
その他の接続の問題を解決するには、次の操作を行います。
ネットワーク接続テストを実行します。
VPC ネットワークへの下り（外向き）トラフィックの問題を解決するには、VPC ネットワークのファイアウォール ルールを確認するか、クライアントで接続プーリングを使用します。詳細については、ファイアウォール ルールをご覧ください。
しきい値を超える数のサービスと接続で VPC コネクタが過負荷状態にならないようにしてください。スループットを改善するには、VPC コネクタのサイズとコネクタのインスタンス数を検討してください。詳細については、サーバーレス VPC アクセスをご覧ください。
VPC リソースへのアクセスに問題がある場合は、VPC コネクタのスループットのグラフを確認してください。
接続に関する問題のトラブルシューティング方法については、App Engine の接続戦略をご覧ください。
次のステップ
App Engine のドキュメントで問題の解決策が見つからない場合は、次をご検討ください。
- Cloud カスタマーケアに問い合わせて、サポートケースを登録する。
- StackOverflow で質問して、コミュニティによるサポートを受ける。または、
google-app-engineタグを使用して類似の問題を検索する。 - 公開バグトラッカーを使用して、バグの報告や機能リクエストの登録を行う。
詳細については、App Engine コミュニティをご覧ください。