Поделиться через

Руководство по добавлению пользовательских тегов в телеметрию клиента

  • Статья

В этом руководстве показано, как добавить настраиваемый атрибут данных, называемый тегом параметров диагностики, в данные телеметрии, которые клиент WebJS отправляет в Azure Monitor. Эту телеметрию можно использовать для анализа после вызова.

Почему вопросы тестирования A/B

Тестирование A/B — это важный способ принятия решений, обоснованных данными, в разработке продуктов. Изучение двух вариантов выходных данных приложения разработчики могут определить, какая версия excel основана на определенных метриках, отслеживающих надежность и качество вызовов. Этот метод позволяет компаниям тестировать различные конструкции, содержимое и функциональные возможности в управляемом параметре, обеспечивая, что любые изменения приводят к измеримым улучшениям. Кроме того, тестирование A/B снижает риски, связанные с внедрением новых функций или стратегий, предлагая аналитические сведения на основе доказательств до полного запуска.

Еще одним ключевым преимуществом тестирования A/B является его емкость для выявления пользовательских предпочтений и поведения, которые могут быть не очевидны с помощью традиционных методов тестирования. Анализ результатов этих тестов позволяет разработчикам получить более глубокое представление о том, как две разные версии приложения приводят к улучшению качества и надежности пользователей. Этот итеративный цикл тестирования и оптимизации культивирует культуру постоянного улучшения, помогая разработчикам оставаться конкурентоспособными и адаптируемыми к эволюционирующим тенденциям рынка.

Преимущества тега "Параметры диагностики"

Рассмотрим возможность того, что определенные сегменты пользовательской базы сталкиваются с проблемами, и вы стремитесь лучше определить и понять эти проблемы. Например, представьте себе, что все ваши клиенты используют Службы коммуникации Azure WebJS в одном конкретном расположении сталкиваются с трудностями. Чтобы определить, что пользователи сталкиваются с проблемами, можно включить тег параметров диагностики для клиентов, инициирующих вызов в указанном расположении. Этот тег позволяет эффективно фильтровать и проверять журналы вызовов. При применении целевого тега можно разделить и проанализировать эти данные более эффективно. Средства мониторинга, такие как ACS Call Insights и Центр диагностики вызовов (CDC), могут помочь отслеживать эти теги и выявлять повторяющиеся проблемы или шаблоны. Благодаря постоянному анализу этих помеченных сеансов вы получаете ценные сведения о проблемах пользователей, что позволяет заранее устранять их и улучшать общий интерфейс пользователя.

Добавление тега параметров диагностики в код JavaScript

Существует три необязательных поля, которые можно использовать для добавления различных уровней. Отслеживание телеметрии для ваших потребностей.

  • appName
  • appVersion
  • tags

Каждое значение может иметь максимальную длину 64 символов, поддерживая только буквы [aA, bB, cC и т. д.], цифры[0-9], а также основные символы (дефис "-", символ подчеркивания "_", период".", двоеточие ":", знак числа "#").

Ниже приведен пример использования параметров параметров диагностики из приложения WebJS:

const callClient = new CallClient({
    diagnostics: {
        appName: 'contoso-healthcare-calling-services',
        appVersion: '2.1',
        tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
    }
});

Просмотр тега

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

contoso-healthcare-calling-services/2.1 azsdk-js-communication-calling/1.27.1-rc.10 (contoso_virtual_visits, участник0001). Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, например Gecko) Chrome/129.0.0.0.0 Safari/537.36 Edg/129.0.0.0.0

Примечание.

Если вы не задаете значение для "appName", "appVersion" или "tag" из клиентского API, значение по умолчанию для этого поля будет пустым.

Следующие шаги