トレースデータ収集¶
Guanceのトレースデータ収集は、現在 Opentracing プロトコルを使用するコレクタをサポートしています。DataKit でトレースデータ受信サービスを有効にした後、コード内でのコレクタのインストルメンテーションを完了することで、DataKit が自動的にデータの形式変換と収集を行い、最終的にGuanceへ送信します。
データ収集¶
DataKit は現在、DDTrace、Apache Jaeger、OpenTelemetry、Skywalking、Zipkin などのサードパーティ製 Tracing データの収集をサポートしています。
新規の APM 導入には、Beacon を優先的に使用し、DataKit の OpenTelemetry コレクタを介してトレースデータを受信することをお勧めします。
収集の前提条件¶
-
トレースデータ収集に関連するすべてのコレクタを設定します。
コレクタ設定¶
フィールドの説明¶
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 データ構造を参照してください。