Heroku AppLink のログ記録と一般的なエラー

最終更新日 2025年07月14日(月)

Heroku AppLink​ は、アクティビティのログを生成します。このログにはログドレイン​からアクセスできます。この記事では、ログに表示される内容と、ログに記録されている一般的なエラーやメッセージについて説明します。

アプリケーションのログ記録

heroku logs​ コマンドを使用して Heroku 標準の tail ログ​ を出力するか、またはログアドオン​を使用して、ログやメトリクスを確認できます。ログエントリは、標準のログ形式​に従います。

以下はログエントリの例です。

$ heroku logs --tail
---
2024-10-28T16:02:15.215250+00:00 app[web.1]: time=2024-10-28T16:02:15.215Z level=INFO msg="Processing request to /accounts..." app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.215254+00:00 app[web.1]: time=2024-10-28T16:02:15.215Z level=INFO msg="Validating request..." app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.215330+00:00 app[web.1]: time=2024-10-28T16:02:15.215Z level=INFO msg="Valid request!" app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.215331+00:00 app[web.1]: time=2024-10-28T16:02:15.215Z level=INFO msg="Found Salesforce request" app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.215332+00:00 app[web.1]: time=2024-10-28T16:02:15.215Z level=INFO msg="Authenticating Salesforce request for org 00Dbc0000000000000, domain https://mydomain.demo.my.salesforce.com..." app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.394673+00:00 app[web.1]: time=2024-10-28T16:02:15.394Z level=INFO msg="Authenticated request!" app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.394674+00:00 app[web.1]: time=2024-10-28T16:02:15.394Z level=INFO msg="Forwarding request..." app=local source=heroku-applink-service-mesh request-id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c
2024-10-28T16:02:15.395727+00:00 app[web.1]: {"level":30,"time":1730131335395,"pid":37,"hostname":"dyno-f34267e3-3d00-453d-a3b4-a16ab26a773b","reqId":"00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c","req":{"method":"GET","url":"/accounts","hostname":"127.0.0.1:3000","remoteAddress":"127.0.0.1","remotePort":35162},"msg":"incoming request"}
2024-10-28T16:02:15.398888+00:00 app[web.1]: {"level":30,"time":1730131335396,"pid":37,"hostname":"dyno-f34267e3-3d00-453d-a3b4-a16ab26a773b","reqId":"00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c","msg":"GET /accounts: {}"}
2024-10-28T16:02:15.398893+00:00 app[web.1]: {"level":30,"time":1730131335396,"pid":37,"hostname":"dyno-f34267e3-3d00-453d-a3b4-a16ab26a773b","reqId":"00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c","msg":"Querying invoking org (00Dbc0000000000000) Accounts..."}
2024-10-28T16:02:15.481929+00:00 app[web.1]: {"level":30,"time":1730131335481,"pid":37,"hostname":"dyno-f34267e3-3d00-453d-a3b4-a16ab26a773b","reqId":"00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c","msg":"For invoking org (00Dbc0000000000000), found the following Accounts: [{\"id\":\"001Ws00003GGHVCIA5\",\"name\":\"Global Media\"},{\"id\":\"001Ws00003GGHVDIA5\",\"name\":\"Acme\"},{\"id\":\"001Ws00003GGHVEIA5\",\"name\":\"salesforce.com\"}]"}
2024-10-28T16:02:15.482306+00:00 app[web.1]: 2024/10/28 16:02:15 [00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c] "GET http://integration-app-c4effe617e07.herokuapp.com/accounts HTTP/1.1" from 18.214.12.209 - 200 267B in 267.062237ms
2024-10-28T16:02:15.482442+00:00 app[web.1]: {"level":30,"time":1730131335482,"pid":37,"hostname":"dyno-f34267e3-3d00-453d-a3b4-a16ab26a773b","reqId":"00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c","res":{"statusCode":200},"responseTime":86.56547299958766,"msg":"request completed"}
2024-10-28T16:02:15.482623+00:00 heroku[router]: at=info method=GET path="/accounts" host=integration-app-c4effe617e07.herokuapp.com request_id=00Dbc0000000000000-f2f3ed60-2dbd-4edd-b707-9dee97d89c7c fwd="18.214.12.209" dyno=web.1 connect=0ms service=267ms status=200 bytes=267 protocol=http tls_version=tls1.3

ログエラー

以下は、AppLink ログでよく見られる一般的なエラーです。

Confirmation doesn’t match the expected value (確認用の値が期待される値と一致しません)

このエラーは、--confirm​ フラグに入力した値が正しくない場合に発生します。正しい値を入力してコマンドを再実行してください。

AppLink アドオン構成エラーは、要求された AppLink アドオンがアプリに存在しない場合や、アプリに AppLink がプロビジョニングされていない場合に発生します。heroku addons --app [app]​ を使用してアプリのアドオンのリストを確認するか、アドオンをインストール​してください。

このエラーは、アプリに複数の AppLink アドオンがプロビジョニングまたはアタッチされており、どのアドオンを使用するかアプリが判断できない場合に発生します。--addon​ フラグで使用する AppLink アドオンを指定してから、再実行してください。

API spec file path [path] doesn’t exist or API spec file format errors (API 仕様ファイルのパス [path] が存在しないか、API 仕様ファイルの形式に誤りがあります)

このエラーは、アプリの公開​時の API 仕様ファイルのパスが正しくない場合、または API 仕様ファイルのパスが YAML​ (.yaml/.yml) または JSON​ (.json) 形式でない場合に発生します。API 仕様ファイルのパスが正しく、サポートされている形式であることを確認してから、再実行してください。

このエラーは、入力した接続名が間違っている場合、接続がアプリに存在しない場合、またはアプリにまだ接続がない場合に発生します。heroku applink:connections --app [app]​ を使用してアプリの接続のリストを確認するか、接続を作成してください​。

Developer Name [developer_name] doesn’t exist on app app

このエラーは、入力した承認の名前が間違っている場合や、承認がアプリに存在しない場合に発生します。heroku applink:authorizations​ を使用してアプリの承認済みユーザーのリストを確認してください。

その他の資料