利用率サブシステム
利用率サブシステムのサービスは、実行統計を提供します。このサブシステムのサービスを使用することで、次の情報を取得できます。
• サービスの実行完了までにかかる時間 (最小、最大、および平均時間)
• サービスが実行される回数
• タイムアウトによって終了した 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.<エンティティ名>.services.<サービス名>
• この下にはエンティティ購読統計が収集されます: twx.stats.entity.<エンティティ名>.subscriptions.<購読イベントのソース>.<購読のタイプ>.<プロパティ名>
サービスの "ネーミング" パラメータのデータ型には、次のようなものがあります。
• プレフィックス - 統計を返すサービスの先頭に追加します。たとえば、認証統計のみを表示するには、twx.stats.authentication プレフィックスを GetStatistics サービスに提供するか、GetAuthententicationStatistics コンビニエンスサービスをパラメータなしで使用します。
• 正規表現 - エンティティ名とサービスに対して使用できます。集約オプションがオフになっている場合、正規表現パターンに従うすべてのエンティティを表示できます。正規表現を使用して、Get という単語で始まる特定のサービスを表示することもできます使用される正規表現パターンは、
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 統計では、指定されているスクリプトがタイムアウトしたときのオカレンスと時間の統計が追跡されます。