Просмотр кода страницы Создание пользовательских метрик из сеансов пользователей для веб-приложений

С помощью настраиваемых показателей сеанса пользователя ( <code>uscm.</code>префикс ) вы можете извлекать показатели KPI бизнес-уровня из данных сеанса пользователя и сохранять их в виде временных рядов. Затем вы можете использовать сохраненные метрики в пользовательских диаграммах , механизмах оповещения или Metrics API .

Пользовательские показатели сеанса пользователя могут помочь вам ответить на такие вопросы, как:

* Как индекс пользовательского опыта для моего веб-сайта меняется с течением времени?
* Как доход, полученный моими пользователями, меняется с течением времени?
* Сколько пользователей заходит на мой сайт и какие браузеры они используют?
* Какова средняя продолжительность сеанса для моего мобильного приложения?

Вы можете создавать и управлять пользовательскими показателями сеанса пользователя с помощью веб-интерфейса Ключ-АСТРОМ или API настроек Ключ-АСТРОМ .

== Настройка метрик через пользовательский интерфейс ==
Вы можете создавать и управлять пользовательскими показателями сеанса пользователя с помощью веб-интерфейса Ключ-АСТРОМ.

# В меню Ключ-АСТРОМ выберите « Настройки » > « Веб- и мобильный мониторинг » > «Индивидуальные показатели сеанса пользователя » .
# Выберите Добавить элемент .
# Введите ключ метрики , который следует использовать при приеме метрики. Вы будете использовать этот ключ при запросе данных метрики через Data Explorer .
# В разделе Тип значения для извлечения выберите один из следующих вариантов:
#* Счетчик пользовательских сеансов для подсчета количества пользовательских сеансов, аналогичный <code>COUNT(*)</code>при использовании USQL .
#* Значение поля сеанса пользователя для извлечения значения поля сеанса пользователя. Также укажите Имя поля , которое должно совпадать с именем поля USQL. Возможные значения см . в разделе Имена полей значений .
# В разделе Добавить измерение укажите поля, которые следует использовать в качестве измерений. Обратите внимание, что размеры должны соответствовать именам полей USQL. Возможные значения см. в разделе Размеры .
# В разделе Добавить фильтр включите необходимые фильтры.
#* Введите Имя поля , которое должно совпадать с именем поля USQL. Возможные значения см. в разделе Фильтрация имен полей .
#* Выберите Оператора .
#* Если вы выбрали один из бинарных операторов, например, равно или больше , также укажите второй аргумент в текстовом поле Значение .

Кроме того, вы можете использовать USQL для создания пользовательских показателей сеанса пользователя. После выполнения введенного запроса выберите Создать пользовательскую метрику .С помощью настраиваемых показателей сеанса пользователя ( <code>uscm.</code>префикс ) вы можете извлекать показатели KPI бизнес-уровня из данных сеанса пользователя и сохранять их в виде временных рядов. Затем вы можете использовать сохраненные метрики в пользовательских диаграммах , механизмах оповещения или Metrics API .

Пользовательские показатели сеанса пользователя могут помочь вам ответить на такие вопросы, как:

* Как индекс пользовательского опыта для моего веб-сайта меняется с течением времени?
* Как доход, полученный моими пользователями, меняется с течением времени?
* Сколько пользователей заходит на мой сайт и какие браузеры они используют?
* Какова средняя продолжительность сеанса для моего мобильного приложения?

Вы можете создавать и управлять пользовательскими показателями сеанса пользователя с помощью веб-интерфейса Ключ-АСТРОМ или API настроек Ключ-АСТРОМ .

== Настройка метрик через пользовательский интерфейс ==
Вы можете создавать и управлять пользовательскими показателями сеанса пользователя с помощью веб-интерфейса Ключ-АСТРОМ.

