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


Модель данных телеметрии Application Insights

Application Insights отправляет данные телеметрии из веб-приложения в портал Azure, чтобы вы могли анализировать производительность и использование приложения. Модель телеметрии стандартизирована, поэтому можно создать независимый от платформы мониторинг.

Данные, собранные Application Insights, моделируют этот типичный шаблон выполнения приложения.

Схема, показывющая модель данных телеметрии Application Insights.

Приведенные ниже типы телеметрии позволяют отслеживать выполнение приложения. Пакет SDK Application Insights из платформы веб-приложений автоматически собирает следующие три типа:

  • Запрос: создано для регистрации запроса, полученного приложением. Например, веб-пакет SDK для Application Insights автоматически создает элемент телеметрии запроса для каждого HTTP-запроса, полученного веб-приложением.

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

  • Исключение: обычно представляет исключение, которое приводит к сбою операции.

  • Зависимость: представляет вызов из приложения во внешнюю службу или хранилище, например REST API или SQL. В ASP.NET вызовы зависимостей SQL определяются System.Data. Вызовы конечных точек HTTP определяются System.Net.

Application Insights предоставляет три типа данных для пользовательской телеметрии:

  • Трассировка: используется непосредственно или через адаптер для реализации диагностика ведения журнала с помощью платформы инструментирования, знакомой с вами, например Log4Net илиSystem.Diagnostics.
  • Событие: обычно используется для отслеживания взаимодействия пользователей со службой для анализа шаблонов использования.
  • Метрика: используется для отчета о периодических скалярных измерениях.

Каждый элемент телеметрии может определять сведения о контексте, такие как версия приложения или идентификатор сеанса пользователя. Контекст — это набор строго типизированных полей, который позволяет реализовывать определенные сценарии. Если версия приложения правильно инициализирована, Application Insights может обнаруживать новые закономерности в работе приложения, связанные с повторным развертыванием.

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

Модель телеметрии Application Insights определяет способ корреляции телеметрии с операцией, в которой она является частью. Например, запрос может выполнять вызов База данных SQL и запись диагностика информации. Вы можете задать контекст корреляции для этих элементов телеметрии, которые попадут обратно в телеметрию запросов.

Усовершенствования схемы

Модель данных Application Insights — это базовый и эффективный способ моделирования телеметрии приложения. Мы стремимся сохранить модель простой и тонкой для поддержки основных сценариев и позволить схеме расширяться для расширенного использования.

Чтобы сообщить о проблемах и предложениях модели данных или схемы, используйте наш репозиторий GitHub.

Запросить

Элемент телеметрии запроса в Application Insights представляет логическую последовательность выполнения, активируется внешним запросом к приложению. Каждое выполнение запроса определяется уникальным id и url содержит все параметры выполнения.

Можно сгруппировать запросы, по логическому имени name и определить источник source этого запроса. Выполнение кода может давать результат success или fail, а также имеет определенную длительность duration. С помощью resultCodeдополнительных операций успешного и неудачного выполнения можно группировать. Время начала телеметрии запроса определяется на уровне конверта.

Телеметрия запроса поддерживает стандартную модель расширяемости с помощью пользовательского properties и measurements.

Примечание.

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

Имя.

Это поле — это имя запроса, и он представляет путь кода, принятый для обработки запроса. Низкое значение кратности позволяет лучше группировать запросы. Для HTTP-запросов он представляет шаблон пути HTTP и МЕТОДА HTTP, например GET /values/{id} без фактического id значения.

Веб-пакет SDK Application Insights отправляет имя запроса "как есть" о регистре буквы. Группирование по пользовательскому интерфейсу учитывает регистр, поэтому GET /Home/Index учитывается отдельно от GET /home/INDEX того, что часто они приводят к тому же контроллеру и выполнению действия. Причина этого заключается в том, что URL-адреса в целом чувствительны к регистру. Может потребоваться узнать, произошли ли все 404 ошибки для URL-адресов, введенных в верхнем регистре. Дополнительные сведения о коллекции имен запросов см. в веб-пакете SDK ASP.NET в записи блога.

