{"id":7595,"date":"2017-04-06T14:44:00","date_gmt":"2017-04-06T14:44:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/premier_developer\/?p=7595"},"modified":"2019-03-05T15:25:07","modified_gmt":"2019-03-05T22:25:07","slug":"how-to-use-azure-resource-health-api-to-gain-visibility-into-the-health-of-a-vm-web-app-or-sql-database","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/premier-developer\/how-to-use-azure-resource-health-api-to-gain-visibility-into-the-health-of-a-vm-web-app-or-sql-database\/","title":{"rendered":"How to use Azure Resource Health API to gain visibility into the health of a VM, Web App or SQL Database"},"content":{"rendered":"

In this post, Principal Application Development Manager, Rick Caudle<\/a>, demonstrates how to use Azure Resource Health API to query the health of Azure services.<\/p>\n

\n

As a developer, I am always interested ways to gain deeper insight into the health of the resources that my solutions are deployed to, especially if an API is involved!\u00a0 I mean, what developer wouldn’t like this?\u00a0 Today, we are going to take a look at how to use the Azure Resource Health API to check the health status of a VM (you can also do this for other resources).<\/p>\n

Azure Resource Health is also exposed to you via the Azure Portal via the Resource Health Blade, you can check here<\/a> to quickly navigate to the blade within one of your subscriptions.\u00a0 Please read the post<\/a> by Bernardo Mu\u00f1oz for a full description of Azure Resource Health.<\/p>\n

Let’s get right into it.<\/p>\n

Important notes about using the Azure Resource Health API<\/b><\/h3>\n

In Bernardo\u2019s post, he assumes you are familiar with using the ARM API, how to authenticate, etc.\u00a0 I won’t cover all that as there are several posts on these topics already, but I want to call out the fact that if you read his post and you have never used the ARM API, you may assume that a simple POST & GET using the URL\u2019s he outlined is all that is needed, when in fact, there are things that need to be done before using those REST endpoints.<\/p>\n

For this post, I use the ARMClient.exe to make things simple for the purpose of this example (in a future post, I will demonstrate how to do this from Automation and post results to a message queue).<\/p>\n

Using the API to check the Health of a VM<\/h3>\n
    \n
  1. First, install the ARMClient tool by following the procedure outlined in the following post<\/a>.\u00a0 If you wish to use a different approach to install the tool that is fine as well.\u00a0 Side note:<\/b> I have to agree with David Ebbo if you don’t have Chocolatey<\/a> installed, you are missing out!<\/li>\n
  2. Next thing we need is the subscription ID of where the resource exists.\u00a0 You can click here<\/a> to navigate to the subscription blade to pull the subscription ID.<\/li>\n
  3. Authenticate to Azure (2 ways to do this): 1- use manual approach or 2- Use a Service Principal – see following post<\/a> on what it is and how to create one.\u00a0 For this example, I am going to leverage the Login feature of the ARMClient\n
      \n
    1. Open a Command Prompt and run the following ARMClient command from a Command Prompt: ARMClient Login\nThe following dialog box will appear asking you to log into Azure:\n\"\"\nEnter your credentials and sign in.<\/li>\n<\/ol>\n<\/li>\n
    2. In the Command Window you will see the following type of welcome output from the ARM Client after entering your credentials:\n\"\"\nThis response verifies that you have authenticated and it will list the tenant and subscription details associated with your account. At this point we can make use of the URLs that Bernardo outlines in his post<\/a>.<\/li>\n
    3. Let’s use the ARMClient to run three different types of GET requests. Please note that you will need to replace <subid>, <ResourceGroupName> <\/b>with the subscription ID and resource group name you are pulling the results from.<\/li>\n<\/ol>\n

      GET the Health of all the resources in a subscription:<\/b><\/h3>\n

      Run the following command from the Command Prompt making sure to replace <SubID> <\/b>with the SubID <\/b>you collected in the earlier step.<\/p>\n

      ARMClient GET armclient GET \/subscriptions\/<SubID><\/strong>\/providers\/Microsoft.ResourceHealth\/availabilityStatuses?api-version=2015-01-01\r\n\r\n<\/pre>\n
      Results:\n\"\"\n<\/b>\u00a0GET Health of all the resources in a resource group:<\/span><\/p>\n
      Example:\n<\/b><\/p>\n
      ARMClient GET \/subscriptions\/<SubID>\/<\/strong>resourceGroups\/<ResourceGroupName><\/strong>\/providers\/Microsoft.ResourceHealth\/availabilityStatuses?api-version=2015-01-01<\/pre>\n
      Results:<\/b>\n\"\"<\/p>\n
      GET Health of a single resource<\/span><\/h3>\n
      The following example checks the health of a VM deployed as a classic VM.\u00a0 If you have a VM deployed under ARM, you would use the Microsoft.Compute provider.\u00a0 For more details on the various providers you can read the following post<\/a> or you can click here<\/a> to open resource provider blade in the portal.\nExample:\n<\/b><\/p>\n
      ARMClient GET \/subscriptions\/0f10767b-d7c8-47a5-8287-b26227ccad2a\/resourceGroups\/VS2015DevRDC\/providers\/Microsoft.ClassicCompute\/virtualMachines\/VS2015DevRDC\/providers\/Microsoft.ResourceHealth\/availabilityStatuses\/current?api-version=2015-01-0<\/pre>\n
      Result:\n<\/b>\"\"\n<\/a><\/p>\n
      That does it for this post.\u00a0 Stay tuned and for my next post I will likely dive into how to do this from Azure Automation, PowerShell, or something else that would be fun to play with.<\/p>\n
      \n
      Premier Support for Developers<\/a><\/strong> provides strategic technology guidance, critical support coverage, and a range of essential services to help teams optimize development lifecycles and improve software quality.\u00a0 Contact your Application Development Manager (ADM) or email us<\/a> to learn more about what we can do for you.<\/p>\n","protected":false},"excerpt":{"rendered":"
      In this post, Principal Application Development Manager, Rick Caudle, demonstrates how to use Azure Resource Health API to query the health of Azure services. As a developer, I am always interested ways to gain deeper insight into the health of the resources that my solutions are deployed to, especially if an API is involved!\u00a0 I […]<\/p>\n","protected":false},"author":582,"featured_media":37840,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[25],"tags":[24,3],"class_list":["post-7595","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure","tag-azure","tag-team"],"acf":[],"blog_post_summary":"
      In this post, Principal Application Development Manager, Rick Caudle, demonstrates how to use Azure Resource Health API to query the health of Azure services. As a developer, I am always interested ways to gain deeper insight into the health of the resources that my solutions are deployed to, especially if an API is involved!\u00a0 I […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/7595","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/users\/582"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/comments?post=7595"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/posts\/7595\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media\/37840"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/media?parent=7595"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/categories?post=7595"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/premier-developer\/wp-json\/wp\/v2\/tags?post=7595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}