# В меню Ключ-АСТРОМ выберите « Настройки » > « Веб- и мобильный мониторинг » > «Индивидуальные показатели сеанса пользователя » .
# Выберите Добавить элемент .
# Введите ключ метрики , который следует использовать при приеме метрики. Вы будете использовать этот ключ при запросе данных метрики через Data Explorer .
# В разделе Тип значения для извлечения выберите один из следующих вариантов:
#* Счетчик пользовательских сеансов для подсчета количества пользовательских сеансов, аналогичный <code>COUNT(*)</code>при использовании USQL .
#* Значение поля сеанса пользователя для извлечения значения поля сеанса пользователя. Также укажите Имя поля , которое должно совпадать с именем поля USQL. Возможные значения см . в разделе Имена полей значений .
# В разделе Добавить измерение укажите поля, которые следует использовать в качестве измерений. Обратите внимание, что размеры должны соответствовать именам полей USQL. Возможные значения см. в разделе Размеры .
# В разделе Добавить фильтр включите необходимые фильтры.
#* Введите Имя поля , которое должно совпадать с именем поля USQL. Возможные значения см. в разделе Фильтрация имен полей .
#* Выберите Оператора .
#* Если вы выбрали один из бинарных операторов, например, равно или больше , также укажите второй аргумент в текстовом поле Значение .

Кроме того, вы можете использовать USQL для создания пользовательских показателей сеанса пользователя. После выполнения введенного запроса выберите Создать пользовательскую метрику .

== Настройка метрик через API ==
Вы также можете использовать API настроек для настройки пользовательских показателей сеанса пользователя.

# Создайте токен доступа с разрешениями Запись параметров ( <code>settings.write</code>) и Чтение параметров ( <code>settings.read</code>).
# Используйте конечную точку схемы GET a , чтобы узнать формат JSON, необходимый для публикации вашей конфигурации. Идентификатор схемы конфигурации метрики ( <code>schemaId</code>) — <code>builtin:custom-metrics</code>. Вот пример полезной нагрузки JSON с конфигурацией метрики:

# Используйте конечную точку объекта POST для отправки конфигурации.

== Свойства конфигурации и поддерживаемые значения ==
Свойства конфигурации
{| class="wikitable"
!Имущество
!Описание
!Возможные значения
|-
|<code>enabled</code>
|Определяет, включена ли пользовательская метрика. Установите для <code>false</code>временного отключения метрики.
|<code>true</code>или же<code>false</code>
|-
|<code>metricKey</code>
|Ключ метрики, используемый при приеме метрики. Должен начинаться с <code>uscm.</code>префикса. Используйте этот ключ при запросе данных метрики через Data Explorer .
|
|-
|<code>value</code>
|Источник значения метрики.
|
|-
|<code>value.type</code>
|Чтобы подсчитать количество пользовательских сеансов, как <code>COUNT(*)</code>при использовании USQL , установите значение <code>COUNTER</code>. Чтобы извлечь значение поля сеанса пользователя, установите значение <code>FIELD</code>. Обратите внимание, что поля действий пользователя не поддерживаются.
|<code>COUNTER</code>или же<code>FIELD</code>
|-
|<code>value.fieldName</code>
|Если <code>value.type</code>= <code>FIELD</code>, указывает имя поля сеанса пользователя.
|См . Имена полей значений .
|-
|<code>dimensions</code>
|Список полей, используемых в качестве измерений.
|См . Размеры .
|-
|<code>filters</code>
|Указывает фильтры.
|
|-
|<code>filter.fieldName</code>
|Указывает имя поля фильтра.
|См. Фильтр имен полей .
|-
|<code>filter.operator</code>
|Указывает оператора.
|<code>EQUALS</code>, <code>NOT_EQUAL</code>, <code>IS_NULL</code>, <code>IS_NOT_NULL</code>, <code>LIKE</code>, <code>LESS_THAN</code>, <code>LESS_THAN_OR_EQUAL_TO</code>, <code>GREATER_THAN</code>,<code>GREATER_THAN_OR_EQUAL_TO</code>
|-
|<code>filter.value</code>
|Например, для бинарных операторов <code>EQUALS</code>or <code>GREATER_THAN</code>предоставляет второй аргумент.
|
|}
Имена полей значений

* Ключ-АСТРОМ поддерживает только поля сеанса пользователя. Поля действий пользователя не поддерживаются.
* Все имена полей должны совпадать с именами полей USQL.
* Префикс <code>usersession.</code>в имени поля необязателен. Например, <code>usersession.duration</code>и <code>duration</code>означают одно и то же.
* Когда настроенное поле содержит <code>null</code>, метрика игнорируется, но Ключ-АСТРОМ использует самоконтроль для выявления таких случаев.

==== Поддерживаемые имена полей ====
<code>duration</code>

<code>numberOfRageClicks</code>

<code>numberOfRageTaps</code>

<code>totalErrorCount</code>

<code>totalLicenseCreditCount</code>