Максимальная длина: 1024 символов

Идентификатор

Идентификатор — это идентификатор экземпляра вызова запроса. Он используется для корреляции между запросом и другими элементами телеметрии. Идентификатор должен быть глобально уникальным. Дополнительные сведения см. в статье Корреляция данных телеметрии в Application Insights.

Максимальная длина: 128 символов

URL

URL-адрес запроса — это URL-адрес запроса со всеми параметрами строки запроса.

Максимальная длина: 2 048 символов

Исходный код

Источник — источник запроса. Примерами являются ключ инструментирования вызывающего объекта или IP-адрес вызывающего объекта. Дополнительные сведения см. в статье Корреляция данных телеметрии в Application Insights.

Максимальная длина: 1024 символов

Duration

Длительность запроса форматируется как DD.HH:MM:SS.MMMMMM. Он должен быть положительным и менее 1000 дней. Это поле является обязательным, так как данные телеметрии запроса представляют операцию с началом и окончанием.

Код отклика

Код ответа является результатом выполнения запроса. Это код состояния HTTP для HTTP-запросов. Это может быть HRESULT значение или тип исключения для других типов запросов.

Максимальная длина: 1024 символов

Удачное завершение

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

Для веб-приложений Application Insights определяет запрос как успешный, если код ответа меньше 400 или равен 401. Однако существуют случаи, когда это сопоставление по умолчанию не соответствует семантике приложения.

Код 404 ответа может указывать "нет записей", которые могут быть частью регулярного потока. Это также может указывать на сломанную ссылку. Для неработанных ссылок можно реализовать более расширенную логику. Вы можете пометить неработающие ссылки как сбои только в том случае, если эти ссылки находятся на том же сайте, проанализировав ссылку URL-адреса. Или вы можете пометить их как сбои при доступе из мобильного приложения компании. Аналогичным образом 301 и 302 укажите сбой при доступе от клиента, который не поддерживает перенаправление.

Частично принятое содержимое 206 может указывать на сбой общего запроса. Например, конечная точка Application Insights может получать пакет элементов телеметрии в виде одного запроса. Возвращается 206 , когда некоторые элементы в пакете не были обработаны успешно. Увеличение скорости 206 указывает на проблему, которую необходимо исследовать. Аналогичная логика применяется к 207 мульти-состоянию, где успех может быть худшим из отдельных кодов ответа.

Пользовательские свойства

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Пользовательские измерения

Коллекция пользовательских измерений: используйте эту коллекцию для отчета именованных измерений, связанных с элементом телеметрии. Типичные случаи использования:

  • Размер полезных данных телеметрии зависимостей.
  • Количество элементов очереди, обрабатываемых телеметрией запроса.
  • Время, когда клиент выполнил этап мастера, завершив данные телеметрии событий.

Пользовательские измерения можно запросить в аналитике приложений:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Примечание.

  • Пользовательские измерения связаны с элементом телеметрии, к которому они принадлежат. Они подвергаются выборке с элементом телеметрии, содержащим эти измерения. Чтобы отслеживать измерение, не зависящее от других типов телеметрии, используйте данные телеметрии метрик.
  • Не используйте строковые значения для пользовательских измерений. Поддерживаются только числовые значения.

Максимальная длина ключа: 150

Dependency

Телеметрия зависимостей (в Application Insights) представляет взаимодействие отслеживаемого компонента с удаленным компонентом, таким как SQL или конечная точка HTTP.

Имя.

Это поле — имя команды, инициированной этим вызовом зависимостей. Он имеет низкое значение кратности. Примерами являются имя хранимой процедуры и шаблон пути URL-адреса.

Идентификатор

Идентификатор — это идентификатор экземпляра вызова зависимостей. Он используется для корреляции с элементом телеметрии запроса, соответствующим этому вызову зависимостей. Дополнительные сведения см. в статье Корреляция данных телеметрии в Application Insights.

Data

Это поле является командой, инициированной этим вызовом зависимостей. Примерами являются оператор SQL и HTTP URL со всеми параметрами запроса.

