その他の言語にOpenTelemetryを導入する
最終更新
最終更新
VaxilaはOpenTelemetryの仕組み (計装)を利用してデータを送信しています。
このページではVaxilaのドキュメントでは紹介していない言語を使ってデータをVaxilaに送信する方法を解説します。
Vaxilaが利用するOpenTelemetryには多数のSDKがあり、多くの言語やフレームワークに対応しています。全てについてのドキュメントを書くことはできませんが、設定内容は共通しています。
このページでは言語共通の設定について解説します。
また、OpenTelemtryのSDKは共通部分がかなり多いため、別の言語の計装方法を解説したページも参考になります。
例えば、以下のページです。
Vaxilaを使用する場合、SDKからデータを直接Vaxilaに送信するのではなく、Collectorを使うこともできます。
Collectorを使うかどうかを決める際は以下のページを参考にしてください。
SDKの導入は以下のステップになります。
SDKの検索
アプリケーション内での設定
エラーを補足
独自の計装の追加 (任意)
導入したい言語をOpenTelemtry公式のRegistryから検索します。
以下のページでLanguage
を対象言語に、 Type
を Instrumentation に設定すると対象言語のSDKが検索できます。
アプリケーション内でSDKを実行する際には、エンドポイントなどの設定が必要になります。以下の項目を設定します。
エンドポイント
SDKからデータを直接Vaxilaに送信する場合は、Vaxilaのエンドポイント (https://telemetry.vaxila-labs.com/v1/traces)
Collectorを利用する場合は、Collectorのエンドポイント (http://localhost:4318/v1/traces など)
送信時のヘッダー
SDKからデータをVaxilaに直接送信する場合、以下のヘッダーが必要です。
Accept: */*
X-Vaxila-Token: Vaxilaが発行したトークン
Collectorを利用する場合、ヘッダーは必要ありません。
Resource
最低限、以下を設定しておくといいでしょう。
サービス名 (service.name
)
サービスのバージョン (service.version
)
環境名 (deployment.environment
)
残念ながら、エラーが発生した場合に自動でエラー情報を追加しないSDKもあります。
そのため、エラーが発生したときにエラーメッセージやスタックトレースをSpanに追加するようコードを変更する必要があることがあります。
使用しているSDKがエラーを補足しているかどうかは、エラーが発生したトレースの Events
にエラー内容が書かれているかで判断できます。
エラーを補足している場合、以下のように events
の中にエラー内容やスタックトレースが追加されます。
エラーを補足していない場合、フレームワークのエラーハンドリング部分など、エラーを補足している場所でOpenTelemetryのイベント(Event)を追加する必要があります。
具体的には、recordException
や recordError
といった関数がSDKに用意されているので、それを呼び出します。
すると、以下の属性を保持したEventがSpanに追加されます。
Vaxila はこれらの属性を利用してエラー内容を把握し、グルーピングしています。
独自のSpanを追加することで、任意の範囲を計装することができます。
計装することで、変数の値や処理時間を記録することができます。
各言語に必ず用意されているはずです。
属性名 | 属性の意味 | 例 |
---|---|---|
exception.type
エラー種別
java.net.ConnectException
exception.message
エラーメッセージ
Can't convert 'int' object to str implicitly…
exception.stacktrace
スタックトレース
Exception in thread "main" java.lang.RuntimeException: Test exception\n at ...