最終更新日 2025年01月28日(火)

Heroku アプリのログは、実行中プロセス、システムコンポーネント、およびバッキングサービスすべての出力ストリームから受け取ります。Heroku のログ記録インフラストラクチャは、すべてのソースからのログストリームを単一のチャネルにルーティングし、包括的なログ記録の基盤を提供します。

ランタイムログ

Heroku は、デプロイされたアプリの次のカテゴリのログを集約します。

• アプリログ​ - アプリのコードおよび依存関係によって生成されるログを含む、アプリケーション自体からのログ出力(フィルター: ​--source app​)。
• システムログ​ - クラッシュしたプロセスの再起動、Web dyno のスリープまたはスリープ解除、アプリでの問題によるエラーページの表示など、アプリの代わりに Heroku プラットフォームインフラストラクチャが行った操作に関するメッセージ(フィルター: ​--source heroku​)。Fir​ 世代のプラットフォームでは、すべての内部 Heroku のテレメトリーに heroku-​ というプレフィックスが付きます。たとえば、heroku-router​、heroku-runtime​、heroku-api​ などがあります。
• API ログ​ - 新しいコードのデプロイ、プロセス構成のスケーリング、メンテナンスモードの切り替えなど、ユーザーまたはアプリを操作している他の開発者が行った管理操作に関するメッセージ。(フィルター: ​--source app --dyno api​)。
• アドオンログ​ - アドオンサービスからのメッセージ。詳細については、アドオンの Dev Center 記事を参照してください(フィルターはアドオンによって異なります)。

ビルドログ

アプリのビルドおよびデプロイ中に生成されたログは、アプリのランタイムログから切り離されます。成功および失敗した両方のビルドのログは、Heroku Dashboard​ のアプリの Activity (アクティビティ) タブから使用できます。

アクティビティフィードでいずれのビルドイベントに対して View build log (ビルドログの表示) をクリックします。

ログ履歴の制限

Cedar のログ履歴の制限

Cedar​ 世代のアプリでは、Shield Spaces 内で Private Space Logging​ を有効にしていない限り、Logplex​ が使用されます。Logplex はログメッセージの保存ではなく、照合とルーティングを目的としています。そのため、統合されたログの最新の 1,500 行のみが保持され、1 週間後には削除されます。

ログの本番準備完了の持続性を高めるために、Heroku プラットフォームの使用可能なログ記録アドオン​のいずれかをアプリに追加します。これらのアドオンのほとんどには、開始するための無料プランが用意されています。

または、ログに行われる操作を完全に制御するために、独自のログドレイン​を実装します。

Private Space Logging が有効になっている Shield Space では、heroku logs​ コマンドを使用できず、ログ履歴もありません。詳細は、「Private Space Logging​」を参照してください。

Fir のログ履歴の制限

Heroku プラットフォームの Fir​ は Logplex を使用せず、代わりに OpenTelemetry シグナルを使用して OTLP ログをエクスポートします。詳細は、「Heroku テレメトリー​」を参照してください。Logplex と同様に、これはログメッセージの保管ではなく、照合とルーティングを目的としています。また、ログ履歴もありません。

本番環境向けにログを確実に保存したい場合は、OpenTelemetry OTLP ログ記録バックエンドをサポートするプロバイダーに対して、アプリにテレメトリードレイン​を追加します。

ログへの書き込み

アプリが標準出力 (stdout​) または標準エラー (stderr​) に書き込むものすべてがログに取得されます。単純な出力文で、アプリケーションコードのどこからでもログ記録できます。

Ruby では、次のように使用できます。

puts "Hello, logs!"

Java の場合は次のようになります。

System.err.println("Hello, logs!");
System.out.println("Hello, logs!");

Heroku がサポートする他のすべての言語に同じことが当てはまります。

リアルタイムのログ記録を利用するには、アプリケーションが実行しているすべてのログバッファリングを無効にします。たとえば、Ruby では、config.ru​ ファイルに次のコードを追加します。

$stdout.sync = true

フレームワークによっては、デフォルトで、stdout​ 以外の場所にログ出力を送信するため、追加の設定が必要になります。たとえば、ActiveSupport により Rails TaggedLogger で Ruby を使用する場合、アプリの設定に次のように追加して、stdout​ ログ記録を取得します。

config.logger = Logger.new(STDOUT)

