この機械翻蚳は、参考ずしお提䟛されおいたす。

英語版ず翻蚳版に矛盟がある堎合は、英語版が優先されたす。詳现に぀いおは、このペヌゞを参照しおください。

問題を䜜成する

OpenTelemetryAPMUI

OpenTelemetry APM UI は、サヌビス ゚ンティティで利甚できる厳遞された゚クスペリ゚ンスです。 New RelicずOpenTelemetryを䜿甚しおサヌビスを構成しおいない堎合は、 OpenTelemetry APM監芖」を参照しおください。

OpenTelemetry APM UI ペヌゞは、問題を迅速に特定しお蚺断できるように蚭蚈されおいたす。 倚くの堎合、デヌタはさたざたなOpenTelemetry セマンティック芏則に準拠する必芁がありたすが、䞀郚は汎甚的です。

次の New Relic の抂念は、ペヌゞ間で繰り返されるか、重耇しおいたす。

OpenTelemetry APM サヌビスを探す

OpenTelemetry APM サヌビスを芋぀けるには、 All entities > Services > OpenTelemetryたたはAPM & Servicesに移動したす。 サヌビスをクリックするず、そのサヌビスのSummary page [抂芁ペヌゞ]に移動したす。

゚ンティティ ゚クスプロヌラヌ内では、 ゚ンティティ タグでフィルタヌできたす。 ゚ンティティ タグの蚈算方法の詳现に぀いおは、 New Relic の OpenTelemetry リ゜ヌスを参照しおください。

ペヌゞ: 抂芁

抂芁ペヌゞには、次のようなサヌビスの健党性の抂芁が衚瀺されたす。

  • 続きゎヌルデン: レスポンスタむム、スルヌプット、゚ラヌ率。 これらの蚈算方法の詳现に぀いおは、ゎヌルデン シグナルを参照しおください。
  • 関連゚ンティティ: このサヌビスず通信する他のサヌビスおよび関連むンフラストラクチャ。 詳现なビュヌに぀いおは、Service map参照しおください。
  • アクティビティ: このサヌビスに察しおアクティブなアラヌトのステヌタス。
  • ディストリビュヌティッド分散ト むンレヌシング サむト: 䞋流たたは䞊流の゚ンティティがパフォヌマンスの䜎䞋に寄䞎しおいる可胜性があるかどうかを発芋したす。 詳现に぀いおは、関連するトレヌス ゚ンティティ信号を参照しおください。
  • むンスタンス: サヌビスが氎平方向にスケヌリングされる堎合のむンスタンスごずのゎヌルデン倚数の内蚳。 service.instance.idリ゜ヌス属性に䟝存したす (詳现に぀いおはサヌビスを参照しおください)。

ペヌゞ: ディストリビュヌティッド分散トレヌシング

ディストリビュヌティッド分散ト レヌシング ペヌゞでは、 OpenTelemetryトレヌス デヌタの詳现が提䟛されおいたす。 ペヌゞの䜿甚情報に぀いおは、ディストリビュヌティッド分散トレヌシングを参照しおください。 デヌタが OpenTelemetryNew Relicに取り蟌たれる方法の詳现に぀いおはOpenTelemetryNew Relic 、 Relic の を参照しおください。

ゎヌルデンシグナルず同様に、スパンのステヌタスがERRORに蚭定されおいる堎合 (たずえば、 otel.status_code = ERROR )、スパンぱラヌずしお分類されたす。 スパンぱラヌの堎合、゚ラヌの詳现にスパンのステヌタスの説明たずえば、 otel.status_description が衚瀺されたす。

OpenTelemetryスパン むベントは、远加のむベント コンテキスト情報を特定のスパンに添付したす。 これらは䟋倖情報をキャプチャするために最もよく䜿甚されたす。 利甚可胜な堎合は、trace details [トレヌスの詳现]でスパンのむベントを衚瀺できたす。

ヒント

スパンの䟋倖むベントが存圚するだけでは、スパン自䜓が゚ラヌであるずはみなされたせん。 スパン ステヌタスがERRORに蚭定されおいるスパンのみが゚ラヌずしお分類されたす。

Screenshot showing the right pane showing the two links for span events

ペヌゞ: サヌビスマップ

サヌビス マップ ペヌゞでは、アヌキテクチャ党䜓を芖芚的に衚珟したす。 詳现に぀いおは、サヌビス マップを参照しおください。

ペヌゞ: 履歎曞

トランザクション ペヌゞには、サヌビスのトランザクションに関する問題を特定し、分析するためのツヌルが提䟛されたす。

メトリクスの堎合、この曞き蟌みでは、デヌタがHTTP メトリクスたたはRPC メトリクスの意味芏則に準拠しおいるず想定されたす。 http.route属性ずrpc.method属性は、トランザクションによるリスト衚瀺ずフィルタリングに䜿甚されたす。

スパンの堎合には、ク゚リは汎甚的であり、最䞊䜍レベルのスパンのデヌタ モデルのみを利甚したす。 スパンは、ゎヌルデンストップで説明されおいるように、瞬間スルヌプットず応答タむムにカりントされたす。 スパンの名フィヌルドは、トランザクションによるリスト衚瀺ずフィルタリングに䜿甚されたす。

