Manage Tenant-Specific Notifications

You can get notified of administrative events that occur on environments in a Business Central online tenant. For example, we send notifications when a major update is available for environments, when an environment update has succeeded or failed, or when extensions require changes to be compatible with an upcoming update. When these and other similar events occur on the tenant, an email is sent to the notification recipients for the tenant.

Communication channels

Environment lifecycle events are communicated through various channels, each with their own benefits.

Email notification

Notifications are sent to all email addresses that are listed in the Notification recipients list of the Business Central administration center. Manage the list manually by adding and removing recipients to ensure the right individuals are notified of the event.

Microsoft 365 Message Center

Most environment lifecycle events that emails are sent for will soon also be posted to Microsoft 365 Message Center. Over time, emails that are sent to the specified notification recipients will be a subset of the messages that are posted in Message Center. Eventually, emails sent to notification recipients will be deprecated.

Already now, we warmly recommend that you make sure that the relevant people sign up to receive email notifications from the Message center. For more information, see the article Message center in the Microsoft 365 admin content.

If you're a delegated admin, you might not be able to sign up yourself. In those cases, ask the internal admin to add you or a group email account as recipients. Also, in some scenarios where your organization manages multiple tenants, you might want to use the service communications API in Microsoft Graph to access the health status and message center posts about Business Central. For more information, see Access service health and communications in Microsoft Graph.

Microsoft 365 Service Health Dashboard

Both as an internal admin and as a delegated admin, you can help users determine the cause of their problems in different ways before you have to escalate the issue to Microsoft Support. The starting point is the Business Central administration center where you can access telemetry for the tenant and check the status of already reported outages. For more information, see Managing Production and Sandbox Environments in the Admin Center.

The Microsoft 365 admin center provides an overview of service health across Microsoft services. Select Preferences to receive service health email notifications about incidents across Business Central, Microsoft 365, and other Microsoft services. For more information, see How to check service health. If you manage more than one tenant, see View service health for all accounts.

As a partner, use the Partner Center to get an overview of service health for each customer. For more information, see Check service health for a customer in the Partner Center content. You can also use APIs for automated service notifications for Azure Insights & Office 365 service communications.

Telemetry in Application Insights

Application Insights telemetry includes the most complete list of Environment Lifecycle events, and can better be used for automation and reporting purposes than the other communication channels.

Learn more about Environment Lifecycle trace telemetry here.

Customize notifications and automation

Azure Logic Apps and Power Automate have built-in connectors to query telemetry in Application Insights that you can use to set up custom notifications or to automate certain actions triggered by an environment lifecycle event.

Learn more about alerts on telemetry events here.

Example: Grouped notification for available updates

This Logic App runs every number of days (specified in deployment) and lists all updates made available to environments that emit telemetry to the specified Application Insights resource for the specified period. Administrators can use this to replace the many email notifications they would receive for each individual enviroment when set up as notification recipient.

Example: Notification for deleted environment

This Logic App queries Application Insights every number of minutes (specified in deployment) and notifies a user (also specified in deployment) of any deleted environments in Microsoft Teams. The action that sends the notification in Teams can be updated to notify a Channel or Group Chat instead.

Example: Take action on failed environment updates

This Logic App runs a query that returns any failed environment updates ever number of hours (specified in deployment). Customize the Logic App after deploying to action the failed update, for example by opening a case in Dynamics 365 Customer Service using the Dataverse connector.

Example: Post adaptive cards in Teams for each available environment update

This Logic App queries Application Insights every number of minutes (specified in the deployment) and posts an adaptive card to a specified Microsoft Teams channel for each environment that has an update available. Based on the user's choice, the Logic App will call the Business Central admin center API using an authorized service-to-service Microsoft Entra app (configuration details specified in the deployment). The adaptive card gives the user four choices:

• Schedule the update as soon as possible ("Run Now"), and allow the update to start outside of the update window for the environment
• Reschedule the update to a specified other day
• Ignore information about the update and close the card
• Open the admin center

