질의 통계
사용률 하위 시스템을 통해 ThingWorx Platform은 런타임에 질의 관련 작업에 대한 통계 네임스페이스를 제공합니다. 모든 질의 관련 통계에 대한 루트 네임스페이스에는 twx.stats.query가 접두사로 사용됩니다. MIPSP(모델 및 색인화된 속성 검색 공급자) 작업으로 알려진 지속성 공급자가 처리하는 특정 질의 작업에 대한 통계가 수집됩니다. 지속성 공급자가 MIPSP 작업을 제공하는 경우 ThingWorx는 데이터베이스 및 캐시 필터링 전략의 조합을 사용하여 검색 작업에 대한 질의 매개 변수 입력을 기반으로 검색 최적화를 시도합니다. Postgres, MSSQL 및 Azure SQL 지속성 공급자는 이러한 유형의 검색 기능을 제공합니다.
질의 통계 활성화
질의 통계는 사용률 하위 시스템에서 활성화됩니다. 자세한 내용은 사용률 하위 시스템을 참조하십시오.
질의 통계 관리
QueryImplementingThingsOptimized 서비스 실행 시 질의 메트릭 수집은 사용률 하위 시스템의 서비스 집합을 사용하여 관리됩니다. 이러한 서비스는 Composer에서 사용할 수 있지만 현재 Extension Java SDK에 노출되지 않습니다.
|
세부 정보
|
|
|---|---|
|
설명
|
모든 질의 작업 관련 통계를 반환합니다. 결과는 UtilizationStatistics 데이터 셰이프의 인포테이블로 제공됩니다. 질의 작업 통계의 하위 집합을 선택하는 필터링을 제공합니다. 예를 들어, MIPSP 질의 작업 통계를 검색하기 위해 GetStatistics 서비스를 사용하고 twx.stats.query.mipsp 네임스페이스를 지정할 수 있습니다.  |
|
매개 변수
|
• maxItems
◦ 반환할 최대 항목 수
◦ NUMBER 기본 유형
• sortColumnName
◦ 정렬할 인포테이블 결과 열 필드의 이름
◦ STRING 기본 유형
◦ 기본값: count
• sortAscending
◦ 정렬 순서 기준: 오름차순 또는 내림차순
◦ BOOLEAN 기본 유형
◦ 기본값: false
|
|
결과 예
|
자세한 내용은 아래의 질의 통계 해석을 참조하십시오.  |
|
세부 정보
|
|
|---|---|
|
설명
|
질의 통계를 작성합니다.
|
|
매개 변수
|
• fileType
◦ CSV로 보고할 파일 유형
◦ STRING 기본 유형
◦ 기본값: csv
◦ 허용 값: csv
• maxItems
◦ 반환할 최대 항목 수
◦ NUMBER 기본 유형
• sortColumnName
◦ 정렬할 인포테이블 결과 열 필드의 이름
◦ STRING 기본 유형
◦ 기본값: count
• sortAscending
◦ 정렬 순서 기준
◦ BOOLEAN 기본 유형
◦ 기본값: false
|
|
결과 예
|
 |
