• ログイン

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

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

問題を作成する

Trace APIです。スパンを属性で飾る

このドキュメントでは、 Trace API に送信されるトレースデータに属性を追加し、スパンが UI に特定のプロパティを表示する方法について説明します。

なぜスパンを飾るのか?

Trace API にデータを送信する際、カスタム 属性 をスパンに追加することができます。たとえば、 customer.iduser.id のような属性を追加することで、トレースデータの分析に役立てることができます。

いくつかの期待される属性値は、私たちの分散型トレースUIに、いくつかの特定の トレースプロパティ と詳細を表示させます。例えば、 error. 接頭辞を持つ属性を持つスパンは、UIがそのスパンにエラーを表示します。別の例として、 db. 接頭辞を持つ属性を持つスパンは、UIにおいてデータストア・スパンとして表示され、そのデータストア・クエリがハイライトされます。

スパンを装飾して、UIの特定のプロパティを表示することができます。

  • トレースデータの 構造の理解を深める
  • より簡単にトラブルシューティングができるようになりました。

属性でスパンを装飾する方法

このテーブルでは、Trace API に送信されたスパンを、UI の特定のプロパティで表示させる方法を説明します。プロパティの説明については、 span properties を参照してください。

希望するスパンのプロパティ

UIインジケータ

プロパティの追加方法

エラー

error.message 接頭辞をつけた属性を使う。例: error.message.

外部

http. のプレフィックスを持つ属性を使用します。例: http.method.スパンは、別のエンティティから来た子を持つ場合、外部としても表示されます。

データストア

db. のプレフィックスを持つ属性を使用します。例: db.statement.

サービス

これは、属性ではできません。スパンは、それがルートスパンであるか、またはその親が異なるエンティティのものである場合、サービススパンとして分類されます。スパンに複数のプロパティがある場合、UIではサービススパンの分類が優先されます。

インプロセス

これは、属性ではできません。スパンは、サービススパン、データストアスパン、または外部スパンとして分類されていない場合、処理中として分類されます。

これらのスパンのプロパティがどのように決定され、保存されるかについては、 Trace structure を参照してください。

属性を追加するためのヒント

  • スパンには任意の属性を追加できます。例えば、 customer.id のような属性を追加することで、 世界中のトレースを検索 特定の顧客を含むトレースを検索することができます。
  • 1つのスパンが複数のカテゴリーに分類されることがあります。例えば、 external は、 datastore よりも一般的なカテゴリであるため、あるスパンが externaldatastore の両方に分類されている場合、UIではdatastoreスパンとして表示されます。

JSONの例

ここでは、属性を使ってスパンのプロパティを設定する方法を示すJSONの例を紹介します。

Copyright © 2022 New Relic株式会社。

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