• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

Ruby:コンテキストでのログの設定

Ruby APM エージェントを使用すると、ログをコンテキストで取得できます。これにより、他の New Relic データのコンテキストでアプリのログを確認できます。この機能の一般的な情報については、コンテキスト内の APM ログ を参照してください。

コンテキストオプションの自動ログ

アプリのログを送信し、メタデータをNew Relicに自動的にリンクするように、コンテキストでAPMログを構成する3つのオプションがあります。

While you wait for your data to come in...

Did this doc help you install?

データを保護する

ログには、HIPAAまたはその他のコンプライアンスプロトコルによって保護されている機密情報が含まれている場合があります。デフォルトでは、クレジットカードや社会保障番号などのアイテムのように見える番号パターンを難読化しますが、追加情報をハッシュまたはマスクする必要がある場合があります。

詳細については、難読化の式とルールに関するドキュメントを参照してください。 New Relic UIを使用するか、GraphQL APIであるNerdGraphを使用して、ログデータをハッシュまたはマスクできます。

データを調べる

ログデータを最大限に活用するには:

  • [ APMの概要]ページで、 Webトランザクションのタイムチャートをクリックして、特定の時点に関連付けられたログを表示します。
  • エラーに関連するログを表示するには、アプリの[エラー]受信ボックスを確認してください。
  • 分散トレースを使用して、個々のトレースに関連付けられているログを確認します。
  • Logs UIを使用して、プラットフォーム全体でより多くのログデータを探索します。
  • ログ出力と重大度に基づいてアラートを設定します。
  • ログデータ専用のUIを使用してデータをクエリし、結果を含むダッシュボードを作成します。

トラブルシューティングのヒント

通常、コンテキストでAPMログを有効にした後、ログは1分以内に表示され始めます。アプリのトリアージ>ログセクションを確認します。また、そこでエラーに関連するログパターンが表示されるようになります。

エラーまたはトレースのログが表示されない場合は、アプリにログがない可能性があります。 UIページを更新するか、選択した期間を変更してみてください。

自動ロギングを無効にする

APMログインコンテキストは、APMエージェントログデータを自動的に転送し、デフォルトで有効になっています。これは、セキュリティ、コンプライアンス、請求、またはシステムパフォーマンスに悪影響を与える可能性があります。詳細について、またはデフォルト設定を調整する必要がある場合は、手順に従って自動ロギングを無効にしてください。

コンテキストオプションの手動ログ

手動プロセスを使用してRubyのコンテキストでログを設定する必要がある場合は、次の手順に従います。

  1. NewRelicでのロギングをすでに設定していることを確認してください。これには、アプリケーションログを収集し、NewRelicに転送されるメタデータを拡張するサポートされているログフォワーダーの構成が含まれます。
  2. をインストールするか、 を最新の Ruby エージェントバージョンに更新し、 分散型トレーシングを有効にするRubyエージェントのバージョン6.7.0以降を使用 コンテキストのログを取得します。
  3. Railsアプリケーションの場合は、 サポートされているRailsのバージョン を使用してください。
  4. Rubyのコンテキストでログを設定する。
  1. ログアペンダーが正しく構成されていることを確認するには、アプリケーションを実行してから、クエリ演算子has:span.id has:trace.idを使用してNewRelicUIでログデータを確認します。

すべてが正しく構成され、データが強化されたメタデータとともにNew Relicに転送されている場合、ログはJSONとして出力され、 trace.id }フィールドとspan.idフィールドが含まれているはずです。

/config/application.rbまたは/config/environments/development.rbでロギングを構成した場合は、アプリケーションをローカルで実行し、ロギング出力を確認してください。次のような出力が表示されます。

{"entity.name":"your_app_name","entity.type":"SERVICE","hostname":"79bcbf8d","trace.id":"79bcbf8d","span.id":"00fc7d46","timestamp":1567701375543,"message":"example log message one","log.level":"DEBUG"}
{"entity.name":"your_app_name","entity.type":"SERVICE","hostname":"79bcbf8d","trace.id":"79bcbf8d","span.id":"6754870b","timestamp":1567702843604,"message":"example log message two","log.level":"DEBUG"}
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.