エージェント機能の制御

Pythonアプリケーションサーバーの機能を制御します。

• enabled Boolean

  既定値 true

  全機能を有効にします。値がfalseの場合でも、サーバーとの最小限の通信を維持するための情報が送信されます。

• counter_enabled Boolean

  既定値 true

  性能カウンターの追跡を有効にします。性能カウンタは、アクティブTX、ユーザー、CPU、メモリ、SQL、外部HTTP呼び出しなどのデータが含まれます。enabledの値がfalseの場合は無視されます。

• stat_enabled Boolean

  既定値 true

  統計情報の追跡を有効にします。5分ごとにトランザクション、SQL Query、外部HTTP呼び出し、User Agent、Client IPなどの統計データが収集されますが、これらの情報の収集が停止されます。 enabledの値がfalseの場合は無視されます。

• active_stack_enabled Boolean

  既定値 true

  アクティブスタックの追跡を有効にします。

  ノート

  counter_enabled値が無効の場合、アクティブTXのデータ収集がされないため、アクティブスタックは収集しません。

• eactive_stack_second Seconds

  既定値10

  アクティブスタックを追跡する間隔を設定します。

  注意

  値を変えないことをお勧めします。

• realtime_user_thinktime_max MiliSeconds

  既定値300000

  リアルタイムユーザーを測定する場合は、同一ユーザーとして認識される最大の呼び出し間隔を指定します。

• time_sync_interval_ms MiliSeconds

  既定値300000

  エージェントとサーバー間の時間の同期サイクルを指定します。同期しない場合は、0を指定します。

• realtime_user_thinktime_max Int

  既定値0

  WhaTapエージェントは、一度送信されたテキストタイプのデータをhash処理するため、翌日まで再送信しません。以前の設定値と異なる値を設定する場合は、再送信します。

  ノート

  トランザクションURL、SQL Stringなどがテキストタイプデータに対応します。

• ignore_instrumentation_set List

  既定値 []（空のリスト）

  自動計測から除外するライブラリまたはカテゴリをカンマ（,）で区切って指定します。エージェント起動時のimport hook登録ステップで、一致する項目をスキップするため、該当ライブラリへの計測自体がインストールされません。特定のライブラリで副作用が生じる場合や、計測対象から除外したい場合に使用します。

  マッチングルールは3種類あり、いずれか1つでも一致した場合、そのライブラリは計測対象から除外されます。

  指定方式	例	効果
  カテゴリ.ライブラリの全キー	database.redis	そのキー1件のみ除外
  カテゴリのみ	database	database.* をすべて除外
  ライブラリ名のみ	redis	その名前に一致するキーを除外

  whatap.conf

  ignore_instrumentation_set=httpx,redis,application.django

  大文字・小文字と前後の空白は正規化されて比較されます。trace_logging_enabledオプションが有効な場合でも、リストにloggingが含まれていればロギング計測は適用されません。

  ノート

  WhaTap Pythonエージェント 0.2.0.3rc1 以上が必要です。