사용률 하위 시스템
사용률 하위 시스템의 서비스는 실행 통계를 제공합니다. 이 하위 시스템의 서비스를 사용하여 얻을 수 있는 정보는 다음과 같습니다.
• 서비스 실행이 완료될 때까지 걸린 시간(최소, 최대 및 평균 시간)
• 서비스가 실행된 횟수
• 제한 시간으로 인해 종료된 JavaScript 서비스 및 구독입니다. 아래의 제한 시간으로 인해 종료된 스크립트 실행에 대한 통계를 참조하십시오.
통계는 서버가 마지막으로 재시작된 시간(밀리초)부터 기록되지만 통계 지속성 사용 옵션을 활성화하면 지속할 수 있습니다. WriteStatisticsReport 서비스를 사용하면 이러한 통계가 포함된 CSV 파일을 ThingworxStorage 폴더에 쓸 수 있습니다.
 |
통계는 완료된 서비스에만 제공됩니다. 서비스에서 실행을 완료하지 않은 경우 해당 실행이 통계에 포함되지 않습니다.
|
|
매개 변수
|
기본값
|
설명
|
||
|---|---|---|---|---|
|
통계 사용
|
false
|
활성화하면 플랫폼에서 통계를 수집합니다. 비활성화하면 서비스가 통계를 반환하지 않습니다.
|
||
|
엔티티 이름 집계 사용
|
true
|
여러 엔티티에서 동일한 서비스를 사용하는 경우 서비스에 대해 집계된 통계가 표시됩니다.
|
||
|
백분위수 표시
|
false
|
구성 테이블에서 백분위수에 대한 추가 통계를 표시합니다.
|
||
|
통계 지속성 사용
|
false
|
활성화하면 서버가 재시작되고 모든 런타임 통계가 유지됩니다. 데이터는 플랫폼을 재시작한 후에도 유지됩니다.
|
UtilizationStatistics 서비스
|
서비스
|
설명
|
||
|---|---|---|---|
|
GetAuthenticationStatistics
|
지정된 인증 유형에 대해 발생한 인증 수 및 인증의 성공/실패 여부에 대한 데이터를 반환합니다. 인증 유형에는 형태 로그인, HTTP 기본, 응용 프로그램 키, SSO 및 사용자 정의 인증자가 포함됩니다.
|
||
|
GetEntityServiceStatistics
|
각 엔티티에 대한 최소, 최대, 평균, 서비스 실행 수를 반환합니다.
|
||
|
GetEntityStatistics
|
GetEntityServiceStatistics 및 GetEntitySubscriptionStatistics 서비스에서 통계의 콤보를 반환합니다.
|
||
|
GetEntitySubscriptionStatistics
|
엔티티에 대한 이벤트에서 구독을 실행하기 위한 시간 통계(최소, 최대, 평균, 총 시간)를 반환합니다.
|
||
|
GetPropertyVTQCount
|
질의 조건으로 지정된 속성의 개수를 반환합니다. 자세한 내용은 GetPropertyVTQCount 서비스 사용을 참조하십시오.
|
||
|
GetQueryStatistics
|
질의 통계를 반환합니다. 자세한 내용은 질의 통계를 참조하십시오.
|
||
|
GetStatistics
|
GetEntityServiceStatistics, GetEntitySubscriptionStatistics 및 GetAuthenticationStatistics 서비스에서 모든 통계를 반환합니다. 실행된 각 서비스에 대한 최소 시간, 최대 시간, 평균 시간 및 횟수가 포함됩니다.
|
||
|
ResetAuthenticationStatistics
|
인증 통계를 재설정합니다.
|
||
|
ResetEntityServiceStatistics
|
엔티티 서비스 통계를 재설정합니다.
|
||
|
ResetEntityStatistics
|
엔티티 통계를 재설정합니다.
|
||
|
ResetQueryStatistics
|
질의 통계를 재설정합니다. 자세한 내용은 질의 통계를 참조하십시오.
|
||
|
ResetStatistics
|
모든 통계를 재설정합니다.
|
||
|
ResetEntitySubscriptionStatistics
|
엔티티에 대한 구독 통계를 재설정합니다.
|
||
|
WriteAuthenticationStatisticsReport
|
고유하게 이름이 지정된 CSV 파일을 ThingworxStorage/reports/UtilizationStatistics 위치에 씁니다.
|
||
|
WriteEntityServiceStatisticsReport
|
고유하게 이름이 지정된 CSV 파일을 ThingworxStorage/reports/UtilizationStatistics 위치에 씁니다.
|
||
|
WriteEntityStatisticsReport
|
고유하게 이름이 지정된 CSV 파일을 ThingworxStorage/reports/UtilizationStatistics 위치에 씁니다.
|
||
|
WriteEntitySubscriptionStatisticsReport
|
고유하게 이름이 지정된 CSV 파일을 ThingworxStorage/reports/UtilizationStatistics 위치에 씁니다.
|
||
|
WriteQueryStatisticsReport
|
질의 통계를 작성합니다. 자세한 내용은 질의 통계를 참조하십시오.
|
||
|
WriteStatisticsReport
|
고유하게 이름이 지정된 CSV 파일을 ThingworxStorage/reports/UtilizationStatistics 위치에 씁니다.
|
통계에 대한 이름 지정 패턴
이름 지정 패턴은 다음과 같습니다.
• 모든 통계는 twx.stats의 접두사에 수집됩니다.
• 인증 통계는 twx.stats.authentication에 수집됩니다.
• 엔티티 통계는 twx.stats.entity에 수집됩니다.
• 엔티티 서비스 통계는 twx.stats.entity.<entityname>.services.<servicename>에 수집됩니다.
• 엔티티 구독 통계는 이름 twx.stats.entity.<entityname>.subscriptions.<subscription-name>에 수집됩니다.
• 질의 통계는 twx.stats.query에서 수집됩니다.
서비스에 대한 "이름 지정" 매개 변수 데이터 유형에는 다음 사항이 포함됩니다.
• 접두사 - 반환된 통계를 가져올 서비스의 시작 부분에 추가합니다. 예를 들어, 인증 통계만 보려면 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은 장기 실행 스크립트를 종료하고 작업을 플랫폼 로그에 보고합니다. ThingWorx Platform은 제한 시간으로 인한 스크립트 종료에 대한 통계도 수집합니다. 런타임이 구성된 스크립트 제한 시간 값을 초과하면 통계가 기록됩니다. ThingWorx Platform은 JavaScript로 작성된 서비스 및 구독에 대한 통계를 수집합니다.
|
|
기본적으로 ThingWorx Platform의 스크립트 제한 시간 설정은 30초입니다. 스크립트가 이보다 길게 실행되면 Platform에서 실행을 종료합니다. 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 통계는 지정된 스크립트가 시간 초과될 때 발생 및 시간 기간 통계를 추적합니다.