• ログイン今すぐ開始

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

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

問題を作成する

APMはコンテキストにログインします

アプリやホストの問題のトラブルシューティングを行うときは、すべてのNewRelicツールをすぐに使用できます。ただし、UI全体で多くのコンテキスト切り替えを行ったり、利用可能な豊富な情報に圧倒されたりすることは望ましくありません。

コンテキスト内のログ機能を使用すると、ログ データを他の New Relic データのコンテキストで表示できるため、相関関係を見つけて問題を解決しやすくなります。また、当社の APM エージェントは、関連する属性をアプリケーション ログ データに自動的に追加できます。これにより、コンテキストでのログの使用が非常に簡単になります。アプリケーションは、エージェントを使用して、ログ データを New Relic に直接転送することもできます。

ログは、それらが属するアプリケーション、トランザクション、またはエラーのコンテキストでより価値があります。Logs in Context 機能を使用すると、アプリケーションからのログ、分散トレース、およびエラーを APM で直接可視化できるため、トラブルシューティングの方法が変わります。

コンテキスト内のログがアプリとホストの問題の根本原因を見つけるのにどのように役立つかを確認するには、次の短いビデオ(約3:40分)をご覧ください。

ログインコンテキストの利点

APM ログイン コンテキストを使用すると、次のことができます。

  • タイムクリティカルな問題のトラブルシューティングを行うときに、何千ものログのノイズをカットして、最も関連性の高いログのみが自動的に表示されるようにします。
  • 複数のタイプのテレメトリデータ内をナビゲートし、データを元の問題に関連付けます。
  • UIの同じ場所から、より詳細な情報に簡単にドリルダウンできます。
  • 問題を特定して解決するために必要なログ行を見つけます。

状況に応じたログの力について詳しくは、ユースケースの例をご覧ください。この例では、エンジニアリング チームがアプリの応答時間の遅さとエラー率の上昇のトラブルシューティングにどのように使用したかを説明しています。

始めましょう

コンテキストでAPMログを設定するには:

  1. New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを新たに作成します。永久無料です。
  2. 最新の APM エージェント バージョンに更新します。
  3. APM エージェントの最新バージョンでは、ログ イン コンテキスト (メタデータの追加と転送) がデフォルトで有効になっています。ログを正しく機能させるために、エージェント構成ファイルを更新する必要がある場合があります。詳細については、エージェントのログを有効にする を参照してください。

それでおしまい!APM UI に移動し、関連するログ データを探して、コンテキスト内の APM ログを使用してアプリケーションのトラブルシューティングを開始します。

New RelicのAPMサマリーページから、ログ、トレース、エラーにドリルダウンします。

APMエージェントログの構成

当社の最新の APM エージェントは、サードパーティ ソフトウェアをインストールまたは維持する必要なく、自動的にコンテキストを追加し、ログを転送します。ログには、 span.idtrace.idhostnameentity.guidentity.nameなどの属性が自動的に含まれます。このメタデータは、ログを New Relic のトレース、スパン、インフラストラクチャ データ、およびその他のテレメトリにリンクし、問題のトラブルシューティングを容易にします。

コンテキスト内のログとログ転送をサポートする APM エージェントに関する情報と、そのドキュメントへのリンクを次に示します。

APM エージェントが自動ログイン コンテキスト ソリューションをまだサポートしていない場合は、引き続き手動ログ イン コンテキスト ソリューションを使用し、インフラストラクチャ エージェントまたはサポートされているサードパーティ フォワーダーを介してログを転送できます。

既知の制限

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

その他の既知の制限事項を次に示します。

  • 起動ログは、エージェントがロードされるまで利用できません。
  • Kubernetes を使用している場合は、Kubernetes API からではなく、インストルメンテーションを介してログを装飾することに注意してください。これは、ファイルシステムへのログの書き込みとは別のものです。ログがホストに触れたり、API を呼び出すことができる場所に存在したりすることはありません。
  • アプリケーションから例外がスローされた場合、現在、Java または .NET エージェントのコンテキストで関連するログにスタック トレースは表示されません。回避策として、ドロップ フィルタ ルールを変更できます。
  • Fluentd は、ログを生成したエンティティからprocessIDを追加できますが、APM ログはそれを確認できません。また、Kubernetes では API を呼び出してメタデータを追加しますが、このデータはアプリケーション内から見ることはできません。エンティティ メタデータが必要な場合は、コンテキストで自動ログを使用することをお勧めしますが、アプリケーションからログを送信しないでください。代わりに、引き続き Fluentd、Fluent Bit、または別のソリューションを使用してログ ファイルを転送してください。

データのプライバシーを確保する

注意

New Relicに送信するログデータはユーザーが管理するため、組織のセキュリティガイドラインに従って、個人識別情報(PII)、保護された健康情報(PHI)、またはその他の機密データの送信をマスク、難読化、または防止してください。

ログ取り込みパイプラインは、クレジットカード、社会保障番号、国民IDなどを自動的にマスクします。詳細については、ログ管理に関するセキュリティドキュメントを参照してください。

難読化機能を使用して、ログ内の機密データをマスクまたはハッシュするカスタムルールを作成することもできます。これは、機密データへのアクセスを制限することが非現実的または不可能な場合、または一部のデータをNewRelicによって保存してはならない場合に重要です。詳細については、難読化のドキュメントをお読みください。

ログの重複を防ぐ

コンテキスト機能でログを使用すると、データの取り込みが増加します。アカウントの料金モデルによっては、これが取り込み制限と請求に影響を与える可能性があります。

注意

APMエージェントを使用してアプリケーションから直接ログを送信する場合は、それらのアプリケーションから現在ログを収集しているログ転送ソリューションを無効にするか、変更する必要があります。そうしないと、重複したログが送信され、二重請求が発生します。

重複ログの送信を回避する方法の詳細については、アップグレードガイドを確認してください。

詳細については、手順に従って特定のログフォワーダーを無効にしてください。

摂取制限を管理する

例:エンジニアリングチームがアプリの問題のトラブルシューティングを行っているため、APMエージェントによって収集されるログの量を一時的に増やして、より詳細なログを提供します。ただし、上限を数日間実行したままにすると、不要なデータが送信され、請求額が増える可能性があります。

予期しない事態を回避するために、 NRQLクエリを使用してアラート条件を作成し、取り込み制限を追跡することをお勧めします。例えば:

例:コンテキストでのログの力

これは、問題の根本原因を突き止めるためにコンテキストでAPMログを使用する詳細な使用例です。

シナリオ例:オンコールエンジニアは、アプリの応答時間の短さとエラー率の上昇に関するNewRelicアラート通知を受け取ります。エラーと遅延の増加の背後にある根本的な原因を発見する必要があるため、問題のあるホストを負荷分散からローテーションするか、最新のリリースをロールバックするかを決定できます。

トラブルシューティングを開始するには、NewRelicUIに移動します。

Copyright © 2022 New Relic Inc.

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