本文へスキップ

ISAPIフィルターベースのトランザクション追跡

WhaTapの.NETエージェントは、IISで動作する様々なアプリケーションのトランザクションを追跡できるよう、ISAPIフィルタ機能を提供します。 これにより、ASP、ASP·NET、CGI、ISAPIの拡張など、.NET以外の様々な技術ベースのリクエストまで幅広くモニタリングできます。

注意

ISAPI フィルター機能は、WhaTap .NET エージェント v2.4.0 ~ v2.4.4 以降のバージョンでサポートされています。

インストール

  1. 既存のエージェントインストール案内どおり.NETエージェントをインストールします。

  2. エージェントインストール後whatap_isapi_filter.dllファイルを対象サイトのルートディレクトリにコピーします。

    C:..> copy "C:\Program Files\WhaTap .NET\whatap_isapi_filter.dll" C:\inetpub\yoursite
    • フィルターファイルをIISのウェブサイトが運用されるディレクトリ内にコピーする場合、追加設定は必要ありません。

    • フィルターファイルは必ずしもウェブサイトが運用されるディレクトリ内に存在しなくてもよいが、当該経路及びファイルにIIS_IUSRSグループの読み取りと実行権限が付与される必要があります。

ISAPIフィルター設定

ISAPIフィルターはサーバー全体または個別サイト単位で適用できます。

サーバー全体フィルター適用

IISホスティングされたすべてのウェブサイトのリクエストに対してフィルターを適用するには、次のように設定してます。

サーバー全体フィルター適用

  1. IIS管理者を実行します。

  2. 左側のツリーでサーバーノードを選択します。

  3. 中央領域でISAPIフィルターアイコンをダブルクリックします。

個別サイトフィルター適用

個別サイトのトランザクションをフィルタリングするには、次のように設定します。

個別サイトフィルター適用

  1. IIS管理者を実行します。

  2. 左側のツリーで対象サイトを選択します。

  3. 中央領域でISAPIフィルターアイコンをダブルクリックします。

フィルター項目追加

フィルター項目追加

  1. 右側の作業画面で追加ボタンをクリックします。

  2. フィルター名は自由に指定します。

  3. whatap_isapi_filter.dllファイルを見つけて選択します。

  4. 確認ボタンをクリックします。

ISAPIフィルターが動作しない場合

フィルター設定後も動作しない場合ISAPI及びCGI制限設定を追加する必要があります。

フィルター未動作 sc

  1. IIS管理者の左のツリーでサーバーを選択します。

  2. 中央領域でISAPI及びCGI制限アイコンをダブルクリックします。

  3. 右側の作業画面で追加ボタンをクリックします。

  4. whatap_isapi_filter.dllファイルを選択します。

  5. 項目名を入力します。

  6. 拡張パス実行許可のチェックボックスをチェックします。

  7. 確認ボタンをクリックします。