ペヌゞ: デヌタベヌス

デヌタベヌス ペヌゞには、サヌビスのデヌタベヌス クラむアント操䜜に関する問題を特定し、分析するためのツヌルが甚意されおいたす。

珟圚、利甚できるセマンティック芏則がないため、デヌタベヌスのメトリックスベヌスのビュヌはありたせん。

スパンの堎合には、ク゚リはデヌタがDB スパンのセマンティック芏則に準拠しおいるず想定したす。 スパン名、 db.system 、 db.sql.table 、 db.operation属性は、デヌタベヌス操䜜の䞀芧衚瀺ずフィルタリングに䜿甚されたす。

ペヌゞ: 倖郚サヌビス

倖郚ペヌゞには、呌び出し元゚ンティティ (䞊流サヌビス) や呌び出し先゚ンティティ (䞋流サヌビス) などのサヌビスの倖郚呌び出しに関する問題を特定し、分析するためのツヌルが甚意されおいたす。

倖郚サヌビスペヌゞのメトリックスベヌスのビュヌはありたせん。

スパンの堎合には、ク゚リは汎甚的であり、最䞊䜍レベルのスパンのデヌタ モデルのみを利甚したす。 スパンは、サヌビスを終了する堎合、倖郚サヌビスのスルヌプットず応答タむムにカりントされ、 WHERE span.kind = client OR span.kind = producerのヒュヌリスティックを䜿甚しお蚈算されたす。 デヌタベヌス クラむアントスパンは、 WHERE db.system is nullを䜿甚しおフィルタリングされたす (ペヌゞ: デヌタベヌスを参照)。 ゎヌルデンシグナルず同様に、スパンのステヌタスコヌドがERROR (たずえば、 otel.status_code = ERROR ) の堎合、そのスパンぱラヌになりたす。 利甚可胜な堎合、 HTTP スパンおよびRPC スパンのセマンティック芏則のデヌタを䜿甚しお、倖郚サヌビス呌び出しを分類したす。

ペヌゞ: JVM ランタむム

JVM ランタむム ペヌゞには、Java サヌビスの JVM の問題を特定し、分析するためのツヌルが提䟛されおいたす。 このペヌゞは、 OpenTelemetry java を䜿甚するサヌビスに察しおのみ衚瀺されたす。 個別のサヌビス むンスタンスを区別するために、ペヌゞではservice.instance.idリ゜ヌス属性を蚭定する必芁がありたす (詳现に぀いおは、 「サヌビス」を参照しおください)。

JVMゎヌルデン ランタむム ペヌゞには、ランタむムの問題ずサヌビスの䜿甚状況を関連付けるために、 JVMランタむム メトリクスの暪に、ストップが衚瀺されたす。 メトリクスたたはスパンの切り替えは、ゎヌルデン ストップがスパン デヌタたたはメトリクス デヌタのどちらによっお駆動されるかを決定したす。 JVMランタむム メトリクスにはスパンベヌスのビュヌはありたせん。

メトリクスの堎合、曞き蟌みはデヌタがJVMメトリクスの意味芏則に準拠しおいるこずを前提ずしおいたす。 これらの芏則は、 OpenTelemetry Java゚ヌゞェントに自動的に組み蟌たれるOpenTelemetry Java ランタむム むンストゥルメンテヌション ラむブラリに具䜓化されおいるこずに泚意しおください。

ペヌゞ: Go ランタむム

Go ランタむム ペヌゞには、Go サヌビスのランタむムの問題を特定し、分析するためのツヌルが提䟛されおいたす。 このペヌゞは、 OpenTelemetry Go を䜿甚するサヌビスに察しおのみ衚瀺されたす。 個別のサヌビス むンスタンスを区別するために、ペヌゞではservice.instance.idリ゜ヌス属性を蚭定する必芁がありたす (詳现に぀いおは、 「サヌビス」を参照しおください)。

Go ランタむムのゎヌルデン ペヌゞには、ランタむムの問題ずサヌビスの䜿甚状況を関連付けるために、Go ランタむム メトリクスの暪に「マむナス」が衚瀺されたす。 メトリクスたたはスパンの切り替えは、ゎヌルデン ストップがスパン デヌタたたはメトリクス デヌタのどちらによっお駆動されるかを決定したす。 Go ランタむム メトリクスにはスパンベヌスのビュヌはありたせん。

メトリクスの堎合、ク゚リはOpenTelemetry Go ランタむム むンストゥルメンテヌション ラむブラリによっおデヌタが生成されるこずを前提ずしおいたす。 なお、珟圚、Go ランタむム メトリックスにはセマンティック芏則はありたせん。

ペヌゞ: ログ

ログ ペヌゞには、問題を特定し、サヌビスのログを分析するためのツヌルが提䟛されたす。 詳现に぀いおは、 「ログ UI の䜿甚」を参照しおください。

ペヌゞ: Errors Inbox

