Ruby on Rails のログの読み方【これができれば脱初心者】

rails s で表示されるあの英語はなんですか？

分かるようになったほうがいいでしょうか

動作を理解するにはログを読めと言われたんですが何をどのように読めばいいんでしょか・・・

そういった疑問にお答えします。

ログ情報はアプリケーションの動作を把握するための基本情報です。
実装時もエラーが出たときもいつもログが活躍します。
ログが読めるようになれば Ruby on Rails の中級者といってもいいでしょう。

本記事では Ruby on Rails のログにどのような情報が書いてあるかを解説します。

rails s のログ
ログの保存場所
1リクエスト=1ブロック
ブロック内(1リクエスト分)に書いてある情報
まとめ

rails s のログ

このように rails s を実行したターミナルにずらずらと表示される英語の文章はアプリケーションのログです。

ログの保存場所

rails s を実行したターミナルに流れる情報は消えてしまいますが、ログはログファイルに保存されています。
開発時のログはデフォルト設定では log/development.log に保存されます。

開発時は development 環境であるため log/development.log に保存されます。
本番環境（production 環境）の場合はデフォルト設定では log/production.log に保存されます。

1リクエスト=1ブロック

ログは HTTP リクエスト一つに1ブロックで表示されます。
例えば以下のようなログが表示されている場合は

以下のようにリクエスト毎にブロック分けされています。

ブロック間は2行の空行がはさまり、見やすくなるように配慮されています。

あるリクエストに対するログを探したいときは、このブロック単位で探すと効率がよいでしょう。

ブロック内(1リクエスト分)に書いてある情報

それでは内容を個別に見ていきましょう。

HTTPメソッド＋パス

一行目に HTTP メソッドとパスが出力されます。

リクエストはHTTPメソッドとパスのペアで決まりますので、ここを目印にブロックを探すとよいでしょう。

コントローラ#アクション

実行されたコントローラ#アクションが出力されます。

コントローラとアクションは「HTTP メソッド＋パス」と「ルーティング」の二点から導き出せるので場合によっては見る必要はありません。
しかし、ルーティングを確認せずともどのクラスのどのメソッドが呼ばれているのかがわかるので便利です。

パラメータ

HTTPリクエストで送信されたHTTPパラメータが Ruby のハッシュ形式で表示されます。

HTTP パラメータには以下の2つの情報が表示されます。

URL のクエリパラメータ(URLの ? 以降)
POSTなどで送られるフォームパラメータ

HTTPパラメータを確認すれば「想定したパラメータが送信されているか」を確認することができます。

FILTERED

値が [FILTERED] となっているところがありますが、これはセキュリティに配慮されたものとなります。
トークンやパスワードなど、例え運営者であっても見せるべきではないパラメータがこのようにマスクされます。
どのパラメータがマスクされるかは Rails 6.1 の場合、config/initializers/filter_parameter_logging.rb に記載されており、追加することもできます。