Troubleshoot your Dynamics 365 system with the Health Hub

The size of Dynamics 365 as a solution has grown dramatically over the last decade and when new capabilities and improvements are delivered, this is often met with unexpected behaviour such as bugs, process conflicts, user interface breaks and more. The chance of facing issues increases further when an organisation customises a system past the default environment.  When this happens, we firstly recommend you check you have configured your system correctly and trace your steps using Microsoft Dynamics 365 documentation website. If you've exhausted this and your problem hasn't been resolved, you could try to use the Dynamics 365 Health Hub.

The Solution Health Hub allows you to get a better picture of the state of your environment and detect issues with your Dynamics 365 environment.  It works by running validation rules, which each application having its own ruleset to run against. You can run these rules manually when you encounter an issue you wish to resolve, and you can also run the rules check automatically. 

If you were to run a health check on a marketing solution, it would detect:

  1. Whether critical Marketing processes are deactivated.
  2. Whether processes that will cause an upgrade failure are assigned to disabled user accounts.
  3. Customised web resources that will later lead to runtime issues.

You can create your own custom health checks, however, we believe in most scenarios, the out of the box rules should be sufficient.

How to run a health check

To run an analysis job for Marketing:

  1. Open the Solution Health Hub app.

    Screenshot of the Solution Health Hub in the navigation.

  2. On the welcome screen, select Continue in the lower right.

  3. Select Analysis Jobs and create a new analysis job.

  4. When the dialogue box opens, select the Marketing rule set.

  5. Select OK and the analysis job will begin.

    Screenshot of the Solution Health Hub with attention to the "new" option under analysis jobs

    View health check results

    Once you run the analysis job, you will be directed to the overview page. The overview page will automatically refresh when the run has finished. The following screenshot shows an example overview of a run.

    Screenshot of a complete analysis job overview.

    When running an analysis job, you will see a Return Status for each rule, which indicates whether the rule passed, failed, or there was a configuration error. Rules also return a severity if they are failing, which shows how severe each problem is. All possible return status outcomes are listed in the following table.

    Rule return status Recommendation
    Fail Highlights specific failures within the system; fix the rule as suggested.
    Warning Be aware of the implications mentioned in the rule message.
    Pass Indicates that there are no problems with this rule. All rules should be in this state.

Some rules will allow you to select and click 'resolve' which will attempt to fix related problems in the background. This button can be found above the analysis tab once a rule that has failed has been selected. 

For further analysis, you can select a rule that hasn't passed and view all of the records associated. You can export the failing records into an excel report for escalating to your consultants and partners if issues persist or for future reference. Records also contain date of the rule check and unique ID for referencing the specific health check event. 

In this example we used the Marketing application, however, you can use this across all of your applications. Hopefully, this will resolve some of the problems you encounter as you carry out activities in your Dynamics 365 solution.

Recent updates

Discover Dynamics 365 Copilot

Introducing Dynamics 365 Co Pilot

Customer Story: Toyota to Dynamics

toyota case study

CRM Buyer's Guide 2023

crm buyers guide 2023