゚ラヌ受信トレむ ペヌゞには、サヌビスの゚ラヌを怜出しおトリアヌゞするためのツヌルが提䟛されたす。 詳现に぀いおは、 「゚ラヌ受信トレむの䜿甚開始」を参照しおください。

Errors Inboxペヌゞはトレヌス デヌタによっお駆動されたす。 ゎヌルデンシグナルず同様に、スパンのステヌタスがERRORに蚭定されおいる堎合 (たずえば、 otel.status_code = ERROR )、スパンぱラヌずしお分類されたす。

゚ラヌ スパンは、UUID、16 進数倀、電子メヌル アドレスなどの識別倀を正芏化しお蚈算された゚ラヌ フィンガヌプリントごずにグルヌプ化されたす。 それぞれの個別の゚ラヌ スパンは、゚ラヌ グルヌプ内の個別のむンスタンスです。 ゚ラヌ グルヌプ メッセヌゞは次のように決定されたす。

  • スパンステヌタスの説明䟋 otel.status_description 
  • rpc.grpc.status_code RPCスパンセマンティック芏玄から
  • http.status_code HTTPスパンセマンティック芏玄から
  • http.response.status_code HTTPスパンセマンティック芏玄から
  • undefined 䞊蚘のいずれも存圚しない堎合

ペヌゞ: メトリクス゚クスプロヌラヌ

メトリクス ゚クスプロヌラヌは、サヌビスのメトリクスを䞀般的な方法で探玢するためのツヌルを提䟛したす。 詳现に぀いおは、 「デヌタの探玢」を参照しおください。

黄金の信号

最長、レスポンスタむム、゚ラヌ率のゎヌルデン シグナルは、 OpenTelemetry APM UI党䜓の耇数の堎所に衚瀺されたす。 䜿甚する堎合、次のように蚈算されたす。

メトリクスの堎合、この曞き蟌みでは、デヌタがHTTP メトリクスたたはRPC メトリクスの意味芏則に準拠しおいるず想定されたす。

スパンの堎合には、ク゚リは汎甚的であり、最䞊䜍レベルのスパンのデヌタ モデルのみを利甚したす。 スパンは、サヌビスぞのルヌト ゚ントリ スパンの堎合には、長さず応答時間にカりントされ、ヒュヌリスティックWHERE span.kind = server OR span.kind = consumerを䜿甚しお蚈算されたす。 スパンのステヌタス コヌドがERROR (たずえば、 otel.status_code = ERROR ) の堎合、そのスパンぱラヌになりたす。

フィルタヌでデヌタを絞り蟌む

いく぀かのペヌゞには、Narrow data to... [デヌタを絞り蟌む]などのオプションを含むフィルタヌ バヌが含たれおいたす。 これにより、ペヌゞ䞊のク゚リを基準に合わせおフィルタリングできたす。 たずえば、 service.version='1.2.3-canary'をフィルタリングするこずで、特定のカナリアデプロむメントに絞り蟌むこずができたす。 ペヌゞ間を移動するずきにフィルタヌは保持されたす。

メトリクスたたはスパンの切り替え

さたざたなペヌゞにメトリクスたたはスパンの切り替えが含たれおいたす。 これにより、分析芁件ずデヌタの可甚性に基づいお、執筆をスパン デヌタたたはメトリクス デヌタのどちらによっお行うかを遞択できたす。

メトリックはサンプリングの察象ではないため、特に䞭間率などのレヌトを蚈算する堎合はより正確です。 ただし、メトリックはカヌディナリティ制玄の察象であり、分析に重芁な特定の属性が欠萜しおいる可胜性がありたす。 察照的に、スパンはサンプリングされるため、粟床の問題が生じたすが、カヌディナリティ制玄の察象ではないため、より豊富な属性を持ちたす。

歎史的に、 OpenTelemetry蚀語APIず SDK、およびむンストゥルメンテヌションはトレヌス むンストゥルメンテヌションを優先しおいたした。 ただし、プロゞェクトは長い道のりを経お、メトリクスはほがすべおの蚀語で利甚できるようになりたした。 詳现に぀いおは、関連する蚀語ずむンストゥルメンテヌションのドキュメントを確認しおください。

ゎヌルデンメトリクス

ゎヌルデン メトリクスは、HTTP/RPC メトリクスなどの逆ゎヌルデン デヌタの䜎カヌディナリティ バヌゞョンです。 これらは、゚ンティティ ゚クスプロヌラヌ、ワヌクロヌド アクティビティ ペヌゞ、倉曎远跡 (倉曎远跡機胜) 詳现ペヌゞなど、さたざたなプラットフォヌム ゚クスペリ゚ンスに組み蟌たれたす。 これらのメトリクスは、 newrelic.goldenmetrics.ext.service.*のような名前を䜿甚したす。

重芁

歎史的に、 OpenTelemetryゎヌルデンメトリクスはスパンから蚈算されおいたした。 スパンは、通垞、サンプリングされるため、郚分的な画像しか提䟛されたせん。 ゎヌルデン メトリクスが広く利甚できるようになった珟圚、ゎヌルデン メトリクスはスパン デヌタではなくメトリクス デヌタを䜿甚しお蚈算されたす。