編集者の注意：php-fpmは、その主なプロセスを記述するために”マスター”という用語を使用します。 Datadogはこの用語を使用しません。 このブログ記事では、特定のプロセス名を参照する必要がある場合を明確にするために、これを”プライマリ”と呼びます。この投稿は、NGINX502Bad Gatewayエラーのトラブルシューティングに関するシリーズの一部です。 PHP-FPMを使用していない場合は、gunicornをバックエンドとして使用したNGINX502sのトラブルシューティングに関する他の記事をチェックしてください。PHP-FastCGI Process Manager(PHP-FPM)は、PHPアプリケーションのwebサーバー要求を処理するためのデーモンです。 本番環境では、PHP-FPMは多くの場合、NGINX webサーバーの背後にデプロイされます。 NGINXはwebリクエストをプロキシし、PHPアプリケーションを実行するPHP-FPMワーカープロセスに渡します。

NGINXは、PHP-FPMへのリクエストを正常にプロキシできない場合、またはPHP-FPMが応答に失敗した場合、502Bad Gatewayエラーを返します。 この記事では、NGINX/PHP-FPMスタックの502エラーの一般的な原因をいくつか調べ、これらのエラーの解決に役立つ情報をどこで見つけることができるかについDatadogを使用して、nginx502Bad Gatewayエラーの背後にあるメトリック、ログ、およびトレースを調べます。

502sのいくつかの考えられる原因

このセクションでは、次の条件によりNGINXが502エラーを返す可能性がある方法について説明します。

• PHP-FPMが実行されていません
• NGINXはPHP-FPMと通信できません
• PHP-FPMがタイムアウトしています

NGINXがPHP-fpmと通信できない場合

NGINXがPHP-fpmと通信できない場合

FPMこれらの理由のいずれかのために、アクセスログ（/var/log/nginx/access）にこれを記録して、502エラーで応答します。ログ)この例に示すように:

sudo ps aux | grep 'php'

root 29852 0.0 2.2 435484 22396 ? Ssl 16:27 0:00 php-fpm: master process (/etc/php/7.2/fpm/php-fpm.conf)www-data 29873 0.0 1.5 438112 15220 ? Sl 16:27 0:00 php-fpm: pool wwwwww-data 29874 0.0 1.6 438112 16976 ? Sl 16:27 0:00 php-fpm: pool www

sudo systemctl enable php7.2-fpm.service

次に、list-unit-filesコマンドを使用して、PHP-FPMプロジェクトに関する情報を表示できます。あなたのサービス：php7で

sudo systemctl list-unit-files | grep -E 'php*fpm'

2PHP-FPMがインストールされているサーバー（実行されていない場合でも）、このコマンドの出力は次のようになります。

php7.2-fpm.service enabled

PHP-FPMサービスに関する情報を表示するには、次のコマンドを使用します。

php7.2-fpm.service enabled

Php-FPMサービスに関する情報を表示するには、次のコマンドを使用します。

php7.2-fpm.service enabled

sudo systemctl is-active php7.2-fpm.service

このコマンドは、activeの出力を返す必要があります。 そうでない場合は、次のようにしてサービスを開始できます:Nginxはソケットにアクセスできません

PHP-FPMが起動すると、NGINX webサーバーと通信するために1つ以上のTCPまたはUnixソケットが作成されます。 PHP-FPMのワーカープロセスは、これらのソケットを使用してNGINXからの要求をリッスンします。

ソケットの設定ミスによって502エラーが発生したかどうかを判断するには、PHP-FPMとNGINXが同じソケットを使用するように構成されていることを確認 これらのファイルは/etc/php/7.2/fpm/poolにあります。d/. 各プールのソケットは、プールの設定ファイル内のlistenlistenディレクティブは、/run/php/mypoolにあるUnixソケットを使用するようにmypoolという名前のプールを設定します。

divconf

listen = /run/php/mypool.sock

