Instana におけるデータ取り込みの最適化

トレースデータを設定およびフィルタリングするには、以下のいずれかの手法を使用できます。

• エラーが発生したスパンについてのみスタックトレースを取得する

  エラーが発生したスパンについてのみスタックトレースをキャプチャすることは、推奨される最初の最適化手順です。これにより、トレースのペイロードサイズとデータ取り込みの総量を大幅に削減しつつ、失敗したスパンに関する重要な診断情報は維持できるからです。 このアプローチでは、正常に完了したスパンに対する不要なスタックトレースを排除することで、信号対雑音比も向上し、トラブルシューティングをより効率的かつ的確に行うことができます。

  言語ごとの設定の詳細については、以下のリソースを参照してください：

  • Java
  • Ruby
  • Python
  • Node.js

• スタックトレースのキャプチャを無効にする

  エラーが発生したスパンにスタックトレースの収集を限定してもデータ量が十分に削減されない場合は、スタックトレースの取得をより広範囲に無効化することができます。 終了スパンおよび中間スパンに対するスタックトレースの収集を無効にすると、トレースのペイロードサイズとデータ取り込み量がさらに削減され、パフォーマンスへのオーバーヘッドが低減される可能性があります。これは、高スループットのアプリケーションや、深いコールスタックを持つサービスにおいて特に有用です。

  言語ごとの設定の詳細については、以下のリソースを参照してください：

  • Java
  • Ruby
  • Python
  • Node.js

• 技術によるトレースを無効化

  Redis、 DynamoDB,、Loggingなどのテクノロジーのトレース機能を完全に無効化することで、スパンの作成を防止し、データ取り込み量を削減できます。 次の例は、あらゆる技術に対するトレースを無効化する方法を示しています：

  com.instana.plugin.javatrace:
   instrumentation:
     plugins:
       Redis: false
       DynamoDB: false
       Logging: false
   

• ライブラリによるトレースを無効にする

  特定の計測ライブラリ（例： Spring、 Couchbase ）を無効化することで、ソースからのスパン生成を防止し、データ取り込み量を削減できます。 以下の例は、この機能を設定する方法を示しています：

  com.instana.plugin.javatrace:
   instrumentation:
     plugins:
       CouchbaseExit: false
       Couchbase3Exit: false
   

  注：Java アプリケーションを再起動し、計測が無効になっていることを確認してください。

• エンドポイントフィルタリング

  Instana サービス間の相互作用をエンドポイントとして可視化し、それらをフィルタリングすることで、価値の低い操作を抑制し、ビジネス上重要なトレースを強調表示します。 これによりダッシュボードのノイズが減少し、どのコマンドやアクションを監視するかを精密に制御できるようになります。 詳細については、 「ホストエージェントのエンドポイントの無視」 および 「 Node.js のエンドポイントの無視」 を参照してください。

  以下の表は、エンドポイントの無視をサポートするトレーサーとパッケージの一覧です：

  サポートされるパッケージ	Node.js	Java	Go	PHP	Python	Ruby	.NET	NGINX
  Redis	✅	✅	❌	❌	✅	❌	❌	❌
  DynamoDB	✅	✅	❌	❌	✅	❌	❌	❌
  Kafka	✅	✅	❌	❌	✅	❌	❌	❌
  HTTP	✅	✅	❌	❌	❌	❌	❌	❌
  Java データベース・コネクティビティー (JDBC) (Java Database Connectivity (JDBC))	❌	✅	❌	❌	❌	❌	❌	❌

  例：エンドポイント除外の設定

  エンドポイントを無視するように設定するには、エージェント com.instana.tracing.ignore-endpoints 設定ファイルのセクションで、監視から除外する必要があるエンドポイントを以下の例のように指定する必要があります：

  com.instana.tracing:
    ignore-endpoints:
  
      # Filtering by Method Name
      redis:
        - 'get'
        - 'type'
      dynamodb:
        - 'query'
      kafka:
        - 'send'
  
     # Filtering by Method Name and Endpoint for Kafka
  
      kafka:
        - methods: ["consume"]
          endpoints: ["topic1", "topic2"] # Exclude consume calls for topic1 and topic2
  
        - methods: ["consume", "send"]
          endpoints: ["topic3"] # Exclude both consume and send calls for topic3
  
        - methods: ["*"]
          endpoints: ["topic4"] # Exclude all methods for topic4
  
        - methods: ["consume"]
          endpoints: ["*"] # Exclude consume method for all topics
  
   

  異なるランタイムやライブラリにフェアユースポリシー（FUP）の原則を適用する方法の詳細については、以下のブログを参照してください：

  • Node.js: のスマートトレース重要なことに集中する

  • Kafka における優先度の低いトレースの除外

  • Java アプリケーションにおけるトレースデータの取り込み削減