Тип

Это поле — имя типа зависимостей. Он имеет низкое значение кратности для логического группирования зависимостей и интерпретации других полей, таких как commandName и resultCode. Примерами являются SQL, таблица Azure и HTTP.

Назначение

Это поле является целевым сайтом вызова зависимостей. Примерами являются имя сервера и адрес узла. Дополнительные сведения см. в статье Корреляция данных телеметрии в Application Insights.

Duration

Длительность запроса находится в формате DD.HH:MM:SS.MMMMMM. Это должно быть меньше 1000 дней.

Код результата

Это поле является результатом вызова зависимостей. Примерами являются код ошибки SQL и код состояния HTTP.

Удачное завершение

Это поле указывает на успешный или неудачный вызов.

Пользовательские свойства

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Пользовательские измерения

Коллекция пользовательских измерений: используйте эту коллекцию для отчета именованных измерений, связанных с элементом телеметрии. Типичные случаи использования:

  • Размер полезных данных телеметрии зависимостей.
  • Количество элементов очереди, обрабатываемых телеметрией запроса.
  • Время, когда клиент выполнил этап мастера, завершив данные телеметрии событий.

Пользовательские измерения можно запросить в аналитике приложений:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Примечание.

  • Пользовательские измерения связаны с элементом телеметрии, к которому они принадлежат. Они подвергаются выборке с элементом телеметрии, содержащим эти измерения. Чтобы отслеживать измерение, не зависящее от других типов телеметрии, используйте данные телеметрии метрик.
  • Не используйте строковые значения для пользовательских измерений. Поддерживаются только числовые значения.

Максимальная длина ключа: 150

Исключение

В Application Insights экземпляр исключения представляет обработанное или необработанное исключение, которое произошло во время выполнения отслеживаемого приложения.

Идентификатор проблемы

Идентификатор проблемы определяет, где исключение было создано в коде. Он используется для группирования исключений. Как правило, это сочетание типа исключения и функции из стека вызовов.

Максимальная длина: 1024 символов

Уровень серьезности

Это поле является уровнем серьезности трассировки. Значение может бытьVerbose, , Information, WarningErrorили Critical.

Сведения об исключении

(Эти сведения будут добавлены позже.)

Пользовательские свойства

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Пользовательские измерения

Коллекция пользовательских измерений: используйте эту коллекцию для отчета именованных измерений, связанных с элементом телеметрии. Типичные случаи использования:

  • Размер полезных данных телеметрии зависимостей.
  • Количество элементов очереди, обрабатываемых телеметрией запроса.
  • Время, когда клиент выполнил этап мастера, завершив данные телеметрии событий.

Пользовательские измерения можно запросить в аналитике приложений:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Примечание.

  • Пользовательские измерения связаны с элементом телеметрии, к которому они принадлежат. Они подвергаются выборке с элементом телеметрии, содержащим эти измерения. Чтобы отслеживать измерение, не зависящее от других типов телеметрии, используйте данные телеметрии метрик.
  • Не используйте строковые значения для пользовательских измерений. Поддерживаются только числовые значения.

Максимальная длина ключа: 150

Трассировка

Данные телеметрии трассировки в Application Insights представляют printfоператоры трассировки стилей, которые находятся в текстовом поиске. Log4Net, NLog и другие записи файла журнала на основе текста преобразуются в экземпляры этого типа. Трассировка не имеет измерений как расширяемость.

Сообщение

Сообщение трассировки.

Максимальная длина: 32 768 символов

Уровень серьезности

Уровень серьезности трассировки.

Значения: Verbose, , и ErrorInformationWarningCritical

Пользовательские свойства

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Мероприятие

Элементы телеметрии событий, которые можно создавать в Application Insights, представляют событие, произошедшее в приложении. Как правило, это взаимодействие с пользователем, например нажатие кнопки или заказ. Это также может быть событие жизненного цикла приложения, например инициализация или обновление конфигурации.

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

Имя.

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

Максимальная длина: 512 символов