<code>userActionCount</code>

<code>longProperties.*</code>—Любое пользовательское длинное свойство, например, <code>longProperties.outerwidth</code>

<code>doubleProperties.*</code>—Любое пользовательское двойное свойство, например,<code>doubleProperties.revenue</code>

Габаритные размеры

* Поддерживаются как поля сеанса пользователя, так и поля действий пользователя. Поля действий пользователя поддерживаются, начиная с Ключ-АСТРОМ 1.234.
* Все имена полей должны совпадать с именами полей USQL.
* Префиксы:
** Для имени поля сеанса пользователя <code>usersession.</code>префикс необязателен. Например, <code>usersession.country</code>и <code>country</code>означают одно и то же. При приеме метрики <code>usersession.</code>префикс отбрасывается, например, <code>usersession.country</code>становится <code>country</code>.
** Для имени поля действия пользователя <code>useraction.</code>префикс обязателен. При приеме метрики <code>useraction.</code>префикс сохраняется.
* К одной метрике можно добавить до 10 параметров.
* Когда поле, сконфигурированное как измерение, содержит <code>null</code>, Ключ-АСТРОМ использует <code>null</code>строку в качестве значения измерения.
* Когда вы используете <code>useraction.application</code>в качестве параметра и сеанс пользователя охватывает несколько приложений, значение пользовательского показателя сеанса пользователя записывается для каждого приложения. Чтобы значение не отображалось как двойное, разделите метрику по приложению.

==== Поля сеанса пользователя ====
<code>appVersion</code>

<code>applicationType</code>

<code>bounce</code>

<code>browserFamily</code>

<code>browserMajorVersion</code>

<code>browserType</code>

<code>carrier</code>

<code>region</code>

<code>continent</code>

<code>country</code>

<code>connectionType</code>

<code>device</code>

<code>displayResolution</code>

<code>endReason</code>

<code>hasCrash</code>

<code>hasError</code>

<code>hasSessionReplay</code>

<code>manufacturer</code>

<code>networkTechnology</code>

<code>newUser</code>

<code>osFamily</code>

<code>osVersion</code>

<code>reasonForNoSessionReplay</code>

<code>reasonForNoSessionReplayMobile</code>

<code>rootedOrJailbroken</code>

<code>screenHeight</code>

<code>screenOrientation</code>

<code>screenWidth</code>

<code>userExperienceScore</code>

<code>userType</code>

<code>stringProperties.*</code>— Любое пользовательское строковое свойство, например, <code>stringProperties.author</code>. Используйте поля с низкой кардинальностью, чтобы не создавать слишком много значений измерения.

==== Поля действий пользователя ====
<code>useraction.application</code>(начиная с Ключ-АСТРОМ 1.234)

Имена полей фильтра

* Поддерживаются как поля сеанса пользователя, так и поля действий пользователя.
* Все имена полей должны совпадать с именами полей USQL.
* Префиксы:
** Для имени поля сеанса пользователя <code>usersession.</code>префикс необязателен. Например, <code>usersession.country</code>и <code>country</code>означают одно и то же.
** Для имени поля действия пользователя <code>useraction.</code>префикс обязателен.
* Когда вы добавляете несколько фильтров, все они должны совпадать — фильтры объединяются с помощью <code>AND</code>.
* Для фильтров, использующих поле действия пользователя, требуется соответствие хотя бы одному действию пользователя. Действия пользователя сопоставляются с помощью <code>ANY</code>.
* Для одной метрики можно настроить до 10 фильтров.

==== Поля сеанса пользователя ====
<code>appVersion</code>

<code>applicationType</code>

<code>bounce</code>

<code>browserFamily</code>

<code>browserMajorVersion</code>

<code>browserMonitorName</code>

<code>browserType</code>

<code>carrier</code>

<code>city</code>

<code>region</code>

<code>continent</code>

<code>country</code>

<code>connectionType</code>

<code>device</code>

<code>displayResolution</code>

<code>duration</code>

<code>endReason</code>

<code>hasCrash</code>

<code>hasError</code>

<code>hasSessionReplay</code>

<code>ip</code>

<code>isp</code>

<code>manufacturer</code>

<code>networkTechnology</code>

<code>newUser</code>

<code>numberOfRageClicks</code>

<code>osFamily</code>

<code>osVersion</code>

<code>reasonForNoSessionReplay</code>

