Check the Health of Your Retail Service in Dynamics 365 for Operations with PowerShell

By Josh Lee | April 25, 2017

Check the health of your retail service in dynamics 365 for operations with powershell

A Production environment for Dynamics 365 for Operations (D365) is hosted by Microsoft and the underlying physical virtual machines are not exposed to the client. This is in stark contrast to a UAT, Test or Dev environment hosted by Microsoft for D365. The latter environments expose the RDP connection information as well as credentials which allow direct access to the VM’s as well as the underlying AOS services. This can make troubleshooting live issues a challenge in some scenarios when logging into a server is not possible.

If you have a Dynamics 365 for Operations with Retail deployment, it can be especially critical to be able to quickly check the health of the Retail Service (real-time service).  The real-time service is the backbone for the Microsoft Point of Sale (MPOS) client. It provides the communication channel between MPOS and the retail channels. Lifecycle Services (LCS) provides an Environment Monitoring portal for each service (the Retail Server is shown below), however, this requires logging into LCS, navigating to the Environment Monitoring Page and clicking on the Retail server.  You could bookmark the page for faster access, but this still won’t select the specific service view as it defaults to the AOS view.

Health_RetailServiceDynamics365forOperations_PowerShell_JoshLee1

A quick real-time service check can be performed by:

  1. Opening a web browser
  2. Entering: https:///healthcheck?testname=ping
  3. Hitting enter

This will perform a quick ping check on both the database and real-time service.  The results will show if the database and real-time service is up:

Health_RetailServiceDynamics365forOperations_PowerShell_JoshLee2

Or down:

Health_RetailServiceDynamics365forOperations_PowerShell_JoshLee3

Monitoring

With PowerShell, you could create a simple script that checks the service state, schedule it in Windows Task Scheduler to check it on a specific frequency and get failure notifications via email.  Here is a simple example of how you might accomplish this. Please note that this is a very basic example and is simply meant to demonstrate how you might accomplish this task in a few lines of code.  In a production scenario you would want a more robust solution and would not want to be prompted for credentials to email out the notification (for example use an encrypted file for the -Credential parameter rather than entering it as shown in the code below):

#Check the status of D365 Database and Retailtime Service
$retailServiceCheck = Invoke-WebRequest -URI https://prod.operations.dynamics.com/healthcheck?testname=ping

#DBCheck Results Text
$DBCheck = @($retailServiceCheck.ParsedHtml.getElementsByTagName("Table")).rows[1].cells[2].innertext

#RetaltimeServiceCheck Results Text
$RealtimeServiceCheck = @($retailServiceCheck.ParsedHtml.getElementsByTagName("Table")).rows[2].cells[2].innertext

IF($DBCheck -ne "Success")
{
    $sendEmail = $true
    $subject = "CRITICAL - D365 PING Failure!"
    $body = "Dynamics 365 for Operations DBCheck Failed.  Status is - $DBCheck"

}
ELSEIF($DBCheck -ne "Success")
{
    $sendEmail = $true
    $subject = "CRITICAL - D365 PING Failure!"
    $body = "Dynamics 365 for Operations RealtimeSerivceCheck Failed.  Status is - $RealtimeServiceCheck"
}

Send-MailMessage -SmtpServer 'smtp.office365.com' -from Me@mytenant.com' -to 'Me@mytenant.com' -body $body -bodyashtml -Priority High -UseSsl -Subject $subject -Credential Get-Credential

And here is the email notification informing you of an outage condition:

Health_RetailServiceDynamics365forOperations_PowerShell_JoshLee4

 

Related Posts

Recommended Reading:

Manage U.S. Use Tax on Purchase Orders in Dynamics 365 Finance and Operations

  Managing sales tax requirements on your business purchase can be complicated, but Dynamics 365 Finance and Operations can help […]

Read the Article
5.19.22 Dynamics CRM

How to Write a Great Support Ticket in the Stoneridge Support Portal

Submitting a support ticket through the Stoneridge Support Portal is a quick and effective way to get assistance for any […]

Read the Article

Managing Your Business Through Uncertain Times Using Dynamics 365 Finance and Operations

  Dynamics 365 Finance and Operations (F&O) can help you make informed decisions on how to move your business forward. […]

Read the Article
5.13.22 Power Platform

Using Power BI Object Level Security

  The following article will demonstrate how to use Power BI Object Level Security to disable column data based on […]

Read the Article
5.12.22 Dynamics CRM

How to Use the Stoneridge Support Portal

Stoneridge Software’s support portal is an intuitive and useful function that makes it easy for you to access resources to […]

Read the Article
5.6.22 Dynamics GP

Dynamics GP Transaction Removal: Purchase Orders

  Are you having performance issues with Purchase Orders?  Do you find that there are old Purchase Orders on your […]

Read the Article
5.5.22 Dynamics GP

The Real Story about the Long-Term Future of Dynamics GP Support

I’ve seen a number of people put forward comment that Dynamics GP is going away and you have to get […]

Read the Article

New Features in Dynamics 365 Business Central 2022 Wave 1 Release – Financial Enhancements

The Dynamics 365 Businses Central 2022 Wave 1 Release has a lot of new and exciting features to help your […]

Read the Article
4.29.22 Dynamics GP

Dynamics GP Transaction Removals: Bank Reconciliation

  This is part 2 of a 3 part series on Dynamics GP Transaction Removals. These quick tips will hopefully […]

Read the Article

Start the Conversation

It’s our mission to help clients win. We’d love to talk to you about the right business solutions to help you achieve your goals.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!

X