Пользовательские свойства

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Пользовательские измерения

Коллекция пользовательских измерений: используйте эту коллекцию для отчета именованных измерений, связанных с элементом телеметрии. Типичные случаи использования:

  • Размер полезных данных телеметрии зависимостей.
  • Количество элементов очереди, обрабатываемых телеметрией запроса.
  • Время, когда клиент выполнил этап мастера, завершив данные телеметрии событий.

Пользовательские измерения можно запросить в аналитике приложений:

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Примечание.

  • Пользовательские измерения связаны с элементом телеметрии, к которому они принадлежат. Они подвергаются выборке с элементом телеметрии, содержащим эти измерения. Чтобы отслеживать измерение, не зависящее от других типов телеметрии, используйте данные телеметрии метрик.
  • Не используйте строковые значения для пользовательских измерений. Поддерживаются только числовые значения.

Максимальная длина ключа: 150

Metric

Application Insights поддерживает два типа телеметрии метрик: одно измерение и предварительная метрика. Отдельное измерение содержит только имя и значение. Предварительная метрика указывает минимальное и максимальное значение метрики в интервале агрегирования и стандартное отклонение.

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

Application Insights поддерживает несколько известных имен метрик. Эти метрики помещаются в таблицу performanceCounters .

В следующей таблице показаны метрики, представляющие системные счетчики и счетчики процессов.

Имя .NET Имя платформы, не зависящая от платформы Description
\Processor(_Total)\% Processor Time Ведется работа... Общий объем ЦП компьютера.
\Memory\Available Bytes Ведется работа... Объем физической памяти в байтах, доступной для процессов, выполняющихся на компьютере. Он вычисляется путем суммирования объема пространства на ноль, свободный и резервный списки памяти. Свободная память готова к использованию. Отсчитываемая память состоит из страниц памяти, заполненной нулями, чтобы предотвратить просмотр данных, используемых предыдущим процессом, последующими процессами. Резервная память — это память, которая была удалена из рабочего набора процесса (его физической памяти) на диск, но по-прежнему доступна для отзыва. См . раздел "Объект памяти".
\Process(??APP_WIN32_PROC??)\% Processor Time Ведется работа... ЦП процесса размещения приложения.
\Process(??APP_WIN32_PROC??)\Private Bytes Ведется работа... Память, используемая процессом размещения приложения.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec Ведется работа... Скорость операций ввода-вывода, выполняемых процессом размещения приложения.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec Ведется работа... Скорость запросов, обработанных приложением.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec Ведется работа... Скорость исключений, создаваемых приложением.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time Ведется работа... Среднее время выполнения запроса.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue Ведется работа... Количество запросов, ожидающих обработки в очереди.

Дополнительные сведения о REST API метрик см. в разделе "Метрики— Получение".

Имя.

Это поле — имя метрики, которую вы хотите увидеть на портале Application Insights и пользовательском интерфейсе.

Значение

Это поле является одним значением измерения. Это сумма отдельных измерений для агрегирования.

Count

Это поле является весом метрики агрегированной метрики. Оно не должно быть задано для измерения.

Мин.

Это поле является минимальным значением агрегированной метрики. Оно не должно быть задано для измерения.

Макс.

Это поле является максимальным значением агрегированной метрики. Оно не должно быть задано для измерения.

Стандартное отклонение

Это поле является стандартным отклонением агрегированной метрики. Оно не должно быть задано для измерения.

Пользовательские свойства

Метрика с пользовательским набором свойств CustomPerfCounter , указывающая true , что метрика представляет счетчик производительности Windows. Эти метрики помещаются в таблицу performanceCounters , а не в customMetrics. Кроме того, имя этой метрики анализируется для извлечения категорий, счетчиков и имен экземпляров.

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

  • Максимальная длина ключа: 150
  • Максимальная длина значения: 8192

Представление страницы

