JMX 配置

當您在代理程式中定義 JMX 資料來源時，即會為您建立部分配置內容。

JMX 執行時期配置是唯一的，因為它可讓您對顯示多少配置進行部分控制。 代理程式的 JMX 用戶端可以連接至數個不同類型的應用程式伺服器。 但是，在任何一個代理程式中，不是非得支援所有這些類型的應用程式伺服器。 您可以判定要支援的應用程式伺服器類型，而不在代理程式中併入那些不必要的配置區段。

在大部分情況下，代理程式是設計成監視一種 JMX 應用程式伺服器類型。 當您建立 JMX 資料來源時，可以使用「JMX 瀏覽器」。 當您使用「JMX 瀏覽器」時，用於瀏覽 MBean 伺服器的 JMX 伺服器配置選項會自動新增至代理程式。 若要在建立代理程式之後，變更您可以連接的應用程式伺服器類型，請按一下「JMX 資訊」區域中的廣域 JMX 選項。 在「JMX 代理程式層面選項」頁面中，變更您想要的任何選項。

您可以設計一般代理程式，以監視多種類型的 JMX 應用程式伺服器。 在此情況下，可以在「JMX 代理程式層面選項」頁面上選取多個 JMX 伺服器配置選項。 當支援多個 JMX 連線類型時，執行時期配置會提示您可用於該代理程式實例的連線類型。
註： 一個代理程式的實例只能連接至一種類型的 JMX 應用程式伺服器。 子節點可以用來連接至代理程式實例內同一類型的不同 JMX 應用程式伺服器。 若要連接至多種類型的 JMX 應用程式伺服器，您必須對每種 JMX 應用程式伺服器類型配置至少一個代理程式實例。

您可以使用「代理程式編輯器」來檢視、新增及變更配置內容。 如需相關指示，請參閱使用「代理程式編輯器」變更配置內容。 如果 JMX 資料來源是在子節點中定義，則您亦可以指定「子節點配置置換」。 如需相關指示，請參閱子節點配置。

如果您在代理程式中定義 JMX 資料來源，則該代理程式必須使用 Java™ 來連接至 JMX 應用程式伺服器。 Java 配置內容會自動新增至代理程式。

下列 Java 配置內容特定於代理程式執行時期配置：
Java 起始目錄
指向 Java 安裝目錄的完整路徑

將代理程式配置成使用您所監視之應用程式使用的相同 JVM，特別是針對「WebLogic 伺服器」及 WebSphere® Application Server。

JVM 引數
指定 Java 虛擬機器的引數選用清單。
追蹤層次
定義要寫入 Java 追蹤檔的資訊量。 預設為僅將「錯誤」資料寫入日誌檔。
註： Agent Builder 不需要這些內容，因為它使用自己的 JVM 及記載（透過 JLog 外掛程式進行配置）。
如果您在代理程式中定義 JMX 資料來源，則下列所需的共用配置欄位會自動新增至該代理程式：
連線
MBean 伺服器的連線類型
使用者 ID
用來向 MBean 伺服器進行鑑別的使用者 ID。
密碼
使用者 ID 的密碼。
基本路徑
用於在其中搜尋類別路徑中所指定 JAR 檔的目錄，或者是 JAR 目錄中指定的目錄（不完整目錄）。 目錄名稱在 Windows 上以分號 (;) 區隔，在 UNIX 系統上，以分號 (;) 或冒號 (:) 區隔。
類別路徑
代理程式要搜尋之明確指定的 JAR 檔。 任何不完整的 JAR 檔名稱都會附加至每一個「基礎路徑」，直到找到該 JAR 檔為止。
JAR 目錄
在其中搜尋 JAR 檔的目錄。 目錄名稱在 Windows 上以分號 (;) 區隔，在 UNIX 系統上，以分號 (;) 或冒號 (:) 區隔。 這些目錄中的 JAR 檔無需明確識別；找到它們是因為它們位於這些目錄的其中一個目錄中。 系統不會搜尋這些目錄的子目錄。 任何不完整的目錄名稱都會附加至每一個「基礎路徑」，直到找到該目錄為止。
註： 對於遠端監視，JAR 檔及其所有相依 JAR 檔都必須本端安裝在代理程式執行所在的電腦上。 這些 JAR 檔即是連接至所監視之應用程式所需的檔案。 這些 JAR 檔必須在 JAR 目錄中，以及基本路徑與類別路徑中配置。 此外，在本端安裝您要監視之應用程式的受支援 JVM，並在 Java 起始目錄配置欄位中指定路徑。

範例：

  • 若為 WebLogic 10，類別路徑為 server/lib/wlclient.jar;server/lib/wljmxclient.jar。 基礎路徑會指向在其中找到 server/lib 目錄的 WebLogic 應用程式伺服器目錄。
  • 對於 WebSphere，基礎路徑會指向 WebSphere Application Server 安裝所在的位置。 此範例中會列出多個基礎路徑，以提供 Windows 及 UNIX 的預設路徑。 類別路徑會列出相對於基礎路徑的 JAR 檔。 JAR 目錄欄位的相對值 lib 會導致載入基礎路徑下此目錄中的所有 JAR 檔。
    • 基本路徑：C:\Program Files\IBM\WebSphere\AppServer;/opt/IBM/WebSphere/AppServer
    • 類別路徑：runtimes/com.ibm.ws.admin.client_6.1.0.jar;plugins/com.ibm.ws.security.crypto_6.1.0.jar
    • JAR 目錄：lib
視在「JMX 代理程式層面選項」頁面中選取的 JMX 伺服器類型而定，會新增下列部分或所有配置內容。 預設值由 Agent Builder 提供，且可以修改：
JSR-160 相符伺服器連線特定配置內容：
JMX 服務 URL
連接以進行監視的「JMX 服務」URL。
WebSphere Application Server 6.0 版以及更新版本連線特定配置內容：
主機名稱
您要監視之應用程式伺服器所在的系統主機名稱。 對於本端監視，該名稱為本端系統名稱。 對於遠端監視，該名稱為應用程式伺服器所在之系統的主機名稱。
埠
在要監視的主機名稱上使用的埠號。
連接器通訊協定
監視連線要使用的連接器通訊協定。 支援 RMI 及 SOAP。
設定檔名稱
用於配置連線的設定檔名稱。
JBoss Application Server（非 JSR-160）連線特定配置內容：
JNDI 名稱
用來查閱 MBean 伺服器的 JNDI 名稱。
提供者 URL
連接以進行監視的 JMX 服務提供者 URL。
WebLogic 伺服器連線特定配置內容：
服務 URL
連接以進行監視的 JMX 服務提供者 URL，包括 JNDI 名稱。
註： 如果啟用 WebSphere 管理安全，則您必須確保在適當的用戶端連線內容檔中，已停用用戶端登入提示。 對於 RMI 連線，若要防止用戶端提示使用者，您必須在 WebSphere Application Server 的設定檔內容目錄中，修改 sas.client.props 檔案中的 com.ibm.CORBA.loginSource 內容。 對於 SOAP 連線，則必須修改同一目錄中 soap.client.props 檔中的 com.ibm.SOAP.loginSource 內容。 在這兩種情況下，都必須將 loginSource 內容設為不包含值。

您可以使用「代理程式編輯器」來檢視、新增及變更配置內容。 請參閱（使用「代理程式編輯器」變更配置內容）。 如果 Windows 資料來源是在子節點中定義，則您亦可以指定「子節點配置置換」。 請參閱子節點配置。