<code>reasonForNoSessionReplayMobile</code>

<code>rootedOrJailbroken</code>

<code>screenHeight</code>

<code>screenOrientation</code>

<code>screenWidth</code>

<code>totalErrorCount</code>

<code>totalLicenseCreditCount</code>

<code>userActionCount</code>

<code>userExperienceScore</code>

<code>userId</code>

<code>userType</code>

<code>longProperties.*</code>—Любое пользовательское длинное свойство, например, <code>longProperties.outerwidth</code>

<code>doubleProperties.*</code>—Любое пользовательское двойное свойство, например, <code>doubleProperties.revenue</code>

<code>stringProperties.*</code>—Любое пользовательское строковое свойство, например,<code>stringProperties.author</code>

==== Поля действий пользователя ====
<code>useraction.apdexCategory</code>

<code>useraction.application</code>

<code>useraction.cdnBusyTime</code>

<code>useraction.cdnResources</code>

<code>useraction.customErrorCount</code>

<code>useraction.domCompleteTime</code>

<code>useraction.domContentLoadedTime</code>

<code>useraction.documentInteractiveTime</code>

<code>useraction.domain</code>

<code>useraction.duration</code>

<code>useraction.firstInputDelay</code>

<code>useraction.firstPartyBusyTime</code>

<code>useraction.firstPartyResources</code>

<code>useraction.frontendTime</code>

<code>useraction.hasCrash</code>

<code>useraction.internalApplicationId</code>

<code>useraction.internalKeyUserActionId</code>

<code>useraction.javascriptErrorCount</code>

<code>useraction.keyUserAction</code>

<code>useraction.largestContentfulPaint</code>

<code>useraction.name</code>

<code>useraction.networkTime</code>

<code>useraction.requestErrorCount</code>

<code>useraction.serverTime</code>

<code>useraction.speedIndex</code>

<code>useraction.targetUrl</code>

<code>useraction.thirdPartyBusyTime</code>

<code>useraction.thirdPartyResources</code>

<code>useraction.type</code>

<code>useraction.visuallyCompleteTime</code>

== Известные ограничения ==
Мы определили следующие ограничения для пользовательских показателей сеанса пользователя:

* Вы можете зафиксировать до 500 пользовательских метрик для каждой среды.
* Синтетические данные сеанса пользователя не учитываются в значениях пользовательских показателей; включены только данные реальных пользователей.
* Ключ-АСТРОМ обновляет пользовательские показатели каждый раз при закрытии сеанса. Это означает, что данные сеанса в реальном времени не учитываются в значениях пользовательских метрик; включаются только данные закрытого сеанса.
* Ключевое <code>DISTINCT</code>слово, используемое в USQL , не поддерживается. Если у вас есть такой запрос <code>SELECT COUNT(DISTINCT country) from usersession</code>, невозможно создать эквивалентный специальный показатель.

== Пример ==
Чтобы лучше понять, как работают пользовательские показатели сеанса пользователя, вы можете следовать приведенному ниже примеру.

Используя веб-интерфейс Ключ-АСТРОМ, давайте создадим показатель средней продолжительности сеанса на основе данных о сеансах реальных пользователей. Метрика будет включать два измерения для сегментации данных сеанса по семейству браузеров и основной версии браузера. Используя эту метрику, мы затем создадим диаграмму для метрики, закрепим диаграмму на информационной панели и создадим специальное событие для метрики, чтобы вы могли получать оповещения, когда значение метрики превышает указанный порог.

Создать показатель

# В меню Ключ-АСТРОМ выберите « Настройки » > « Веб- и мобильный мониторинг » > «Индивидуальные показатели сеанса пользователя » .
# Выберите Добавить элемент .
# Введите <code>uscm.average_duration_of_sessions_by_browser_family_and_version</code>в качестве метрического ключа .
# В разделе Тип значения для извлечения выберите Значение поля сеанса пользователя . Кроме того, установите для имени поля значение <code>duration</code>.
# Выберите Добавить измерение и добавьте измерения <code>browserMajorVersion</code>и <code>browserFamily</code>.
# В разделе Добавить фильтр включите следующие фильтры:
#* <code>userType</code>= <code>REAL_USER</code>( Имя поля <code>userType</code>, Оператор<code>equals</code> , Значение<code>REAL_USER</code> ) _ _
#* <code>useraction.application</code>= <code>www.easytravel.com</code>( Имя поля <code>useraction.application</code>, Оператор<code>equals</code> , Значение ) <code>www.easytravel.com</code>. _ Вместо использования <code>www.easytravel.com</code>значения вы можете использовать имя своего собственного приложения.
# Выберите Сохранить изменения .