Данные телеметрии PageView (в Application Insights) регистрируются, когда пользователь приложения открывает новую страницу отслеживаемого приложения. В Page этом контексте — это логическая единица, определяемая разработчиком как вкладка приложения или экран, и не обязательно сопоставляется с загрузкой веб-страниц браузера или действием обновления. Это различие можно понять в контексте одностраничных приложений (SPAs), где переключение между страницами не привязано к действиям страницы браузера. Время pageViews.duration , необходимое приложению для представления страницы пользователю.

Примечание.

  • По умолчанию пакеты SDK Application Insights регистрируют отдельные PageView события в каждом действии загрузки веб-страниц браузера с pageViews.duration заполнением по времени браузера. Разработчики могут расширить дополнительное отслеживание PageView событий с помощью вызова API trackPageView.
  • Срок хранения журналов по умолчанию составляет 30 дней. Если вы хотите просмотреть PageView статистику за более длительный период времени, необходимо настроить этот параметр.

Измерение браузеров в Application Insights

Современные браузеры предоставляют измерения для действий загрузки страниц с помощью API производительности. Application Insights упрощает эти измерения, объединяя связанные значения времени в стандартные метрики браузера в соответствии с этими определениями времени обработки:

  • Клиент <—> DNS: клиент обращается к DNS для разрешения имени узла веб-сайта, а DNS отвечает с IP-адресом.

  • Клиент <—> веб-сервер: клиент создает TCP, а затем подтверждения TLS с веб-сервером.

  • Клиент <—> веб-сервер: клиент отправляет полезные данные запроса, ожидает выполнения запроса и получает первый пакет ответа.

  • Клиент --Web Server: клиент <получает остальные полезные данные ответа от веб-сервера.

  • Клиент: теперь клиент имеет полные полезные данные ответа и должен отобразить содержимое в браузере и загрузить DOM.

  • browserTimings/networkDuration = #1 + #2

  • browserTimings/sendDuration = #3

  • browserTimings/receiveDuration = #4

  • browserTimings/processingDuration = #5

  • browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

  • pageViews/duration

    • Длительность PageView находится в интерфейсе PerformanceNavigationTiming.durationвремени производительности браузера.

    • Если PerformanceNavigationTiming это доступно, используется эта длительность.

      Если это не так, используется устаревший PerformanceTiming интерфейс и вычисляется разность между NavigationStart нимиLoadEventEnd.

    • Разработчик задает значение длительности при регистрации пользовательских PageView событий с помощью вызова API trackPageView.

Снимок экрана: страница

Контекст

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

Версия приложения

Сведения в полях контекста приложения всегда содержат сведения о приложении, которое отправляет данные телеметрии. Версия приложения используется для анализа изменений тенденций в поведении приложения и его корреляции с развертываниями.

Максимальная длина: 1024

IP-адрес клиента

Это поле является IP-адресом клиентского устройства. Поддерживаются протоколы IPv4 и IPv6. Когда данные телеметрии отправляются из службы, контекст расположения — это пользователь, который инициировал операцию в службе. Application Insights извлекает сведения о географическом положении из IP-адреса клиента, а затем усекает его. IP-адрес клиента сам по себе не может использоваться в качестве идентифицируемых пользователем сведений.

Максимальная длина: 46

Тип устройства

Первоначально это поле использовалось для указания типа устройства, используемого пользователем приложения. Сегодня она используется в основном для различения телеметрии JavaScript с типом Browser устройства от телеметрии на стороне сервера с типом PCустройства.

Максимальная длина: 64

Идентификатор операции

Это поле является уникальным идентификатором корневой операции. Этот идентификатор позволяет группировать данные телеметрии по нескольким компонентам. Дополнительные сведения см. в разделе "Корреляция телеметрии". Запрос или представление страницы создает идентификатор операции. Все другие данные телеметрии присваивают этому полю значение содержащего запроса или просмотра страницы.

Максимальная длина: 128

Идентификатор родительской операции

Это поле является уникальным идентификатором непосредственного родительского элемента телеметрии. Дополнительные сведения см. в разделе "Корреляция телеметрии".

Максимальная длина: 128

Наименование операции