NGINXが特定のプールのソケットにアクセスできない場合は、NGINXエラーログエントリでどのソケットに名前が付けられているかを確認することで、どのワーカープールが問題に関与しているかを判断することができます。 たとえば、PHP-FPMがmypoolワーカープールの開始に失敗した場合、NGINXは502を返し、そのエラーログエントリには次のようになります。

connect() to unix:/run/php/mypool.sock failed (2: No such file or directory)

あなたのnginxをチェックしてください。関連するlocationブロックが同じソケットを指定することを確認するためのconfファイル。 以下の例には、PHP-FPMの一般的な設定情報をロードするincludeディレクティブと、mypoolで指定された同じUnixソケットを指定するfastcgi_passディレクティブが含まれています。上記のconfファイル。

listen.owner = www-datalisten.group = www-datalisten.mode = 0660

2020/02/20 17:12:03 3059#3059: *4 connect() to unix:/run/php/mypool.sock failed (13: Permission denied) while connecting to upstream, client: 127.0.0.1, server: localhost, request: "GET / HTTP/1.1", upstream: "fastcgi://unix:/run/php/mypool.sock:", host: "localhost"

listen.ownerlisten.groupのデフォルト値は、NGINXを実行しているデフォルトの所有者とグループと一致し、listen.groupのデフォルト値は、NGINXを実行しているデフォルトの所有者とグループと一致していることに注意してください。

2020/02/20 17:12:03 3059#3059: *4 connect() to unix:/run/php/mypool.sock failed (13: Permission denied) while connecting to upstream, client: 127.0.0.1, server: localhost, request: "GET / HTTP/1.1", upstream: "fastcgi://unix:/run/php/mypool.sock:", host: "localhost"

listen.grouplisten.grouplisten.modeのデフォルトは0660です。 これらのデフォルトを使用すると、NGINXはソケットにアクセスできるはずです。PHP-FPMがTCPソケットでリッスンしている場合、プールconifgurationのlistenaddress:portの形式の値を持ちます。

 WARNING: child 2120, script '/var/www/html/index.php' (request: "GET /index.php") execution timed out (25.755070 sec), terminating

この変更を適用するには、NGINX設定をリロードします:

nginx -s reload

次に、PHP-FPMがタイムアウトした理由を判断するために、ログとアプリケーションパフォーマンス監視(APM)データを収集

ログの収集と分析

アプリケーションエラーのトラブルシューティングを行うには、ログを収集してログ管理サービスに送信します。 上記で調べたNGINXログに加えて、PHPはエラーやその他のイベントをログに記録することができます。 詳細については、PHPロギングガイドを参照してください。

PHPとNGINXのログをログ管理サービスに入れ、キャッシュサーバーやデータベースなどの関連技術のログと組み合わせると、webスタック全体のログを単一のプラDatadog Log Analyticsの棒グラフは、エラー、警告、情報などのさまざまなステータスのPHPとNGINXのログを視覚化します。

WEBスタックからAPMデータを収集

APMは、ボトルネックを特定し、アプリのパフォーマンスに影響する502エラーなどの問題を解決するのに役立 以下のスクリーンショットは、Datadogで視覚化されたNGINXのAPMデータを示しています。 このビューは、NGINXベースのサービスの要求量、エラー率、および遅延をまとめたもので、502エラーなどのパフォーマンスの問題を調査するのに役立ちます。

200OK

アプリケーションの502エラーの診断と解決が速くなればなるほど、より良い結果が得られます。 Datadogを使用すると、インフラストラクチャ全体からメトリック、トレース、ログ、およびネットワークパフォーマンスデータを分析できます。 すでにDatadogのお客様であれば、NGINX、PHP-FPM、および400以上のその他のテクノロジの監視を開始できます。 まだDatadogアカウントをお持ちでない場合は、14日間の無料トライアルにサインアップして、数分で開始してください。