使用 Java API 來監視資料

您可以定義資料來源，使用 Java™ API 與 Java 平台上長時間執行的應用程式互動。 代理程式在啟動時啟動應用程式，並定期與它進行互動。 當您建置代理程式時，Agent Builder 會建立應用程式的原始碼。 您必須自訂程式碼，以收集正確的資料。 根據程式碼，資料來源可以產生多個資料集，其中可以包含單一列、多列或事件資料。

1. 在「代理程式起始資料來源」頁面或「資料來源位置」頁面上，按一下監視資料種類區域中的自訂程式。
2. 在資料來源區域中，按一下 Java API。
3. 按下一步。
4. 在 Java API 資訊頁面上，輸入屬性群組名稱。
5. 輸入屬性群組的說明文字。
6. 選取這個屬性群組是產生單一資料列、可產生多個資料列還是產生事件。 此選擇將會影響精靈結束時建立的範例 Java 應用程式。 如需相關資訊，請參閱正在傳送資料。
7. 選擇性的： 按一下進階，以修改此屬性群組的進階內容。 當您選取屬性群組為可產生多個資料列或產生事件時，進階可用。
8. 按下一步。
9. 在「屬性資訊」頁面上，指定此屬性群組的第一個屬性。 如需關於建立屬性的資訊，請參閱建立屬性。
10. 選取新增其他屬性，並按一下下一步以新增其他屬性至代理程式。 對屬性的參照將會併入精靈結束時建立的範例 Java 應用程式中。
11. 按下一步。
12. 在廣域 Java API 資料來源資訊頁面上，輸入類別名稱及 JAR 檔名稱。

    類別名稱是完整的類別名稱，Java 啟動時會呼叫其 main 方法。 範例 Java 應用程式是使用此類別中的 main Java 方法而建立。

    JAR 檔是一種保存檔，內含組成 Java 應用程式的 Java 類別。 JAR 檔會與代理程式一起包裝並安裝。

13. 選擇性的： 在「廣域 Java API 資料來源資訊」頁面上的錯誤碼區段中，定義 Java 應用程式可以傳送的錯誤碼。 這些錯誤碼由 Java 應用程式在無法收集資料時傳送。
    限制： 錯誤碼限制為 256 個字元。 只允許 ASCII 字母、數字及底線。 不接受空格。
    1. 在「錯誤碼」區段中，按一下新增。
    2. 在 Java API 錯誤碼定義視窗中，輸入顯示值。
    3. 輸入內部值。 內部值必須是從 1,000 至 2,147,483,647 的整數。
    4. 針對每一個錯誤定義訊息文字。 您可以透過從清單中選取之前輸入的訊息文字，來使用該訊息文字。 按一下確定，以回到廣域 Java API 資料來源資訊頁面。
       此訊息會記載在代理程式日誌檔中。
    5. 如果沒有合適的可用訊息文字，請按一下瀏覽以設定訊息文字。
       Messages（清單）視窗即會顯示。 訊息視窗會列出代理程式中定義的訊息。 在定義訊息之前，此清單保持為空白。 您可以使用編輯來變更已定義的訊息，並可以使用移除來刪除一則以上已定義的訊息。
    6. 在「訊息」（清單）視窗中，按一下新增以查看「訊息定義」視窗。 在「訊息定義」視窗中，您可以鍵入文字以說明新訊息的意義，並選取訊息類型。
       註： 訊息 ID 會自動產生。
    7. 按一下確定。
    8. Messages（清單）視窗即會顯示，其中含有新訊息。 若要驗證該訊息並回到「廣域 Java API 資料來源資訊」頁面，請按一下確定。
14. 選擇性的： 在廣域 Java API 資料來源資訊頁面的補充檔案區段中，可以新增檔案，這些檔案會與代理程式一起包裝並在代理程式安裝時複製至代理程式系統。 Java 提供者用戶端 API JAR 檔不在這裡列出；它會自動複製到代理程式系統。 檔案類型直欄說明每一個檔案的預期用途。 三種可能的用途在下表（表 1）中說明。 按一下編輯可以編輯所匯入的檔案。 如需相關資訊，請參閱編輯指令檔定義。

    表 1. 補充檔案的檔案類型

    檔案類型	說明
    執行檔	如果您想要將執行檔併入代理程式，請選取此選項。 代理程式不使用此檔案，但此檔案將位於路徑中，以供 Java 應用程式使用。
    程式庫	如果您想要將程式庫併入代理程式，請選取此選項。 代理程式不使用此檔案，但此檔案將位於程式庫路徑中，以供 Java 應用程式使用。
    Java 資源	選取此選項以將 Java 資源併入代理程式。 代理程式不使用此檔案，但此檔案將位於類別路徑中，以供 Java 應用程式使用。

    註： 當 Java 資源補充檔案新增至 Agent Builder 時，會自動新增至專案類別路徑中。 Java 編譯器使用此補充檔案，來解析程式碼中對資源類別的任何參照。

    如需補充檔案隨代理程式一起安裝於何處的相關資訊，請參閱系統上的新檔案。
15. 選擇性的： 建立過濾器，以限制此屬性群組所返回的資料（如果對資料進行取樣的話）。 您可以透過按一下進階建立過濾器。
    註： 如果在「Java API 資訊」頁面上未選取產生事件，則會對資料進行取樣。

    如需對來自屬性群組的資料進行過濾的相關資訊，請參閱過濾屬性群組。
16. 選擇性的： 新增配置內容至子節點。
    如果您正將此資料來源新增至子節點，則會顯示「子節點配置置換」頁面，因此您可以新增配置內容至該子節點。 在該子節點下至少需要一個配置內容，這樣才能建立範例 Java 應用程式。 至少需要一個配置內容，因為範例是使用配置內容使子節點實例相互區別。
17. 執行下列其中一個步驟：
    1. 如果您正在使用「代理程式」精靈，請按下一步。 視需要完成精靈。
    2. 否則，請按一下完成，以儲存該資料來源並開啟「代理程式編輯器」。 然後，在主功能表中，選取檔案 > 儲存。
    此時，Agent Builder 會建立監視應用程式的原始碼。 該程式碼位於專案目錄的 src 子目錄中。 請編輯此程式碼，以建立您的監視應用程式。