このページでは、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 の接続戦略をご覧ください。