BeyondERP.Newsletter
Menu

Setup page · System administration

Operational Insights

A setup page where you send diagnostic events from Commerce Scale Unit and point of sale devices to your own Application Insights account.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Administer system features
Menu item
OperationalInsightsMenuDisplay
Main table
OperationalInsightsParameters
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you send diagnostic events from Commerce Scale Unit and point of sale devices to your own Application Insights account.
What you do hereUse this page to turn Commerce channel events on or off per environment to help troubleshoot or debug.
ExampleFor example, BEAT sends Commerce channel events from its sandbox to one Application Insights account and production events to a separate one, entering the LCS environment ID of each environment so a database copy doesn't send events to the wrong account.
Operational Insights page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Setup › Operational Insights
Set up firstFeature management Microsoft Learn
Used next byCDX Job 1110 Microsoft Learn
Related pagesMonitoring and telemetry parameters Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Operational Insights1 screen

Use this page to turn Commerce channel events on or off per environment to help troubleshoot or debug.

  1. Screen 1

    Review the Operational Insights settings

    Go to System administration > Setup > Operational Insights

    1. In Feature management, turn on the Operational Insights feature
    2. On the Configure tab, turn on Commerce channel events
    3. On the Environments and Application Insights registry tabs, enter where the telemetry goes
    4. Select Save
    5. Run the CDX Job 1110 job, and then restart each Commerce Scale Unit
    Review the Operational Insights settings (zoomed on the outlined fields)
    Show the full screenReview the Operational Insights settings
    page title tab to open what to set or check

Steps from Microsoft

  1. In the Feature management workspace, enable the Operational Insights feature.
  2. Go to System administration > Setup > Operational Insights.
  3. On the Configure tab, set Commerce channel events to Yes.
  4. On the Environments tab, enter the LCS Environment ID and Environment mode for each environment.
  5. On the Application Insights registry tab, enter the Instrumentation Key and Environment Mode.
  6. Run the CDX Job 1110 job, and then restart each Commerce Scale Unit.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Commerce channel eventsTurns sending of Commerce diagnostic events on or off.Microsoft Learn CaptureCommerceEvents
LCS Environment IDTies settings to an environment so events aren't sent to the wrong one after a database copy.Microsoft Learn EnvironmentId

Common errors and fixes

MessageWhat to do
Events keep arriving after the feature was turned offTurning off the feature isn't enough. Set Commerce channel events to No, run CDX job 1110 and restart each Commerce Scale Unit. Microsoft Learn

Test checklist

  1. Turn on the Operational Insights feature and set Commerce channel events to Yes.
  2. Enter the LCS Environment ID and the Application Insights instrumentation key per environment mode.
  3. Run CDX job 1110 and restart each CSU in Lifecycle Services.
  4. Use POS and check that events arrive in the right Application Insights account.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Operational InsightsSeparate Application Insights accounts for production, sandbox and development, with the LCS Environment ID and Environment mode entered for every environmentLearn recommends separate accounts for data privacy, and entering environment IDs stops events from going to the wrong environment after a database copy.Which Application Insights accounts receive Commerce events?Turning off the feature in Feature management to stop events. You must set Commerce channel events to No, run CDX job 1110 and restart each Commerce Scale Unit.Test: Events reach the right account

Feature management and licence

Feature to turn onOperational Insights (Must be on)
Licence or add-inOn this system the page opens for Information technology manager, Retail service and Retail operations manager. Retail and IT administrators set it up. Operational Insights must be turned on in Feature management first.

Microsoft Learn

Solution architect

5Design impact

Shared or per companySet per environment: each environment gets its own LCS environment ID, environment mode and Application Insights instrumentation key. Microsoft Learn
Can it be undoneReversible: Set Commerce channel events to No, run CDX job 1110 and restart each CSU. Microsoft Learn
If you change it laterTo stop events, set Commerce channel events to No and run the CDX job; turning off the feature alone isn't enough. Microsoft Learn
Technical architect

6Technical

Menu itemOperationalInsightsMenuDisplay Checked in Dynamics 365
FormOperationalInsightsProvisioningForm Checked in Dynamics 365
TableOperationalInsightsParametersShown as “Table containing parameter selections for Operational Insights” in Record infoChecked in Dynamics 365
Who can open itPrivilegesMaintain Operational Insights provisioning OperationalInsightsAdminDutiesMaintain Retail Channel Reports RetailChannelReportMaintainMaintain system settings SysServerSettingsMaintain
3 security rolesRetail operations manager RetailOperationsManagerRetail service RetailServiceInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerRetail service RetailServiceRetail operations manager RetailOperationsManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, Edit, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=OperationalInsightsMenuDisplay
Data migrationLoad order: Operational Insights has no data entity in Data management, so it can't be loaded from a file or a configuration template. Enter the environment IDs and instrumentation keys by hand in each environment, because they differ per environment.Checked in Dynamics 365
Everyone

8Sources