Это поле — это имя (группа) операции. Запрос или представление страницы создает имя операции. Все другие элементы данных телеметрии присваивают этому полю значение содержащего запроса или просмотра страницы. Имя операции используется для поиска всех элементов телеметрии для группы операций (например, GET Home/Index). Это свойство контекста используется для ответа на такие вопросы, как типичные исключения, создаваемые на этой странице?

Максимальная длина: 1024

Искусственный источник операции

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

Максимальная длина: 1024

ИД сеанса

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

Максимальная длина: 64

Идентификатор анонимного пользователя.

Анонимный идентификатор пользователя (User.Id) представляет пользователя приложения. Когда данные телеметрии отправляются из службы, контекст пользователя относится к пользователю, инициирующему операцию в службе.

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

Примечание.

Количество идентификаторов анонимных пользователей не совпадает с числом уникальных пользователей приложения. Число идентификаторов анонимных пользователей обычно выше, так как при каждом открытии приложения на другом устройстве или браузере или очистке файлов cookie в браузере выделяется новый уникальный идентификатор анонимного пользователя. Это вычисление может привести к подсчету одного физического пользователя несколько раз.

Идентификаторы пользователей можно перекрестно ссылаться на идентификаторы сеансов для предоставления уникальных измерений телеметрии и установления активности пользователя в течение сеанса.

Использование анонимного идентификатора пользователя для хранения имени пользователя — это неправильное использование поля. Используйте идентификатор пользователя, прошедший проверку подлинности.

Максимальная длина: 128

Идентификатор прошедшего проверку подлинности пользователя

Идентификатор пользователя, прошедший проверку подлинности, является противоположностью анонимному идентификатору пользователя. Это поле представляет пользователя с понятным именем. Этот идентификатор записывается по умолчанию с помощью AuthenticatedUserIdTelemetryInitializer пакета SDK для ASP.NET Framework.

Используйте пакет SDK Application Insights для инициализации идентификатора пользователя, прошедшего проверку подлинности, со значением, которое постоянно идентифицирует пользователя в браузерах и устройствах. Таким образом, все элементы телеметрии относятся к этому уникальному идентификатору. Этот идентификатор позволяет запрашивать все данные телеметрии, собранные для конкретного пользователя (с учетом конфигураций выборки и фильтрации телеметрии).

Идентификаторы пользователей можно перекрестно ссылаться на идентификаторы сеансов для предоставления уникальных измерений телеметрии и установления активности пользователя в течение сеанса.

Максимальная длина: 1024

Код счета

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

Максимальная длина: 1024

Облачная роль

Это поле является именем роли, в которой приложение является частью. Он сопоставляется непосредственно с именем роли в Azure. Его также можно использовать для различения микрослужб, которые являются частью одного приложения.

Максимальная длина: 256

Экземпляр облачной роли

Это поле — имя экземпляра, в котором выполняется приложение. Например, это имя компьютера для локальной среды или имени экземпляра для Azure.

Максимальная длина: 256

Внутреннее: версия SDK

Дополнительные сведения см. в разделе "Версия пакета SDK".

Максимальная длина: 64

Внутреннее: имя узла

Это поле представляет имя узла, используемое для выставления счетов. Используйте его для переопределения стандартного механизма обнаружения узлов.

Максимальная длина: 256

Часто задаваемые вопросы

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

Как измерить влияние кампании мониторинга?

Данные телеметрии PageView содержат URL-адрес и можно проанализировать параметр UTM с помощью функции regex в Kusto.

Иногда эти данные могут быть отсутствуют или неточные, если пользователь или предприятие отключает отправку агента пользователя в параметрах браузера. Регрессия средства синтаксического анализа UA может не включать все сведения об устройстве. Или Application Insights, возможно, не приняли последние обновления.

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

Это может произойти, если вы используете строковые значения. Только числовые значения работают с пользовательскими измерениями.

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

Узнайте, как использовать API Application Insights для пользовательских событий и метрик, в том числе:

Настройте отслеживание зависимостей для:

Чтобы получить дополнительные сведения, обратитесь к разделу