• Java アプリケーションにおけるスパン属性に基づくフィルタリング

  Java Tracerのスパンフィルタリング機能を使用すると、属性に基づいて特定のスパンをフィルタリングすることで、 Java アプリケーションのトレースデータ取り込み量を削減できます。 この機能により、データ取り込みコストを最適化し、アプリケーション監視のニーズに最も関連性の高いトレースに焦点を当てることができます。

  Java アプリケーションの場合、 Java トレーサーは、 HTTP および JDBC のスパンに対するフィルタリングをサポートしています。 エージェント configuration.yaml ファイルを通じてフィルタリングルールを設定し、次のような属性に基づいてスパンを除外することができます：

  • HTTP フィルタリング対象 ：URL、 HTTP メソッド、ステータスコード、ヘッダー、クエリパラメータ、およびエラーメッセージ
  • JDBC フィルタリング ：SQL文、データベース接続文字列、およびエラーメッセージ

  例： Java Tracer HTTP および JDBC のスパンフィルタリング設定

  com.instana.tracing:
    filter:
      exclude:
        - name: exclude HTTP health check endpoints
          attributes:
            - key: http.url
              values: [/health, /ping, /ready]
              match_type: endswith
        - name: exclude JDBC queries for audit tables
          attributes:
            - key: jdbc.statement
              values: [audit_log, session_data]
              match_type: contains

  HTTP のスパンを除外すると、すべての子スパンおよび下流のトレースが自動的に抑制されます。 JDBC スパンフィルタリングでは、下流の操作を抑制することなく、データベースのスパンのみを除外します。

  Java のスパンフィルタリングの設定に関する詳細については、 「フィルタリングの設定」 を参照してください。

  Java アプリケーションにおけるspan属性に基づくフィルタリングの詳細については、以下のブログをご覧ください：

  • JDBC およびHCの可観測性最適化： Instana による低優先度トレースのフィルタリング

• ホストエージェントモードを変更する

  インフラストラクチャモードに切り替えると、すべてのトレーサーが無効化され、必要に応じてデータ取り込みの最適化に役立ちます。 詳細については、 「エージェントモードの変更」 を参照してください。

• X-INSTANA-Sヘッダーの使用

  下流アプリケーションフロー にX-INSTANA-Sヘッダー を含めることで、特定のトレースを選択的に抑制できます。 この設定により、どの呼び出しをキャプチャするかを細かく制御できますが、現時点ではプログラムによる実装が必要です。

• 自動トレース計測を無効にする

  Java アプリケーションでは、プロセスコマンドラインオプションまたは環境変数を使用して特定のプロセスに対するトレースを無効化でき、これにより計測対象を意図的に制御することが可能となります。 詳細については、 「 Java トレース計測の無効化」 を参照してください。

以下の表は、特定の種類のセンサーで摂取量が高くなる理由を説明しています：

メッセージングシステムは通常、大量のトランザクションとエンティティを処理するため、必然的に膨大なデータが生成される。 同様に、幅広いエンティティと多様なメトリクスを監視するセンサーは、データ取り込み量の増加に寄与する。 これを緩和するため、一部のセンサーでは設定ファイル内で正規表現の使用をサポートしており、チームが監視対象エンティティをフィルタリングし、その数を制限できるようにしています。

• エンティティ・フィルタリング

  設定ファイルで正規表現を使用することで、エンティティのサブセットのみを監視できます。

• ポーリングレートの調整

  ポーリング間隔の設定が可能なセンサーについては、頻度を調整することでデータ量を削減できます。 ポーリング間隔の設定に関する詳細については、以下の設定セクションを参照してください：

  • Kubernetes 向け
  • Prometheus 向け

• クラウド管理サービス ( AWS, Azure, GCP )

  クラウドタグを使用して、監視対象からマネージドサービスインスタンスを選択的に含めたり除外したりできます。 以下の例はクラウドタグの使用方法を示しています：

  com.instana.plugin.aws.rds:
   include_tags: # Comma separated list of tags in key:value format (For example, env:prod,env:staging)
   

  com.instana.plugin.aws.rds:
   exclude_tags: # Comma separated list of tags in key:value format (For example, env:dev,env:test)
   

• 選択的監視

  Instana どのプロセスやコンテナを監視するかを制御するための、オプトインおよびオプトアウトの仕組みをサポートしています。 デフォルトでは、エージェントはオプトアウトモードで動作します。 が INSTANA_SELECTIVE_MONITORING 設定されていないか、 OPT_OUTに設定されている場合、エージェントは明示的に除外しない限り、すべてのプロセスを監視します。

  • プロセスおよびコンテナレベルの制御

  設定を使用して、特定のプロセスやコンテナを監視対象に含めるか除外することができます。 詳細については、 「 Instana の選択的監視」 を参照してください。

  モニター・モード	説明	エージェント環境	プロセス環境	結果
  オプトアウト	デフォルトで監視されるすべてのプロセス	未設定、またはINSTANA_SELECTIVE_MONITORING=OPT_OUT	設定なし	プロセスは監視される
  オプトアウト	デフォルトで監視されるすべてのプロセス	未設定、またはINSTANA_SELECTIVE_MONITORING=OPT_OUT	INSTANA_MONITORING=false	そのプロセスは無視される
  オプトイン	デフォルトではプロセスは監視されません	INSTANA_SELECTIVE_MONITORING=OPT_IN	設定なし	そのプロセスは無視される
  オプトイン	デフォルトではプロセスは監視されません	INSTANA_SELECTIVE_MONITORING=OPT_IN	INSTANA_MONITORING=true	プロセスは監視される

  • Kubernetes 名前空間ラベル（名前空間のオプトアウトおよびオプトイン用）

  Instana Kubernetesinstana-workload-monitoring ネームスペースレベルでラベルを使用してワークロード監視を制御できます。 このラベルは、名前空間が監視対象に含まれるか除外されるかを決定します：

  • instana-workload-monitoring=false → オプトアウト: ネームスペース内のすべてのワークロードで監視が無効化されます。
  • instana-workload-monitoring=true → オプトイン: ネームスペース内のワークロードに対して監視が有効化されます。