詳細は、「アプリケーションのログ記録のためのベストプラクティスを記述する​」を参照してください。

ログの表示

ログの表示は、Heroku CLI​、ダッシュボード​、ログ記録アドオン​、またはログドレイン​で行うことができます。

Heroku CLI を使用したログの表示

アプリの最新のログを取得するには、heroku logs​ コマンドを使用します。

$ heroku logs --app --example-app
2010-09-16T15:13:46.677020+00:00 app[web.1]: Processing PostController#list (for 208.39.138.12 at 2010-09-16 15:13:46) [GET]
2010-09-16T15:13:46.677023+00:00 app[web.1]: Rendering template within layouts/application
2010-09-16T15:13:46.677902+00:00 app[web.1]: Rendering post/list
2010-09-16T15:13:46.678990+00:00 app[web.1]: Rendered includes/_header (0.1ms)
2010-09-16T15:13:46.698234+00:00 app[web.1]: Completed in 74ms (View: 31, DB: 40) | 200 OK [http://example-app-1234567890ab.heroku.com/]
2010-09-16T15:13:46.723498+00:00 heroku[router]: at=info method=GET path="/posts" host=example-app-1234567890ab.herokuapp.com" fwd="204.204.204.204" dyno=web.1 connect=1ms service=18ms status=200 bytes=975
2010-09-16T15:13:47.893472+00:00 app[worker.1]: 2 jobs processed at 16.6761 j/s, 0 failed ...

この例では、出力には、アプリの Web dyno のいずれか、Heroku HTTP ルーター、アプリの Worker のいずれかからのログ行が含まれます。詳細は、「Heroku のログ形式とメッセージの順序付け​」を参照してください。

Cedar​ アプリの場合、logs​ コマンドはデフォルトで 100 行のログを取得します。--num​(または -n​) オプションを使用して、取得するログ行数を指定できます (最大 1,500 行)。

$ heroku logs -n 200

リアルタイム tail

tail -f​ と同様に、リアルタイム tail は、最新のログを表示し、リアルタイムログが流入できるようにセッションを開いたままにします。アプリからログのライブストリームを表示することにより、ライブアプリケーションの動作に対する洞察が得られ、現在の問題をデバッグできます。Heroku の Fir​ 世代にはログ履歴がありません。Fir アプリの heroku logs​ はデフォルトでリアルタイム tail になります。

--tail​ (または -t​) を使用してログを末尾監視できます。

$ heroku logs --tail

終了したら、Ctrl+C を押してプロンプトに戻ります。

アイドル状態が 1 時間続いた後、リアルタイム tail セッションは自動的に終了します。

フィルタリング

特定のソースまたは特定の dyno、あるいはその両方のログだけを取得する場合は、--source​ (または -s​) と --dyno​ (または -d​) フィルタリング引数を使用できます。

$ heroku logs --dyno router
2012-02-07T09:43:06.123456+00:00 heroku[router]: at=info method=GET path="/stylesheets/dev-center/library.css" host=devcenter.heroku.com fwd="204.204.204.204" dyno=web.5 connect=1ms service=18ms status=200 bytes=13
2012-02-07T09:43:06.123456+00:00 heroku[router]: at=info method=GET path="/articles/bundler" host=devcenter.heroku.com fwd="204.204.204.204" dyno=web.6 connect=1ms service=18ms status=200 bytes=20375

$ heroku logs --source app
2012-02-07T09:45:47.123456+00:00 app[web.1]: Rendered shared/_search.html.erb (1.0ms)
2012-02-07T09:45:47.123456+00:00 app[web.1]: Completed 200 OK in 83ms (Views: 48.7ms | ActiveRecord: 32.2ms)
2012-02-07T09:45:47.123456+00:00 app[worker.1]: [Worker(host:465cf64e-61c8-46d3-b480-362bfd4ecff9 pid:1)] 1 jobs processed at 23.0330 j/s, 0 failed ...
2012-02-07T09:46:01.123456+00:00 app[web.6]: Started GET "/articles/buildpacks" for 4.1.81.209 at 2012-02-07 09:46:01 +0000

$ heroku logs --source app --dyno worker
2012-02-07T09:47:59.123456+00:00 app[worker.1]: [Worker(host:260cf64e-61c8-46d3-b480-362bfd4ecff9 pid:1)] Article#record_view_without_delay completed after 0.0221
2012-02-07T09:47:59.123456+00:00 app[worker.1]: [Worker(host:260cf64e-61c8-46d3-b480-362bfd4ecff9 pid:1)] 5 jobs processed at 31.6842 j/s, 0 failed ...

dyno でフィルタリングするときには、ベース名 (--dyno web​ など) とフルネーム (--dyno web.1​ など) のどちらでも使用できます。

フィルタリングスイッチを、--tail​ と組み合わせて、フィルタリング出力のリアルタイムストリームを取得することもできます。

$ heroku logs --source app --tail

Fir の追加フィルタリングオプション

Heroku の Fir 世代では、--process-type​ (または -p​) を使用してプロセスタイプ​で絞り込むことができます。この検索条件は、web​ や worker​ など、要求されたプロセスタイプからの出力のみを表示します。

$ heroku logs --process-type=web
Fetching logs...

2024-11-25T16:58:31.851567+00:00 heroku-router[web]: at=info method=GET path="/" host=guarded-ocean-15115-d8c9cc7de5a9.herokuapp.com request_id=5ff3cd7e-870b-d957-086d-5689c6774271 fwd="204.14.236.210" dyno=web-6f7df4f44d-nq5pr connect=1ms service=0ms status=200 bytes=21 protocol=http tls_version=tls1.3
2024-11-25T16:58:31.921301+00:00 heroku-router[web]: at=info method=GET path="/favicon.ico" host=guarded-ocean-15115-d8c9cc7de5a9.herokuapp.com request_id=6889fc6a-eb78-5366-ea9d-e0198958b15b fwd="204.14.236.210" dyno=web-6f7df4f44d-nq5pr connect=0ms service=1ms status=200 bytes=32 protocol=http tls_version=tls1.3
2024-11-25T16:58:31.851200+00:00 app[web]: 2024/11/25 16:58:31 http: superfluous response.WriteHeader call from github.com/riandyrn/otelchi.getRRW.func2.1 (middleware.go:96)

Heroku Dashboard を使用したログの表示

Heroku ダッシュボード​にログインして、Web 上でログを表示できます。表示するアプリに移動します (たとえば、https://dashboard.heroku.com/apps/<app-name>​)。このページで 「More」 (詳細) を選択すると、ドロップダウンメニューが表示されます。

このメニューで、View logs (ログの表示) を選択します。詳細は、「Heroku のログ形式とメッセージの順序付け​」を参照してください。

ログ記録アドオンを使用したログの表示

Heroku プラットフォームで利用可能ないずれかのログ記録アドオン​をアプリに追加することをお勧めします。これらのアドオンのほとんどには、開始するための無料プランが用意されています。ログの取得に関する手順については、アドオンのドキュメントを参照してください。

あるいは、カスタムのログドレイン​を実装することもできます。

Heroku のログ形式とメッセージの順序付け

Heroku は、プラットフォームのアプリおよびその他のコンポーネントによって生成されたログエントリの照合と配信を行います。

ログは発生順ではありません。ログは多くのソースから生成され、単一のログストリームにアセンブルされます。Logplex と OpenTelemetry コレクターはどちらも高可用性を実現するために分散アーキテクチャを使用しているため、ログメッセージが複数のアプリケーションノードから収集されるときに、順序が前後することがあります。

heroku logs​ コマンドの出力形式は次のようになります。

timestamp source[dyno]: message

• タイムスタンプ​ - dyno またはコンポーネントによってログ行が生成された時点で記録された日時。タイムスタンプは、RFC5424​ で指定された形式で、マイクロ秒精度を含みます。
• ソース​ - アプリの dyno (Web dyno、バックグラウンド Worker、cron) すべてには、ソース (app​) があります。Heroku のすべてのシステムコンポーネント (HTTP ルーター、dyno マネージャー) は、Cedar ではソースが heroku​ として表示され、次世代では heroku-​ というプレフィックスが付きます。
• dyno​ - ログ行を書き込む dyno またはコンポーネントの名前。たとえば、Worker #3 は worker.3​ と表示され、Heroku HTTP ルーターは Cedar と Fir ではそれぞれ router​ または heroku-router​ として表示されます。
• メッセージ​ - ログ行の内容。10,000 バイトを超える dyno によって生成される行は、末尾に余分な改行を追加せず、10,000 バイトのチャンクに分割されます。チャンクはそれぞれ、個別のログ行として提示されます。