• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は、参考として提供されています。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。

問題を作成する

OpenTelemetryのNew Relic

このドキュメントでは、New Relic が専用の OTLP エンドポイントを通じて受信した OpenTelemetry ログを処理する方法に焦点を当てています。

OpenTelemetry ログを New Relic に送信するための一般的なワークフローは 2 つあります。

選択した収集方法に関係なく、統合を成功させるには、ログをこのエージェントにエクスポートするようにログ ソースを構成する必要があります。 続行する前に、必ず デバイスの設定要件を確認してください。

OTLP ログレコードのマッピング

New Relic は OTLP ログ レコードをLogデータ型にマッピングします。 以下の表はLogRecord proto メッセージのフィールドが New Relic Logにどのようにマッピングされるかを示しています。

OTLP logs.protoフィールド

New Relic Logフィールド

ResourceLogs.Resource.attributes

各キー値はLogフィールドの属性である[1]

ScopeLogs.InstrumentationScope.name

otel.library.name

ScopeLogs.InstrumentationScope.version

otel.library.version

ScopeLogs.InstrumentationScope.attributes

各キー値はLogフィールドの属性である[1]

LogRecord.time_unix_nanos

timestamp [2]

LogRecord.severity_number

severity.number

LogRecord.severity_text

severity.text

LogRecord.body

message、および解析された属性[3]

LogRecord.attributes

各キー値はLogフィールドの属性である[1]

LogRecord.dropped_attribute_count

otel.dropped_attributes_count

LogRecord.flags

w3c.flags (整数)

LogRecord.trace_id

trace.id

LogRecord.span_id

span.id

表の脚注

[1]リソース属性、スコープ属性、ログレコード属性、最上位ログレコードフィールド、およびLogRecord.body [3]からの解析された属性に競合がある場合、優先順位(最高から最低)は次のようになります: LogRecord.bodyからの解析された属性 -> 最上位LogRecord.*フィールド > LogRecord.attributes > ScopeLogs.InstrumentationScope.attributes > ResourceLogs.Resource.attributes

New Relic OTLP エンドポイントでサポートされている属性タイプの詳細については、 OTLP 属性タイプを参照してください。

[2] LogRecord.time_unix_nanosが存在しない場合は、 timestamp New Relicがデータを受信した時刻に設定されます。

[3]ログ解析はLogRecord.bodyに適用され、プレーンログテキストから属性を抽出しようとします。 たとえば、JSON 構造化ログ形式が使用される場合、キー値は結果のログの属性になります。 これは、ファイルまたはstdoutからログを収集する場合に特に便利です。 この場合、ログ レコードに関連付けられたリソース属性 ( APM サービス相関に必要) がなく、 LogRecord.trace_id / LogRecord.span_idの値 (トレース相関に必要) がないのが一般的です。 必要なフィールドを正常に解析できれば、相関関係は意図したとおりに機能します。

OpenTelemetry APM サービスとの相関

ログは、 必要な属性が含まれている場合、サービス エンティティと相関関係にあります。 通常、これらはResourceLogs.Resource.attributesなどのログのリソース属性から取得されますが、 OTLP マッピングの脚注 3で説明されているようにLogRecord.bodyから解析することもできます。

サービスのログを表示するには、そのサービスのログ ページに移動します。

トレースとの相関

trace.id属性とspan.id属性を解決できる場合、ログはトレースと相関付けられます。 通常、これらはLogRecord.trace_idフィールドとLogRecord.span_idフィールドから取得されますが、 OTLP マッピングの脚注 3 で説明されているようにLogRecord.bodyから解析することもできます。

特定のトレースのコンテキストで記録されたログを表示するには、次の 2 つのオプションがあります。

  • トレースの詳細ページ 内の Logs [ログ]タブに移動します。
  • サービスのログ ページに移動し、ログをクリックしてログの詳細を開きます。 トレースに関連付けられている場合は、Log details[ログの詳細]からTrace details[トレースの詳細]に移動できます。
Copyright © 2024 New Relic株式会社。

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