NerdGraphチュートリアル。分散型トレースの詳細を見る

New Relic の NerdGraph GraphiQL エクスプローラーを使って、分散型トレーシングのデータを照会することができます。本ドキュメントで説明します。

NerdGraphでしか得られないトレースメタデータ
トレースデータのクエリ例

トレースメタデータ

スパンイベントとトランザクションイベントデータに加えて、トレースとそのスパン関係に関する追加のメタデータを計算する。このメタデータを照会するには、 api.newrelic.com/graphiql にある NerdGraph GraphiQL エクスプローラーにアクセスします。

トレースレベルの追加データ

トレースレベルのメタデータ	説明
`durationMs`	このトレースの継続時間をミリ秒単位で指定します。
`entities`	このトレースの一部であるすべてのエンティティ。
`entityCount`	このトレースの一部であるエンティティの数です。
`spanConnections`	このトレース内のすべてのスパンの関係を表す親子のID。
`timestamp`	Unixエポックからのミリ秒単位でのトレースの開始時間](https://currentmillis.com/)。

スパンレベルの追加データ

スパンレベルのメタデータ	説明
`clientType`	クライアントスパンの場合、これは`DATASTORE`または`EXTERNAL`と呼ばれるエンティティのタイプを示します。
`entityGuid`	スパンを送信したエンティティの New Relic の識別子。
`processBoundary`	プロセス間の境界に関するスパンの位置: `ENTRY` 、 `EXIT` 、または`IN_PROCESS` 。
`spanAnomalies`	あるスパンで検出された異常は、そのスパンが発生する前の数時間に発生した類似のスパンと比較されます。異常なスパンは、トレース UI に表示されます。

トレース構造とスパンの関係については、トレース構造を参照してください。

トレースデータの問い合わせ例

以下は、分散型トレースデータのNerdGraphクエリの例です。

この NerdGraph クエリの例は、トレースのtraceIdを使用してトレースのすべてのデータを返す方法を示しています。attributesはSpanイベント属性を返すために使用されることに注意してください。

{
  actor {
    distributedTracing {
      trace(traceId: "YOUR_TRACE_ID") {
        spans {
          attributes
          clientType
          durationMs
          entityGuid
          id
          name
          parentId
          processBoundary
          timestamp
          traceId
          spanAnomalies {
            anomalousValue
            anomalyType
            averageMeasure
          }
        }
      }
    }
  }
}

トレース構造とスパンの関係については、トレース構造を参照してください。

このNerdGraphクエリの例では、スパン間の関係に関するトレースレベルのメタデータを返す方法を示しています。

{
  actor {
    distributedTracing {
      trace(traceId: "YOUR_TRACE_ID") {
        id
        timestamp
        durationMs
        spanConnections {
          parent
          child
        }
      }
    }
  }
}

トレース構造とスパンの関係については、トレース構造を参照してください。

このNerdGraphクエリの例では、エンティティに関連するトレースと、そのエンティティに関するいくつかのデータを返します。

{
  actor {
    distributedTracing {
      trace(traceId: "YOUR_TRACE_ID") {
        entities {
          name
          tags {
            key
          }
          account {
            name
          }
        }
      }
    }
  }
}

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

NerdGraphチュートリアル。分散型トレースの詳細を見る

トレースメタデータ

トレースデータの問い合わせ例

トレースIDによる検索

スパンの関係データの照会

トレース内のエンティティのクエリデータ

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

NerdGraphチュートリアル。分散型トレースの詳細を見る

トレースメタデータ.css-21sua1{background:none;border:none;width:0;padding:0;}

トレースデータの問い合わせ例

スパンの関係データの照会

トレース内のエンティティのクエリデータ

トレースメタデータ