トレーサーのデータ取り込み制御
Instana のトレーサーからのデータ取り込みを制御し、コストを最適化するとともに、関連性の高いトレースに焦点を当てる。 主要なワークフローの可視性を維持しつつ、取り込み量を削減し、ノイズを最小限に抑え、重要なトレースのみを保持することができます。
Instana 全体におけるデータ取り込みの最適化に関する概要については、 『 Instana 』の「データ取り込みの最適化」 を参照してください。 トレーサーの機能比較については、 「トレーサー機能比較表」を参照してください。
トレーサビリティにおける「摂取管理」の意味
取り込み制御を追跡することで、トラブルシューティングやパフォーマンス分析に最も役立つトレースを残しつつ、価値の低いトレースデータを削減することができます。 使用しているトレーサーやバージョンによっては、特定のエンドポイントを非表示にしたり、スパンをフィルタリングしたり、スタックトレースの取得を制限したり、特定の計測機能を無効にしたりすることができます。
利用可能な摂取量管理方法
要件に応じて、以下の方法を使用してトレースデータの取り込みを制御してください：
- エンドポイントを無視する ：重要度の低い操作をトレースから除外します。
- 属性によるスパンをフィルタリング ：URL、メソッド、ステータスコード、ヘッダー、クエリパラメータ、SQL文、エラーメッセージなどの属性に基づいて、スパンを除外します。
- スタックトレースの取得を制限する ：ノイズを減らし、パフォーマンスを向上させるために、スタックトレースの取得深度を制御します。
- 選択した計測機能を無効にする ：特定の計測機能をオフにして、オーバーヘッドとノイズを低減します。
- ホストエージェントのモードを変更する ：ホストエージェントを「インフラストラクチャ」モードに切り替えることで、そのホスト上のすべてのトレーサーを無効にします。
- プログラムによるトレースの抑制 ：コードレベルの制御機能を使用して、特定の操作やコンテキストに対するトレースを抑制します。
機能のサポート状況は、すべてのトレーサーで統一されていません。 実装を行う前には、必ずトレーサーの対応状況、バージョン要件、および設定構文を確認してください。 各トレーサー間の機能の有無を比較するには、 「トレーサー機能比較マトリックス」 を参照してください。
エンドポイントを無視する
Instana サービスのやり取りをエンドポイントとして可視化します。 エンドポイントフィルタリングを使用して、価値の低い操作がトレースに記録されないようにします。 この方法は、ノイズを発生させるだけで有用な価値をもたらさない特定のコマンド、アクション、または操作を除外したい場合に役立ちます。
エンドポイントフィルタリングのサポートの有無は、トレーサーによって異なり、場合によってはパッケージやフレームワークによっても異なります。 設定の詳細については、お使いのトレーサーのドキュメントを参照してください。
属性でスパンをフィルタリングする
URL、メソッド、ステータスコード、ヘッダー、クエリパラメータ、SQL文、エラーメッセージなどの属性に基づいてスパンを除外したい場合は、スパンフィルタリングを使用してください。
この方法は、エンドポイントフィルタリングよりもさらにきめ細かな制御を行いたい場合に役立ちます。 対応状況はトレーサーによって異なります。 トレーサーごとの詳細については、以下のページを参照してください：
スタックトレースの取得を制限する
失敗した呼び出しのスタックトレースは保持しつつ、スタックトレースによるペイロードサイズやオーバーヘッドを削減したい場合は、スタックトレース制御機能を使用してください。
トレーサーによっては、エラーが発生した場合にのみスタックトレースをキャプチャしたり、スタックトレースの長さを制限したり、特定のスパンについてスタックトレースのキャプチャを無効にしたりできる場合があります。 サポート内容や構文は、トレーサーやバージョンによって異なります。 たとえば、トレーサーによっては統一されたグローバル設定に対応しているものもあれば、トレーサー固有の設定を使用するものもあります。
トレーサーごとの詳細については、以下のページを参照してください：
選択した計測機能を無効にする
選択したテクノロジー、ライブラリ、またはプロセスのトレースを削除したい場合は、この方法を使用してください。 特定の統合によって不要なスパンが生成される場合、このアプローチにより取り込み量を大幅に削減できます。
技術別トレースの無効化
Redis、 DynamoDB,、Logging などの特定のテクノロジーのトレースを無効にしたい場合は、このオプションを使用してください。
詳細については、 「計測プラグインの無効化」 を参照してください。
ライブラリごとのトレースを無効にする
特定のインスツルメンテーション・ライブラリ（選択した Couchbase 統合など）を無効にし、それらのソースからのスパン生成を防ぐ場合は、このオプションを使用してください。
詳細については、 「計測プラグインの無効化」 を参照してください。
自動トレースインスツルメンテーションを無効にする
プロセスのコマンドラインオプションや環境変数を使用して、特定のプロセスのトレースを無効にしたい場合に、このオプションを使用します。
詳細については、 「 Java のトレーサー設定」 を参照してください。
ホストレベルでの監視を軽減したい場合は、 「プロセスの無視」 を参照してください。
ホストエージェントモードの変更
インフラストラクチャモードに切り替えると、すべてのトレーサーが無効になり、データ取り込みの最適化に役立ちます。 詳細については、 「エージェントモードの変更」 を参照してください。
プログラムでトレースを無効にする
下流の呼び出しを追跡するかどうかをアプリケーションに判断させたい場合は、プログラムによる抑制を使用してください。 ヘッダーを使用すると X-INSTANA-S 、選択したトレースを表示しないように設定できます。
この設定により、どの呼び出しをキャプチャするかをきめ細かく制御できますが、現時点ではプログラムによる実装が必要です。