|
세부 정보
|
|
|---|---|
|
설명
|
질의 통계를 재설정합니다.
|
|
매개 변수
|
해당 없음
|
|
결과
|
성공하면 결과가 제공되지 않습니다.
|
질의 통계 해석
사물 템플릿 또는 사물 형태의 QueryImplementingThingsOptimized 서비스를 통한 검색 작업을 수행하면 MIPSP 작업이 수행됩니다. 해당 작업의 일부로 통계는 mipsp라는 루트 질의 통계 네임스페이스의 하위 노드에서 캡처됩니다.
twx.stats.query.mipsp 접두사가 붙은 모든 통계는 MIPSP 작업 중에 메트릭이 수집됨을 나타냅니다.
MIPSP 질의 통계는 QueryImplementingThingsOptimized 서비스를 실행할 때 통계의 다음 하위 노드를 제공합니다. 이 "이름 키 하위 노드"에서 제공하는 각 통계는 최소, 최대, 평균 타이밍 및 명명된 기능의 여러 호출을 통해 해당 열에 제공된 값으로 확인되는 개수를 제공합니다. 추가 호출이 발생하면 각 통계의 "이름 키"가 업데이트되어 GetQueryStatistics 서비스에 대한 요청 시 새 값을 반영합니다.
|
하위 노드
|
상위 노드
|
전체 경로
|
세부 정보
|
|---|---|---|---|
|
supportdetermination
|
mipsp
|
twx.stats.query.mipsp.supportdetermination
|
제공된 매개 변수에 따라 질의를 최적화하고 지원하는 방법을 결정하기 위한 통계를 제공합니다.
예를 들어, namemask 매개 변수가 질의에 대한 입력 매개 변수로 제공된 경우 이 supportdetermination 기능은 namemask 매개 변수를 지원할 수 있는지 여부를 결정합니다. namemask에 대한 supportdetermination의 결과는 플랫폼에서 요청된 질의를 최적화하는 방법을 결정하기 위한 입력을 제공합니다.
통계는 이 기능을 통과하는 질의 매개 변수 입력의 다양한 순열에 걸쳐 supportdetermination 기능이 실행되는 데 걸린 시간과 횟수를 나타냅니다.
|
|
interrogate
|
mipsp
|
twx.stats.query.mipsp.interrogate
|
지속성 공급자에게 제공하는 검색 기능의 유형을 묻는 통계를 제공합니다.
예를 들어, namemask 매개 변수가 제공되면 지속성 공급자는 해당 검색 기능을 지원하는지 여부를 묻습니다.
|
|
searchthingnames
|
db
|
twx.stats.query.mipsp.db.searchthingnames
|
데이터베이스를 사용해 검색 매개 변수를 충족하는 사물 이름을 검색하여 검색을 최적화하기로 결정된 모든 작업에 대한 통계를 제공합니다.
|
|
searchthingnames.buildquery
|
searchthingnames
|
twx.stats.query.mipsp.db.searchthingnames.buildquery
|
사물 이름에 대한 데이터베이스 검색을 수행하는 데 필요한 SQL 질의를 작성하기 위한 통계를 제공합니다.
이 메트릭의 최소, 최대, 평균 시간 및 개수는 searchthingnames 작업의 buildquery 기능에 대한 구체적이고 고유한 통계입니다. 그러나 twx.stats.query.mipsp.db.searchthingnames에서 제공하는 searchthingnames에 대한 통계에는 다음과 같은 buildquery 통계에 대한 통계가 포함됩니다.
여기서 A = "twx.stats.query.mipsp.db.searchthingnames"이고,
B = "twx.stats.query.mipsp.db.searchthingnames.buildquery"입니다.
그리고 나서 A-B = C입니다. 여기서 C는 searchthingnames의 buildquery 부분을 포함하지 않는 개수/타이밍입니다. C는 데이터베이스에 대해 질의를 실행하기 위한 개수 및 타이밍을 포함하지만 searchthingnames 작업 중에 데이터베이스에 대해 수행되는 SQL 질의 작성은 포함하지 않습니다.
|
|
getpropertyvtqcount
|
db
|
twx.stats.query.mipsp.db.getpropertyvtqcount
|
buildquery 및 buildfilter 매개 변수의 하위 통계에 대한 통계 메트릭, 상위 메트릭 및 집계된 메트릭을 제공합니다. 통계 개수 및 타이밍에는 해당 하위 통계에 대한 타이밍 및 개수 값이 포함됩니다.
|
|
getpropertyvtqcount.buildquery
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildquery
|
이 통계는 twx.stats.query.mipsp.db.searchthingnames와 유사하지만 searchthingnames 작업이 아니라 UtilizationSubsystem의 getpropertyvtqcount 서비스에 대한 것입니다.
GetPropertyVTQCount 서비스는 ThingWorx Platform 내의 폰 홈 기능에서 사용됩니다. 모든 보고 기간 동안 이 서비스는 이 API를 호출하여 폰 홈 메트릭 내에서 보고할 통계를 검색합니다. 폰 홈 기간으로 인해 twx.stats.query에 대한 메트릭이 재설정된 이후 시간 내에 메트릭 모음이 홈에 보고된 경우 재설정 후에도 두 개 이상의 개수가 표시될 수 있습니다.
|
|
getpropertyvtqcount.buildFilters
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildfilters
|
property_vtq 개수 데이터를 검색하는 SQL 질의를 작성하는 내부 구조에 대한 필터 및 필터 컬렉션의 질의 입력을 처리하기 위해 수집된 통계입니다. 이러한 최소 및 최대 시간 값에는 각각 복잡한 중첩 필터 컬렉션 질의를 통한 간단한 질의 필터 작성이 포함됩니다.
|