Introscope SQL エージェントの設定 › SQL ステートメントの正規化 › SQL ステートメントの正規化オプション › カスタム SQL ステートメント ノーマライザ

カスタム SQL ステートメント ノーマライザ

SQL エージェントでは、カスタムの正規化を実行するための拡張を追加できます。 これを行うため、SQL エージェントによって実装されている正規化スキーマを含む JAR ファイルを作成します。

SQL ステートメントのノーマライザ拡張を適用する方法

1. 拡張 JAR ファイルを作成します。

   注： SQL ノーマライザ拡張ファイルのエントリ ポイント クラスは、com.wily.introscope.agent.trace.ISqlNormalizer インターフェースを実装している必要があります。

   JAR 拡張ファイルの作成には、SQL ノーマライザ拡張用の特定のキーを含むマニフェスト ファイルの作成が含まれます。これについては、以下の手順 2 で詳しく説明します。 ただし、拡張を動作させるためには、その他の一般キーも必要です。 これらのキーは、すべての拡張ファイルを作成するときに使用するタイプです。 作成する拡張ファイルは、データベース SQL ステートメント テキスト正規化、たとえば Backends|{backendName}|SQL|{sqlType}|{actualSQLStatement} ノードの下のメトリックと関連します。 {actualSQLStatement} は、SQL ノーマライザによって正規化されます。

2. 作成した拡張のマニフェストに、以下のキーを配置します。
   • com-wily-Extension-Plugins-List:testNormalizer1

     注： このキーの値は任意です。 このインスタンスでは、例として testNormalizer1 が使用されています。 このキーの値として指定するものはすべて、以下のキーでも同様に使用してください。

   • com-wily-Extension-Plugin-testNormalizer1-Type: sqlnormalizer
   • com-wily-Extension-Plugin-testNormalizer1-Version: 1
   • com-wily-Extension-Plugin-testNormalizer1-Name: normalizer1

     ノーマライザの一意の名前を含んでいる必要があります。たとえば normalizer1 となります。

   • com-wily-Extension-Plugin-testNormalizer1-Entry-Point-Class: <Thefully-qualified classname of your implementation of ISQLNormalizer>
3. 作成した拡張ファイルを、<Agent_Home>/wily/core/ext ディレクトリに配置します。
4. IntroscopeAgent.profileで、以下のプロパティを配置および設定します。

   introscope.agent.sqlagent.normalizer.extension
   

   作成した拡張のマニフェスト ファイルからプロパティを com-wily-Extension-Plugin-{plugin}-Name に設定します。 このプロパティの値は大文字と小文字を区別しません。 例：

   introscope.agent.sqlagent.normalizer.extension=normalizer1
   

   重要： これはホット プロパティです。 拡張名を変更すると、拡張を再登録する必要があります。

5. IntroscopeAgent.profile で、オプションで以下のプロパティを追加してエラー スロットル カウントを設定できます。

   introscope.agent.sqlagent.normalizer.extension.errorCount
   

   エラーおよび例外の詳細については、「例外」を参照してください。

   注： カスタム ノーマライザ拡張によってスローされたエラーがエラー スロットル カウントを超えたとき、拡張は無効となります。

6. IntroscopeAgent.profile を保存します。
7. アプリケーションを再起動します。