使用率子系統
使用率子系統中的服務可提供執行統計資訊。使用此子系統中的服務時可以取得以下資訊：
• 服務爭用執行所花費的時間 (最小時間、最大時間與平均時間)
• 服務執行的次數
• 因逾時而終止的 JavaScript 服務與訂閱。請參閱下面
因逾時而終止之指令集執行的相關統計資訊部份的內容。
統計資訊會從上次重新啟動伺服器時開始記錄，但可以啟用「啟用統計資訊持續性」選項進行持續記錄 (以毫秒計)。透過使用 WriteStatisticsReport 服務，可將包含這些統計資料的 CSV 檔案寫入至 ThingworxStorage 資料夾。
 |
僅針對已完成的服務提供統計資訊。如果服務尚未完成執行，則不會包含在統計資訊中。
|
|
參數
|
預設值
|
描述
|
||
|---|---|---|---|---|
|
「啟用統計資訊」
|
false
|
啟用時，平台會收集統計資訊。停用時，服務不會傳回統計資訊。
|
||
|
「啟用實體名稱彙總」
|
true
|
如果多個實體使用相同的服務，會顯示服務的彙總統計資訊。
|
||
|
「顯示百分位數」
|
false
|
在組態表中顯示百分位數的其他統計資訊。
|
||
|
「啟用統計資訊持續性」
|
false
|
啟用時，伺服器將重新啟動，所有執行時間統計資訊將會保留。平台重新啟動之後，會保留資料。
|
UtilizationStatistics 服務
|
服務
|
描述
|
||
|---|---|---|---|
|
GetAuthenticationStatistics
|
傳回有關每個指定驗證類型進行多少次驗證以及驗證是成功還是失敗的資料。驗證類型包括表單登入、HTTP 基本、應用程式索引鍵、SSO 和自訂驗證器。
|
||
|
GetEntityServiceStatistics
|
傳回每個實體服務執行計數的最小值、最大值、平均值。
|
||
|
GetEntityStatistics
|
傳回 GetEntityServiceStatistics 與 GetEntitySubscriptionStatistics 服務中統計資訊的組合。
|
||
|
GetEntitySubscriptionStatistics
|
傳回對實體事件執行訂閱的時間統計資訊 (最小時間、最大時間、平均時間、總時間)。
|
||
|
GetStatistics
|
傳回 GetEntityServiceStatistics、GetEntitySubscriptionStatistics 與 GetAuthenticationStatistics 服務中的所有統計資訊。包括最小時間、最大時間、平均時間和每個已執行服務的計數。
|
||
|
ResetAuthenticationStatistics
|
重設驗證統計資訊。
|
||
|
ResetEntityServiceStatistics
|
重設實體服務統計資訊。
|
||
|
ResetEntityStatistics
|
重設實體統計資訊。
|
||
|
ResetStatistics
|
重設所有統計資訊。
|
||
|
ResetEntitySubscriptionStatistics
|
重設實體的訂閱統計資訊。
|
||
|
WriteAuthenticationStatisticsReport
|
將唯一命名的 CSV 檔案寫入下列位置：ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntityServiceStatisticsReport
|
將唯一命名的 CSV 檔案寫入下列位置：ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntityStatisticsReport
|
將唯一命名的 CSV 檔案寫入下列位置：ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteEntitySubscriptionStatisticsReport
|
將唯一命名的 CSV 檔案寫入下列位置：ThingworxStorage/reports/UtilizationStatistics
|
||
|
WriteStatisticsReport
|
將唯一命名的 CSV 檔案寫入下列位置：ThingworxStorage/reports/UtilizationStatistics
|
統計資訊命名模式
命名模式如下：
• 所有統計資訊會以 twx.stats 為前置碼收集
• 驗證統計資訊會以 twx.stats.authentication 為前置碼收集
• 實體統計資訊會以 twx.stats.entity 為前置碼收集
• 實體服務統計資訊會以 twx.stats.entity.<entityname>.services.<servicename> 為前置碼收集。
• 實體訂閱統計資訊會以 twx.stats.entity.<entityname>.subscriptions.<source of the subscription event>.<subscription type>.<property name> 為前置碼收集。
服務的「命名」參數資料類型包括：
• 前置碼 - 新增至您要取得傳回統計資料之服務的起點。例如，欲僅檢視驗證統計資訊，請將 twx.stats.authentication 前置碼提供給 GetStatistics 服務或使用不含參數的 GetAuthententicationStatistics 方便服務。
• 一般運算式 - 可以用於實體名稱與服務。如果彙總選項已關閉，則可以選擇查看遵循 regex 模式的所有實體。您也可以使用 regex 顯示以字 Get 起首的某些服務。使用的 regex 模式遵循
https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html 中所載的 Java Regex 模式
因逾時而終止之指令集執行的相關統計資訊
ThingWorx Platform 會終止執行時間較長的指令集，並將動作報告至平台記錄檔。從 v.8.5.0 開始，ThingWorx Platform 也會收集因逾時所致之任何指令集終止的相關統計資訊。當執行時間超出所配置的指令集逾時值時，會記錄統計資訊。平台會收集寫入至 JavaScript 之服務與訂閱的統計資訊。
|
|
依預設，ThingWorx 平台上的指令集逾時設定為 30 秒。如果指令集的執行時間比該時間長，則平台會終止執行。ThingWorx 管理員可以在 platform-settings.json 組態檔案的基本設定部份中配置指令集逾時。請參閱
platform-settings.json 組態詳細資訊。
|
統計資訊包含在利用率子系統中下列服務的結果中：
• GetStatistics
• GetEntityStatistics
• GetEntityServiceStatistics
• GetEntitySubscriptionStatistics
• WriteStatisticsReport
• WriteEntityStatisticsReport
• WriteEntityServiceStatisticsReport
• WriteEntitySubscriptionStatisticsReport
逾時統計資訊適用於服務，但需要使用下列命名模式：
twx.stats.entity.<entity-name>.services.<service-name>.timedout
同樣地，訂閱的逾時統計資訊也可用，但需要使用下列命名模式：
twx.stats.entity.<entity-name>.subscriptions.<subscription-name>.timedout
這些 timedout 統計資訊會在指定的指令集逾時時，追蹤出現位置與持續時間統計資訊。