Теперь у вас есть настраиваемая метрика сеанса пользователя, которая извлекается как поле ( <code>duration</code>) только в том случае, если оно <code>useraction.application</code>равно <code>www.easytravel.com</code>(фильтрация для определенного приложения) и <code>userType</code>равно <code>REAL_USER</code>(фильтрация только для реальных пользователей). Кроме того, вы добавили два измерения, которые позволяют разделить данные на основе семейства браузеров или основной версии браузера.

После получения данных сеанса пользователя и заполнения метрики вы можете составить график этой метрики, закрепить диаграмму на информационной панели и даже создать оповещение на основе метрики.

Создание и закрепление диаграммы

Теперь давайте создадим диаграмму на основе <code>uscm.average_duration_of_sessions_by_browser_family_and_version</code>метрики и привяжем эту диаграмму к одной из ваших информационных панелей.

# В меню Ключ-АСТРОМ выберите Проводник данных .
# Выберите <code>uscm.average_duration_of_sessions_by_browser_family_and_version</code>показатель и выберите Выполнить запрос .
# С помощью обозревателя данных разделите собранные данные, чтобы просмотреть данные сеанса пользователя, разделенные на основе <code>browserMajorVersion</code>, <code>browserFamily</code>, или того и другого.
# Отфильтруйте данные о сеансе пользователя на основе интересующих вас данных о сеансе пользователя <code>browserMajorVersion</code>или <code>browserFamily</code>сосредоточьтесь на них.
# Создав диаграмму, представляющую ваши данные, закрепите диаграмму на информационной панели: выберите Закрепить на информационной панели , выберите одну из своих информационных панелей и введите имя плитки.

Создать оповещение

В последней части этого примера мы создадим оповещение на основе пользовательской метрики сеанса пользователя.

Чтобы создать оповещение

# В меню Ключ-АСТРОМ выберите « Настройки » > « Обнаружение аномалий » > «Пользовательские события для оповещения » .
# Выберите Создать специальное событие для оповещения .
# Создайте пользовательское событие на основе <code>uscm.average_duration_of_sessions_by_browser_family_and_version</code>метрики. Дополнительные сведения см. в разделе События метрик для оповещения .

== Часто задаваемые вопросы ==
Я вижу данные сеанса пользователя, но не вижу данные пользовательской метрики сеанса пользователя в обозревателе данных.

Убедитесь, что сеанс пользователя не активен. Ключ-АСТРОМ извлекает и сохраняет метрические данные во временных рядах только после закрытия сеанса пользователя.

Почему показатели сеансов в реальном времени не отображаются в обозревателе данных?

Поскольку сеансы закрываются в веб-приложениях, они помещаются в очередь для последующей обработки. Затем несколько фоновых рабочих извлекают данные метрик из пользовательских сеансов, чтобы подготовить данные для приема метрик.

Почему результаты моего запроса USQL не соответствуют специальной метрике?

Синтетические данные сеанса пользователя не учитываются в пользовательских показателях сеанса пользователя.

Исключите синтетические сеансы из вашего запроса. Кроме того, убедитесь, что к запросу и метрике применяются одни и те же временные рамки.

Как выставляются счета за пользовательские показатели сеансов пользователей?

Начиная с Ключ-АСТРОМ SaaS 1.232, пользовательские метрики из сеансов пользователей подлежат лицензированию блока данных Дэвиса (DDU) . Эти метрики оплачиваются как обычные метрики без схемы.

Чтобы оценить стоимость метрики, оцениваются сеансы за последние 7 дней, а стоимость в DDU на метрику рассчитывается в соответствии с ожидаемым приемом в минуту. Подробнее см. в разделе Как мы рассчитываем потребление DDU для пользовательских метрик? .

Какова степень детализации интервала для пользовательских показателей сеанса пользователя?

Хранение метрик и данных Ключ-АСТРОМ следует стратегии хранения данных, которая объединяет метрики с течением времени. Стратегия хранения данных, применяемая к пользовательским метрикам из пользовательских сеансов, идентична стратегии хранения данных, используемой для встроенных метрик временных рядов.