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

この機械翻訳は参考用に提供されます。

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

問題を作成する

OpenTelemetryメトリック:ベストプラクティス

輸出条件年 = 2023; export const gaDate = '4 月 4 日'; const gaDateAndYear = gaDate + ', ' + 年をエクスポートします。

OpenTelemetryメトリクスは、New Relicのディメンションメトリクスとほぼ互換性があります。OpenTelemetry メトリクス v0.10 をサポートしています。サポートしているすべてのメトリクスタイプには、独立した関連属性(名前と値のペア)のセットが含まれており、クエリ時にメトリクスデータのファセットやフィルタリングに使用できるディメンションに直接マッピングされます。OpenTelemetryメトリクスには、 リソース 属性のセットが付属しています。この属性は、メトリクスを生成したオリジネーターを識別し、ファセット化やフィルタリングのためのディメンションにマッピングされます。

メトリクスの OpenTelemetry データ モデルは、合計、ゲージ、ヒストグラム、サマリーなど、さまざまなメトリクス タイプを定義します。

和の指標

OpenTelemetry の合計は、特定の時間枠におけるすべてのデータ ポイントの合計であるスカラー メトリックです。合計には、報告された値に以前の測定値が組み込まれているか (累積的な一時性)、含まれていないか (デルタ一時性) を示す一時性の概念があります。

また、和は単調なもの(上にしか行かない、下にしか行かない)と、非単調なもの(上にも下にも行く)があります。

デルタ・サムズ

デルタ和は、単調であるか非単調であるかによって、異なる方法で処理されます。

積算金額

累積和は、単調か非単調かによって処理が異なります。

  • 非単調累積合計は、 ゲージメトリック タイプにマップされます。
  • 単調累積合計は、 cumulativeCount メトリクス タイプにマッピングされます。これは、gaDateAndYear の前に累積単調合計を送信していたアカウントを除いて当てはまり、引き続き gauge 指標タイプにマッピングされます: 移行ガイド を参照してください。

サムの構成例

集約の一時性を構成する方法を理解するには、 JavaおよびPython OpenTelemetry SDK を使用したこれらの例を参照してください。

ゲージ・メトリクス

OpenTelemetry ゲージ メトリック データ ポイントは、特定の時間にサンプリングされた値を表します。これらの値は、New Relic ゲージメトリック タイプに変換されます。OpenTelemetry ゲージには集計の一時性はありませんが、サンプリングされた値はクエリ時に集計できます。

ヒストグラム・メトリクス

OpenTelemetry ヒストグラム 記録された値の集団を、合計数や合計値とともにコンパクトに表現します。オプションとして、ヒストグラムには、明確な境界線を持つ一連のバケットと、そのバケットの人口に対するカウント値を含めることができます。

すべての OpenTelemetry ヒストグラムは、New Relic の ディストリビューションメトリック タイプに変換されます。これは、スケーリングされた指数ベース 2 ヒストグラムによってサポートされます (詳細な説明については、 NrSketchを参照してください)。

デルタ・ヒストグラム

指数ヒストグラムの場合、NrSketch に直接変換できます。

明示的な境界ヒストグラムの場合、線形補間を使用して、OpenTelemetry ヒストグラム バケットからのカウントが New Relic の分布メトリック バケットに割り当てられます。また、OpenTelemetry には、New Relic で幅ゼロのバケットとして表される負および正の無限バウンド バケットがあります。これを行うのは、負の無限大と正の無限大の表現がないためです。たとえば、境界が\[-∞, 10)の OpenTelemetry バケットは、幅がゼロの\[10,10) New Relic バケットで表されます。この変換により、ディストリビューションのエンドポイントで誇張されたバケット数が表示される場合があります。

累積ヒストグラム

累積ヒストグラムは デルタ ヒストグラムに変換されます。翻訳プロセスの詳細については、 累積指標を参照してください。

サマリー・メトリクス

OpenTelemetry サマリー メトリック データ ポイントは、変位値のサマリー (P99 レイテンシなど) を表すために使用されます。これらは New Relic のサマリー メトリクス タイプに直接マッピングされますが、維持する唯一の分位数は、最小値と最大値の 0.0 と 1.0 の分位数です。パーセンタイルを取得したい場合は、 ヒストグラム メトリックを優先します。

サマリーメトリクスのデータポイントには、カウント、サム、および分位値があり、0.0が最小、1.0が最大となります。OpenTelemetryでは、他のフォーマットとの互換性のために、サマリーメトリックを提供しています。

開始時間

startTimeUnixNano フィールドは、OpenTelemetry 仕様に従ってオプションです。デルタ集約の時間性については、存在する場合、結果として得られる New Relic メトリクスのタイムスタンプに使用され、 durationtimeUnixNano - startTimeUnixNanoとして計算されます。duration フィールドは、New Relic メトリクスのクエリ可能な endTimeStamp 属性を計算するために使用されますが、他の意味的な目的はありません。

startTimeUnixNanoが指定されていない場合、結果のNew RelicメトリックのタイムスタンプフィールドにtimeUnixNanoが使用され、durationフィールドはゼロに設定されます。

累積集約の一時性の場合、 startTimeUnixNano 時系列の最初の観測値を表し、リセットの検出に使用されます。timeUnixNano は、累積データ ポイントのタイムスタンプとして解釈されます。次に、累積データ ポイントが デルタ集約時間性に変換されます

属性の配列値

OpenTelemetryメトリックおよびその他の信号には、プリミティブ型の同種の配列で構成される属性が含まれる場合があります。 New Relicは、65要素未満のネストされていない同種配列をサポートします。

模範例

OpenTelemetry では、トレースのような他のシグナルをメトリックイベントに接続してコンテキストを提供するための模範的な値を定義しています。New Relic ではエグザンプルはサポートされていません。

メトリクスの照会方法

New RelicでメトリックなNRQLクエリを構築するためのヒントを考えてみましょう。

CumulativeCounts として格納された累積合計をクエリします

データをクエリする方法は次のとおりです。

ゲージに格納された累積値の照会

gaDateAndYear より前に累積合計を報告した New Relic のお客様は、累積合計が gauge タイプに変換されます。これがどのように変更されるかについて詳しくは、 累積指標の移行ガイドを参照してください。

累積合計が gauge タイプとして保存されている場合、データをクエリする方法は次のとおりです。

クエリ・ゲージ・メトリクス

New Relicが累積合計をゲージに変換する場合、 latest()またはderivative() NRQL関数を使用してそれらをクエリできます。選択する関数は、生の値を表示するか、変化率を計算するかによって異なります。

クエリ・ヒストグラム・メトリクス

OpenTelemetry メトリクスから変換された New Relic ヒストグラムには、他の New Relic ヒストグラムと同じクエリ セマンティクスがあります。つまり、 histogram() NRQL 関数を使用して、構成可能なバケット数とバケット幅でヒストグラムを表すことができます。累積ヒストグラムはデルタ ヒストグラムに変換されるため、デルタ ヒストグラムがクエリされるのと同じ方法でクエリが実行されます。明示的な境界ヒストグラムについては、エンドポイント バケットでより大きなバケット数が表示される場合があることに注意してください。これは、負と正の無限にバインドされた OpenTelemetry バケットを幅ゼロの New Relic バケットに追加しているためです。

重要

TIMESERIESキーワードは、 percentiles()をチャリングしない限り、New Relic ヒストグラムではサポートされていません。

Copyright © 2024 New Relic株式会社。

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