Troubleshoot issues with Solution Health Hub for Customer Insights - Journeys
Solution Health Hub detects issues in your Dynamics 365 environment, giving you a better picture of the state of your instances. Your environment's configuration might change over time, due to natural system operations. Solution Health Hub runs rules within an instance to validate the environment's configuration. Some of the rules are specific to Dynamics 365 Customer Insights - Journeys. You can run rules on demand when you encounter an issue. Or, you can execute rules automatically, outside of business hours. Automatic execution ensures minimal disruption to your Customer Insights - Journeys processes.
Here are a few common issues the Solution Health Hub detects:
- Whether critical Customer Insights - Journeys processes are deactivated.
- Whether processes that will cause an upgrade failure are assigned to disabled user accounts.
- Customized web resources that will later lead to runtime issues.
Prerequisites
- Customer Insights - Journeys v1.35.10057.1054 or later.
- Solution Health Hub extends the Power Apps checker to ensure continued healthy operation of an environment.
Note
Currently, the Customer Insights - Journeys rule set uses five rules to verify that the environment is in a good state.
Run a health check
To run an analysis job for Customer Insights - Journeys:
Open the Solution Health Hub app.
On the welcome screen, select Continue in the lower right.
Select Analysis Jobs and create a new analysis job.
When the dialog box opens, select Customer Insights - Journeys rule set.
Select OK and the analysis job will begin.
Below are the rules currently included for Customer Insights - Journeys:
| Rule name | What it checks |
|---|---|
| CheckIffSdkMessageProcessingStepsAreActive | Checks whether any SDK Message Processing Steps are disabled. Disabled SDK Message Processing Steps result in incorrect behavior when using Customer Insights - Journeys. |
| CheckIfProcessOwnedByDisabledUsers | Checks whether there are any process definitions in the system that are assigned to user accounts that are disabled. If that's the case, upgrading will fail. |
| CheckIfProcessesAreActive | Checks whether there are any process definitions in draft status. If there are processes in draft status, Customer Insights - Journeys will not work correctly. |
| MissingMktConfiguration | Checks for the presence of a Customer Insights - Journeys configuration entity record. If the configuration entity record is missing, Customer Insights - Journeys will not work properly. |
| MissingRolesToApplicationUser | Checks whether MarketingServices ApplicationUser has all required roles assigned. If some of the roles are missing, the Customer Insights - Journeys application might not work properly. |
| MissingFieldSecurityProfiles | Checks whether Field Security Profiles are missing. If the profiles are missing, Customer Insights – Journeys text message and push notification flows won't work properly. |
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.
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. |
Use health check results to resolve issues
In the Customer Insights - Journeys rule set, the following rules support "resolve" actions:
| Rule name | Resolve action |
|---|---|
| CheckIfSdkMessageProcessingStepsAreActive | Enables deactivated SDK message processing steps. |
| CheckIfProcessesAreActive | Enables deactivated processes that are listed in the failed records tab. |
| MissingRolesToApplicationUser | Assigns required roles back to the Customer Insights - Journeys service user. |
To resolve issues found in the Analysis Results tab, select the rule that failed, then click on the Resolve button that appears above the rules.
Opt out from automatic rule set execution
If you want to opt out from automatically executing the Customer Insights - Journeys rule set, complete the following steps:
In the Solution Health Hub, navigate to Setup in the left-hand navigation pane and click on Solution Health Rule Sets.
Select the Customer Insights - Journeys rule set.
Select Deactivate in the top ribbon.
A confirmation window will appear. Confirm that you want to deactivate the rule set by clicking the Deactivate button.
Inactive rule sets are visible in "Inactive Solution Health Rule Sets" section in the Solution Health Rule Sets. You can reactivate inactive rule sets anytime.