Example: Post adaptive cards in Teams for user permission errors

This Logic App queries Application Insights every number of minutes (specified in the deployment) and posts adaptive cards to a specified Microsoft Teams channel for each permission error users in environments emitting telemetry to the specified Application Insights resource have encountered. Using the adaptive card, administrators can open Business Central to assign the needed permissions to the user.

Reporting

To help you analyze Business Central telemetry, find the Power BI app in Microsoft AppSource. This app includes an Administration report which shows an inventory of environments including various environment operations details built with the environment lifecycle telemetry in Application Insights. Learn more here, or get it immediately from Microsoft AppSource.

Admin center operations page

The operations page does not notify you of environment lifecycle events, but does provide some details on these operations that are not available in other channels, like the email address of the user that executed an operation. Learn more here.

Overview of communication channels

The following table illustrates how we communicate about the different environment lifecycle events and other communication scenarios on the different channels.

-	Application Insights	Email Notification	Microsoft 365 Message Center[1]	Microsoft 365 Service Health Dashboard	Tenant Admin Center Operations Page
Environment Created
Update Available
Update Scheduled
Updates Postponed/Resumed
Update Started
Update Succeeded/Failed[2]
Environment Hotfix
Environment Restart
Environment Started/Stopped
Environment Copy
Environment Restore
Environment Microsoft Entra tenant Move
Cancel Session
Database Export					Export History Page
Environment Setting Change [3]
Environment Deleted
Environment Renamed
AppSource App Install/Update Scheduling
AppSource App/PTE Install/Update
AppSource App Uninstall Scheduling
AppSource App/PTE Uninstall
AppSource App/PTE Dependency Install & Update Orchestration
Installed PTE incompatible with next version
Service Incidents and Advisories
Feature Change and Deprecation Announcements

¹Messages for environment lifecycle events are coming to Microsoft 365 Message Center soon.

²Application Insights and Operations page include full failure details, email notification and Message Center cover fewer failure reasons but include mitigation steps.

³Examples of setting changes include changes to the environment update window, assigned security groups, and Application Insights settings.

Notification of blocked updates

Microsoft updates environments according to the update windows that are defined for the environment in the Business Central administration center. However, if the environment includes an app that isn't compatible with the next version, Microsoft pauses the update and sends a notification of the issue.

After a while, all users see an in-product notification, which may confuse some people. But Microsoft wants to update the environment, so an admin must disable and remove the problematic app so that the update can continue. After more than a month of waiting, Microsoft sends a more strongly worded notification. If the environment is still blocked from getting the update after more than 4-5 months, Microsoft uninstalls the problematic app, but doesn't delete any data. The environment is updated with the latest security and other updates.

The following list illustrates a typical timeline:

• 10 weeks of emails sent to the registered notification recipients.

  If the update fails, Microsoft reschedules automatically. The notification recipients will receive multiple emails. If no notification recipient has been set up, then no email is sent.

• Six weeks with in-product notifications that encourage users to contact their admin.

  This notification currently indicates that the environment will expire to worry users so they try to find their admin to sort out things.

• One month of more explicit in-product notifications

  This notification currently indicates that the environment is missing an important update and is blocked. The wording has been chosen to make it clearer what the issue is and what the user must do as quickly as possible.

If the problematic app hasn't been uninstalled at this point, Microsoft typically starts the process of force-uninstalling apps, including per-tenant extensions. Data isn't deleted.

For more information about updates, see Major Updates and Minor Updates for Business Central Online. For more information about how to keep your Business Central compliant with upcoming updates, see Maintain AppSource Apps and Per-Tenant Extensions in Business Central Online.

Cleaning up settings

If you end the relationship with a customer where you have set up your email address as a notification recipient, you must remove the email address while you still have access to that customer's Business Central administration center.

See also

Managing Updates in the Business Central Admin Center
The Business Central Administration Center
Managing Environments
Introduction to automation APIs
Working with Administration Tools