コンテンツにスキップ

トレースデータ収集


Guanceのトレースデータ収集は、現在 Opentracing プロトコルを使用するコレクタをサポートしています。DataKit でトレースデータ受信サービスを有効にした後、コード内でのコレクタのインストルメンテーションを完了することで、DataKit が自動的にデータの形式変換と収集を行い、最終的にGuanceへ送信します。

データ収集

DataKit は現在、DDTrace、Apache Jaeger、OpenTelemetry、Skywalking、Zipkin などのサードパーティ製 Tracing データの収集をサポートしています。

新規の APM 導入には、Beacon を優先的に使用し、DataKit の OpenTelemetry コレクタを介してトレースデータを受信することをお勧めします。

収集の前提条件

  1. DataKit をインストール;

  2. トレースデータ収集に関連するすべてのコレクタを設定します。

コレクタ設定

フィールドの説明

DataKit はコレクタの種類に応じて、送信されたデータをGuanceのトレースデータ形式に変換し、タグとメトリクスを保持します。以下はよく使われるフィールドの説明です:

フィールド名 説明
host ホスト名。デフォルトではグローバルタグ
source トレースのソース。Zipkin で収集した場合は zipkin、Jaeger で収集した場合は jaeger となり、以降も同様になります
service サービス名。このタグで、そのトレースデータを生成した業務システムの名前を指定することをお勧めします
parent_id 現在の span の直前の span の ID
operation 現在の span の操作名。Span 名と理解することもできます
span_id 現在の span の一意の ID
trace_id 現在のトレースの一意の ID
span_type Span のタイプ。現在サポートされているのは、entry、local、exit、unknow です
  • entry span はサービスへの進入時に作成される span を表します。つまり、そのサービスが他のサービスに呼び出しリクエストを提供するエンドポイントです。ほとんどの span は entry span であるべきで、entry タイプの span のみが独立したリクエストとなります
  • local span はリモート呼び出しとは関係なく、ローカルメソッドの呼び出し時に作成される span を表します。例えば、通常の Java メソッドなどです
  • exit span はサービスを離れるときに作成される span を表します。例えば、リモート呼び出しを開始するときや、メッセージキューでメッセージを生成するときなどです
  • unknow span は不明な Span を表します
  • endpoint リクエストの宛先アドレス。クライアントが対象サービスにアクセスするためのネットワークアドレスです。例:127.0.0.1:8080。デフォルトは null
    message トレース変換前に収集された生データ
    duration 現在のトレース span の継続時間
    status トレースステータス。info:通知、warning:警告、error:エラー、critical:重大、ok:成功
    env トレースの所属環境。例えば dev で開発環境、prod で本番環境を表すことができます。ユーザーがカスタマイズできます

    その他のフィールド一覧は、DataKit Tracing データ構造を参照してください。

    フィードバック

    このページは役に立ちましたか?