本文へスキップ

リリースノート

最新バージョン v0.2.7​


2025-09-02

v0.2.7

Feature Span データを順次処理するオプションを追加

  • Trace データの scopespan を処理する際、Span.Kind = KIND_SERVER は WhaTap のトランザクションとして処理
  • 従来: 1つのリクエスト内の複数の KIND_SERVER span を集約し最後に処理
  • オプション有効時は Span を順次処理
    • otel_tx_process_server_span_in_order_enabled
    • デフォルト: false

2025-09-01

v0.2.6

Change Span データの処理方式を改善

  • 親子のツリー構造で Span データを収集
  • 途中の親 Span が欠落していても、後続の子 Span を処理するように変更

Change 属性キー名を追加

  • HTTP ステータスコードを収集する属性キー名 http.response.status_code を追加

    • otel_attr_tx_status_keys
      • デフォルト: http.status_code, http.response.status_code
  • エラー情報を収集する属性キー名 error を追加

    • otel_attr_error_keys
      • デフォルト: error, error.type

2025-07-09

v0.2.5

Feature Parent のない Span をトランザクションとして認識

  • Parent がない Span は kind に関係なくトランザクションとして処理
  • 従来は SPAN_KIND_SERVER のみトランザクションとして処理
  • 関連オプション: otel_tx_root_span_enabled (デフォルト: true)

Feature メトリクス収集方式を改善

  • ログベース収集から Prometheus 互換方式へ変更
  • Flex ボード(MXQL データ照会)で確認可能

Change query_string_enabled オプションの動作を変更

  • query_string_enabled が true で、query_string_urls と query_string_keys が未設定の場合、
    すべての URL のクエリ文字列を収集

Fixed HTTP Status カウンタ収集の不具合を修正

  • 500 番台エラーの合算値が収集されない問題を修正

2025-04-30

v0.2.4

Feature HTTP Status エラーの表示

  • HTTP ステータスコードが 400 以上の場合にエラーとして表記する設定

    • Key: transaction_status_error_enable
    • Type: bool
    • Default: false
    • 収集間隔: 10秒

Feature HTTP Status Code 統計の収集

  • 全 URL のステータスコード別件数を収集する設定

    • Key: tx_status_meter_enabled
    • Type: bool
    • Default: true
    • 収集間隔: 10秒
  • URL 別のステータスコード件数を収集する設定

    • Key: stat_txstatus_enabled
    • Type: bool
    • Default: true
    • 収集間隔: 5分

Feature 分散トレース用に HTTP call の仮想 span を設定して解析追跡

  • HTTP call の span 情報がない場合に仮想 span を有効化

    • Key: otel_virtual_httpc_enabled
    • Type: bool
    • Default: false
  • HTTP call の span 情報がない場合の名称設定

    • Key: otel_virtual_httpc_name
    • Type: string
    • Default: external http call

Fixed HTTP Method 無視設定の不具合を修正

  • PATCH、OPTIONS、HEAD、TRACE メソッドはトランザクションとして収集しない

2025-02-25

v0.2.3

Feature Span の name をトランザクション名として指定するオプションを追加

  • otel_tx_path_setby_name_enabled bool (デフォルト false)

Feature Trace Span の SpanID を外部接続の ParentSpanID として認識するマルチトランザクション連携オプションを追加

  • otel_mtrace_stepid_setby_trace_spanid_enabled bool (デフォルト false)

Feature ファイルログと同一内容を Stdout に出力するログオプションを追加

  • log_stdout_enabled bool (デフォルト false)

Fixed whatap.conf が存在しない場合に "ファイルが見つかりません" エラーログが繰り返し出力される問題を修正

Fixed トランザクション ID が 0 と表示される問題を修正

2024-12-11

v0.2.2

Feature トランザクションの URL と URI 情報を分離して処理

従来 URL と表記していた項目は URI として表記します。

Feature 外部 HTTP 呼び出しの URL 表記を "Host:Port" に変更

Feature Kong gateway に関する情報を抽出する属性キーをデフォルト設定に追加

2024-11-06

v0.2.1

Fixed 予期しない内部 panic によりデータ処理 goroutine が停止する問題を修正

Fixed 不要なログの削除および整理

2024-06-19

v0.2.0

New Linux aarch64 をサポート

New span events から追加のエラー情報を収集

  • エラー内容が attribute ではなく event として流入する場合に収集します。

  • event からエラーを検出するためのエージェント設定オプションを追加してください。

    whatap.conf
    otel_events_exception_keys=exception.type
    otel_events_error_message_keys=exception.message
    otel_events_error_stack_keys=exception.stacktrace
    otel_events_error_esc_keys=exception.escaped

Changed 従来の paramkey.txt の代わりに security.conf を使用

既存の security.conf の paramkey キーの値を使用します。デフォルトをランダム値から WHATAP に変更しました。WHATAP に設定すると、キー入力なしで復号できます。

Changed SQL 正規化オプション設定を変更

  • SQL 文のパラメータ分離・正規化を常に有効化します。trace_sql_normalize_enabled を常に true に設定してください。

  • 既に正規化を無効化している場合は、正規化してパラメータを別記録する設定を有効化してください。

    • profile_sql_param_enabled を true に設定
    • 正規化したパラメータは個別に暗号化して収集
    • security.conf の paramkey で復号して確認可能