使用 Web 服務 › 如何建立自訂度量系列 › 建立自訂度量系列 XML 檔 › 新增 <AttributeList> 區段

新增 <AttributeList> 區段

<AttributeList> 區段定義要對於度量系列收集的配置或效能度量。 即使裝置類型有許多屬性，也請仔細審酌哪些屬性對於監控基礎結構而言相當重要。 屬性資料的三種常見用途如下所示：

• 報告—這些屬性值會經常變更。 一般而言，在每個週期都會輪詢這些值，以提供用於報告中且隨時間變化的暫時值。 範例包括輸入/輸出位元組、頻寬及 CPU 或記憶體使用率。
• 配置—這些屬性提供識別項目的資料。 這些資料很少變更。 因此，一般只有在搜索時才會收集這些資料 (也就是，每個週期不會輪詢這些資料)。 範例包括名稱、說明及 ID。
• 重新調整—這些屬性的目的是偵測您的環境中出現的配置變更。 偵測到的變更會觸發搜索，以確保 Data Aggregator 資料正確無誤。

各個屬性可包含下列索引標籤：

<Name>

屬性的唯一內部名稱 (使用完整名稱格式)。

<Description>

這個文字在 CA Performance Center 檢視中會顯示為工具提示。

<AttributeDisplayName>

這個標記決定如何在報告和 CA Performance Center 儀表板中識別您的屬性。

<Type>

屬性的資料類型。 最常用的類型是 Integer、Long、Double、String 或 ObjectID。

<Polled>

設定為 True 時，Data Aggregator 將在各個輪詢週期收集這些度量資料。 設定為 False 時，則只有在搜索項目時收集這些資料。

<IsList>

這個屬性提供純量或表格資料。 考慮下列定義：

• 純量屬性—這些屬性一次傳回連同裝置資料儲存的一個值。 例如，「現行程序數」傳回一個值。
• 表格屬性—這些屬性傳回表格中各列的一個值。 範例程序度量系列使用表格屬性。 各列對應於一個程序項目。

附註：如果此索引標記對於屬性為 True，則必須對於同一個屬性清單中的各個屬性設定為 True。 在此情況下，必須在清單中定義「索引」(ObjectID 類型) 及「名稱」(String 類型) 屬性。

<IsDbColumn>

此標記表示屬性值儲存在資料庫表格中。 對於配置度量，請將此索引標籤設定為 False。

<RollupStrategy>

此標記指定計算個別輪詢值的總和或平均。 將 <Polled> 及 <IsDbColumn> 設定為 True 時，需要此索引標籤。

<Baseline>

設定為 True 時，將計算此屬性的基準，而且您可以在 <BaselineList> 區段中新增對應的基準定義。

包含 <RollupStrategy> 或將 <Baseline> 設定為 True 時，也需要下列索引標籤：

基準

指出是否計算此屬性的基準。 如果設定為 True，對應的 BaselineList 定義必須存在。

最大值

指出是否在彙總期間計算此屬性的上限。 在資料庫表格中建立「max_」欄。

最小值

指出是否在彙總期間計算此屬性的下限。 在資料庫表格中建立「min_」欄。

差異

指出是否在彙總期間計算此屬性的變異數。 在資料庫表格中建立「var_」欄。

StandardDeviation

指出是否在彙總期間計算此屬性的標準變異數。 在資料庫表格中建立「std_」欄。

RollupStrategy

指定彙總個別輪詢的值期間執行各個週期的作業。 此值可以是計算總和或平均的「Sum」或「Avg」。

<Filterable>

這個標記表示屬性可用於監控設定檔篩選。 套用篩選器時，具有此標記的屬性即可供篩選運算式使用。

附註：如需有關各個 XML 標記的詳細資訊，請參閱 MetricFamily.xsd 及 Component.xsd 檔案中提供的內嵌文件。 如需程式碼範例，請參閱 ProcessInfoMFWithComponent.xml 檔案。 此範例檔案定義收集程序度量的度量系列。

更多資訊：

建立自訂度量系列 XML 檔

AttributeList

[屬性清單] 列出所收集的屬性並儲存在資料庫表格中。 下列資訊說明 AttributeList 區段中使用的元素：

名稱

指定將資料庫欄命名所用的唯一內部名稱。 名稱是以 QName 格式所指定：

{URI}FamilyName.AttrName

附註：此名稱不會對外公開。 若要在使用者介面中顯示屬性名稱，請使用 AttributeDisplayName 元素。

AttributeDisplayName

指定運算子及管理員介面中出現的值。 AttributeDisplayName 可本地化為多種語言。

說明

在使用者介面中顯示屬性說明。 將游標停留在屬性名稱上方時，工具提示也將顯示說明。

類型

指出此屬性的資料類型。 最常用的資料類型是 Integer、Long、Double、String 或 ObjectID。

Polled

指出是否輪詢屬性。 如果設定為 False，則只有在搜索期間存取屬性。

IsList

如果設定為 True，將從表格擷取屬性。 對於表格中的各列，也將建立元件項目。

附註：對於任何屬性，將此內容設定為 True 時，對於資料庫中儲存的度量系列各個屬性，將內容設定為 True。

IsDbColumn

將其值儲存於資料庫表格中。 IsDbColumn 一般用於各個週期輪詢的屬性，並包含在報告中。

附註：如果不使用 ProcessInfoMFWithComponent.xml，但是已經從 http://host:port/genericWS/metricfamilies/<name> 下載 XML 檔開始使用度量系列，請刪除 RollupExpression 及 Units 節點，因為這些已被取代。

一般屬性

在下圖中，任何度量系列均存在 Indexes、Names 及 Descriptions 屬性：

任何支援的廠商憑證均可提供度量系列所公開的 URI，例如：

{http://im.ca.com/normalizer}Name.Indexes

{http://im.ca.com/normalizer}Name.Names

{http://im.ca.com/normalizer}Name.Descriptions

簡單屬性

在下圖中，對於大多數屬性，此值僅儲存於資料庫中。 不會執行其他任何處理，例如基準的評估。

支援的廠商憑證必須提供一些度量系列公開的 URI，格式如下：

{http://im.ca.com/normalizer}Name.AttributeName