Java Agent の名前付け › エージェント自動名前付け

エージェント自動名前付け

エージェント自動名前付け機能が有効になっている場合、エージェントは、起動時にアプリケーション サーバからの名前情報を検索します。 エージェントは、エージェント名を取得してから Enterprise Manager に接続します。

エージェントが名前付けに必要な情報を見つけると、Introscope は、その情報を編集して、エージェント名をエージェント名前付け規則に準拠させます。

サポートされているアプリケーション サーバでのエージェント名は、いくつかの情報の要素から構成され、それらはアプリケーション サーバごとに異なります。

• JBoss の場合、エージェント名はサーバの起動時に指定される設定名に基づいています。
• WebLogic の場合、エージェント名は以下のようになります。

  ドメイン（データ センター） + クラスタ + （WLS の）インスタンス

• WebSphere の場合、エージェント名は以下のようになります。

  セル（ドメイン） + プロセス（WAS のインスタンス）

情報が取得されると、セグメントは、以下の例のようにスラッシュで区切られます。

medrec/MyCluster/MedRecServer

個々のセグメントの名前に含まれるスラッシュはすべて下線に変換されます。 たとえば、ドメインの名前が Petstore/West である場合は、Petstore_West と変換されます。

注： Introscope は、以下の規則に従って、エージェント名の作成に使用される情報を編集します。

• パイプ、コロン、パーセンテージ記号などの文字は、下線に置き換えられます。
• 英字以外の文字で始まる名前には、先頭に「A」が追加されます。
• 空の名前は、「UnknownAgent」である状況と区別するために「UnnamedAgent」に置き換えられます。

エージェント自動名前付け機能を有効にする方法

1. IntroscopeAgent.profile で、introscope.agent.agentAutoNamingEnabled を true に設定します。
2. 以下のアプリケーション サーバ固有の変更を行います。
   • WebLogic の場合、Introscope 起動クラスを作成します。 「WebLogic 用の起動クラスの設定」を参照してください。
   • WebSphere の場合、Introscope カスタム サービスを作成します。 「WebSphere でのカスタム サービスの設定」を参照してください。
   • JBoss の場合、XML ファイルを作成します。 「JBoss の設定」を参照してください。