Статистика запросов
С помощью подсистемы использования платформа ThingWorx предоставляет пространство имен для статистики операций с запросами во время выполнения. Корневое пространство имен для всей статистики, связанной с запросами, имеет префикс twx.stats.query. Статистика собирается для определенной операции запроса, обрабатываемой поставщиками хранилища данных, известными как операции с поставщиком поиска в модели и индексированных свойствах (MIPSP). Если поставщик хранилища данных предлагает операции MIPSP, то ThingWorx пытается оптимизировать поиск на основе входных параметров запроса в операции поиска с использованием комбинации стратегий фильтрации базы данных и кэша. Поставщики хранилища данных Postgres, MSSQL и SQL Azure предоставляют этот тип возможностей поиска.
Включение статистики запросов
Статистика запросов включается в подсистеме использования. Дополнительные сведения см. в разделе Подсистема "Использование".
Управление статистикой запросов
При выполнении сервиса QueryImplementingThingsOptimized сбор метрик запроса управляется с помощью набора сервисов в подсистеме использования. Эти сервисы доступны в Composer, но в настоящее время не предоставляются для расширения 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. Результаты supportdetermination для namemask предоставят входные данные для платформы, чтобы определить способ оптимизации запроса.
Статистика будет указывать, сколько времени это заняло и сколько раз функциональность 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. Однако статистика для операции searchthingnames, которая предоставляется функциональностью twx.stats.query.mipsp.db.searchthingnames, включает статистику для статистики buildqueryследующим образом:
Здесь A = twx.stats.query.mipsp.db.searchthingnames
и B = twx.stats.query.mipsp.db.searchthingnames.buildquery.
Затем A - B = C, где C = число/хронометраж, не включающее часть buildquery из searchthingnames. C включает число и хронометраж запроса к базе данных, но не построение запроса SQL к базе данных, который выполняется во время операции searchthingnames.
|
|
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, но для сервиса getpropertyvtqcount в операции UtilizationSubsystem, а не в операцииsearchthingnames.
Сервис GetPropertyVTQCount используется компонентом Phone Home в ThingWorx Platform. Для каждого отчетного периода он вызывает этот интерфейс API, чтобы загрузить статистику для отчета в метриках Phone Home. После сброса можно увидеть два или более счетчиков, если в период работы Phone Home отправлялся набор метрик, так как метрики для twx.stats.query сбрасывались.
|
|
getpropertyvtqcount.buildFilters
|
getpropertyvtqcount
|
twx.stats.query.mipsp.db.getpropertyvtqcount.buildfilters
|
Статистика, собранная для обработки входных данных запроса фильтров и фильтрации наборов во внутренней сборке для построения SQL запроса для получения данных о количестве property_vtq. Эти значения минимального и максимального времени включают создание простого фильтра запроса с использованием сложных запросов - соответственно, с набором вложенных фильтров.
|