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

Настройка оперативной аналитики

  • Статья

В этой статье описывается, как настроить и использовать функцию оперативной аналитики в Microsoft Dynamics 365 Commerce.

Оперативная аналитика — это функция Dynamics 365 Commerce, которая предназначена для предоставления клиентам улучшенного представления о работоспособности и бизнес-функциях, отправляя телеметрические сведения непосредственно на счет Application Insights, принадлежащий клиенту.

При включении оперативной аналитики для вашей среды в Commerce headquarters можно собрать проверенный список событий как из Commerce Scale Unit (CSU), так и из POS-устройства. Эти события помогут лучше понять, как работают системы, и позволяют отслеживать ключевые технические и деловые показатели.

Даже если вы не хотите все время собирать эту телеметрию, вы можете воспользоваться преимуществом, быстро включив или отключив сбор для конкретных сред. Таким образом, телеметрия может помочь в устранении неполадок или отладке на этапе разработки или в производстве.

Журналы доступа в Application Insights

Чтобы получить доступ к журналам событий диагностики для компонентов Commerce CSU и POS через Application Insights, выполните процедуры, описанные в этом разделе.

Минимальные требования к версии для CSU

CSU имеет следующие минимальные требования к версии:

  • 10.0.23 (Retail Server версии 9.33.22062.15 и более поздних)
  • 10.0.24 (Retail Server версии 9.34.22062.14 и более поздних)
  • 10.0.25 (Retail Server версии 9.35.22062.13 и более поздних)
  • 10.0.26 и позднее (все версии)

Включение диагностических событий в Application Insights

Важно

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

Для включения событий диагностики компонента Commerce необходимо иметь учетную запись Application Insights. Вы можете использовать существующую учетную запись или создать новую учетную запись. Для обеспечения конфиденциальности данных рекомендуется использовать отдельные учетные записи Application Insights для рабочих сред, сред песочницы и сред разработки. После создания счета необходимо включить функцию Оперативная аналитика в Headquarters.

Чтобы включить события диагностики в Application Insights, выполните следующие действия.

  1. В headquarters откройте рабочую область Управление функциями и включите функцию Оперативная аналитика.
  2. Перейдите в раздел Администрирование системы > Настройка > Оперативная аналитика.
  3. На вкладке Настройка задайте для параметра События канала Commerce значение Да.
  4. На вкладке Среды введите значения Код среды LCS и Режим среды для каждой среды, в которой планируется использовать Application Insights. Идентификатор среды каждой среды можно найти на странице Сведения о среде для этой среды в Microsoft Dynamics Lifecycle Services. Этот шаг требуется для предотвращения непреднамеренного отсылки диагностических событий в неправильную среду при выполнении операций копирования базы данных.
  5. На вкладке Реестр Application Insights укажите значение Ключ инструментирования Application Insights и соответствующее значение Режим среды для сред, в которых планируется использовать каждую из этих учетных записей Application Insights.
  6. После выполнения предыдущей настройки необходимо выполнить задание Задание CDX 1110. Можно подождать, пока это задание будет запущено по его собственному графику, или можно выполнить его вручную.
  7. В Lifecycle Services перейдите в раздел Сведения о среде > Commerce > Управление, выберите экземпляр CSU, затем выберите Перезапустить. Повторите этот шаг для каждого CSU.
  8. Повторите предыдущие шаги для каждой среды, в которой планируется использовать Application Insights.

Примечание

  • События телеметрии в оперативной аналитике могут изменяться. Рекомендуется использовать события оперативной аналитики, чтобы выполнить предварительный анализ и устранение неполадок самостоятельно, но не определять панели мониторинга или оповещения. При использовании событий для целей за пределами самостоятельного устранения неполадок рекомендуется проверять и обновлять запросы после каждой версии CSU/POS.
  • По состоянию на версию Commerce 10.0.29 процедуры, описанные в этом разделе, также позволяют включить потоковую передачу событий оперативной аналитики POS в вашу учетную запись Application Insights. Дополнительные сведения см. в разделе Оперативная аналитика для POS — события и запросы.

Использование файла DLLHost.exe.config для управления событиями оперативной аналитики POS

Чтобы использовать файл DLLHost.exe.config для управления событиями оперативной аналитики POS, выполните следующие действия.

  1. В текстовом редакторе откройте файл DLLHost.exe.config по пути C:\Program Files (x86)\Microsoft Dynamics 365\70\Retail Modern POS\ClientBroker.
  2. В разделе diagnosticsSection удалите XML-элемент Sink с именем класса Microsoft.Dynamics.Retail.Diagnostics.OperationalInsights.OperationalInsightsLogger.
  3. Сохраните файл.

Отключение диагностических событий в Application Insights

Важно

Если необходимо отключить события диагностики и больше не отправлять их в Application Insights, необходимо выполнить следующую процедуру. Вы не можете просто отключить эту функцию в управлении функциями.

Чтобы отключить события диагностики в Application Insights, выполните следующие действия.

  1. В Headquarters перейдите в раздел Администрирование системы > Оперативная аналитика.
  2. На вкладке Настройка задайте для параметра События канала Commerce значение Нет.
  3. После выполнения предыдущей настройки необходимо выполнить задание Задание CDX 1110. Можно подождать, пока это задание будет запущено по его собственному графику, или можно выполнить задание вручную.
  4. В Lifecycle Services перейдите в раздел Сведения о среде > Commerce > Управление, выберите экземпляр CSU, затем выберите Перезапустить. Повторите этот шаг для каждого CSU.
  5. Повторите предыдущие шаги для каждой среды, в которой планируется отключить Application Insights.

Чтобы отключить события диагностики для одной среды, удалите ключ инструментирования на вкладке Реестр Application Insights страницы Оперативная аналитика. Затем выполните шаги 3 и 4 предыдущей процедуры.

Примечание

В версии Commerce 10.0.29 и новее шаги, описанные в этом разделе, отключают потоковую передачу событий оперативной аналитики POS в вашу учетную запись Application Insights.