ログデータがすでにHerokuのビルトイン Logplex ルーターによって監視されている場合は、私たちの統合を利用して、New Relicでログデータを転送し、エンリッチすることができます。この統合は、 Heroku Syslog drains を使用しています。
HerokuのログをNew Relicに転送することで、ログ管理機能が強化され、ログデータの収集、処理、探索、クエリ、アラートなどが可能になります。
Heroku Syslog drainの作成
ログ管理機能を有効にするには、まずHeroku Syslog drainを作成します。
New Relic のユーザーアカウントに、 Admin ロール が割り当てられていることを確認してください。
Heroku CLI をダウンロードしてインストールします。
Heroku CLIを使用してSyslogドレインを作成し、ログをストリーミングするアプリケーションにアタッチして、
YOUR_APP_NAME
をHerokuアプリケーションの名前に置き換えます。bash$$ heroku drains:add syslog+tls://newrelic.syslog.nr-data.net:6515 -a YOUR_APP_NAMEヨーロッパにお住まいの場合は、代わりに次のコマンドを実行してください。
bash$$ heroku drains:add syslog+tls://newrelic.syslog.eu.nr-data.net:6515 -a YOUR_APP_NAME次のコマンドを実行し、HerokuSyslogドレイントークンを
token
属性からコピーします。bash$$ heroku drains -a YOUR_APP_NAME --json{"addon": null,"created_at": "2018-12-04T00:59:46Z","id": "906262a4-e151-45d2-b35a-a2dc0ea9e688","token": "d.f14da5dc-106b-468d-b1bd-bed0ed9fa1e7","updated_at": "2018-12-04T00:59:47Z","url": "syslog+tls://newrelic.syslog.nr-data.net:6515}
Heroku Syslog drainの登録
次に、新しく作成したHeroku Syslog drainをNew Relicに登録する必要があります。
New RelicのログUIにログインし、[データソースを追加]をクリックします。
Heroku Log ingestion の下のタイルをクリックします。
HerokuアプリケーションのログをストリーミングするNew Relicアカウントを選択し、 Continue をクリックします。
Heroku drain token の欄に、新しく作成したHeroku drain tokenを貼り付けます。
Add Heroku drain log をクリックして登録を完了します。
重要
Herokuは現在、Logplexから送信されるログのフォーマットのカスタマイズをサポートしていません。詳しくは、 Heroku's log format documentation をご覧ください。
ログデータの閲覧
すべての設定が正しく行われ、データが収集されていれば、この2つの場所にデータログが表示されるはずです。
- NewRelicのログUI
- NRQL クエリを実行するための New Relic ツール NRQL クエリを実行するための New Relic ツール 。例えば、以下のようなクエリを実行することができます。
SELECT * FROM Log
当社のログ管理機能を有効にしてもデータが表示されない場合は、当社の 標準的なログのトラブルシューティング手順 に従ってください。
次のステップ
Logs UIを使用して、プラットフォーム全体のログデータを調べます。
- logs in context の機能を使ってログを転送することで、アプリケーションとプラットフォームの両方のパフォーマンスデータをより深く把握することができます。
- アラートの設定.
- データのクエリ と ダッシュボードの作成.
ログ転送を無効にする
ログ転送機能を無効にするには、 Heroku Syslog documentation に記載されている標準的な手順に従ってください。New Relicでは他に何もする必要はありません。