Azure 服务监控API调用

概述

在使用Azure的过程中，很多用户希望通过code的方式获取服务在管理门户中显示的监视信息，如虚拟机的CPU、服务总线的总消息出入数等。目前Azure的大部分服务都已经支持通过监控器的API查询和访问这些指标，使用过程中请使用2018-01-01 API版本。

本文首先介绍如何通过Rest API获取认证信息Authorization，然后以获取虚拟机CPU监控指标为示例演示

监控API的使用，最后介绍通过SDK获取监控。

获取认证Authorization(三种方式)

1、通过浏览器快速获取

在开发测试过程中，可以通过Chrome浏览器F12功能快速获取认证信息。

2、通过AD认证信息获取

关于AD应用的创建，请参考链接通过 PowerShell 获取认证凭据部分的创建示例脚本，当然也可以直接在Azure管理门户手动创建AD Application。如果是手动创建，请注意权限的授予问题，如果是第一次使用对门户不熟悉，请直接使用PowerShell脚本。

POST /b388b808-0ec9-4a09-a414-a7cbbd8b7e9b/oauth2/token?api-version=1.0 HTTP/1.1

Host: login.chinacloudapi.cn

Content-Type: application/x-www-form-urlencoded

Cache-Control: no-cache

Postman-Token: 5ea61bff-49b0-ec09-44bd-f9437d53932e

grant_type=client_credentials&resource=https%3A%2F%2Fmanagement.chinacloudapi.cn%2F&client_id=42c02c81-eff8-4dff-cc84-4e43b6ea8a6f&client_secret=123456

关于参数的获取，请参考创建AD应用脚本的说明。

3、通过账户名和秘钥获取

POST /common/oauth2/token?api-version=1.0 HTTP/1.1

Host: login.chinacloudapi.cn

Content-Type: application/x-www-form-urlencoded

Cache-Control: no-cache

Postman-Token: c35a61d2-e2af-28e9-36b2-70ef717c7013

grant_type=password&resource=https%3A%2F%2Fmanagement.chinacloudapi.cn%2F&username=tao.yu%40microsoftinternal.partner.onmschina.cn&password=123456&client_id=1950a258-227b-4e31-a9cf-717495945fc2

获取虚拟机CPU Rest请求示例

目前监控器已经支持的监控指标请参考Azure监控器支持的指标。

URL: https://management.chinacloudapi.cn/subscriptions/ecf1d1be-9348-434c-86ef-f903f7bb7001/resourceGroups/yuvmtest2/providers/Microsoft.Compute/virtualMachines/yuvmtest2/providers/microsoft.insights/metrics?metricnames=Percentage CPU&api-version=2018-01-01

Authorization：Bearer + 空格 + token

注意: Rest认证使用的是Bearer格式进行的认证，所以使用之前方式获取的token需要在前面加上"Bearer + 空格"

示例只是简单的演示了获取VM CPU的方式，用户可以根据自己的需要，调整请求的参数，获取其它类型资源的监控信息，当然也可以添加相应的过滤条件获取需要的信息。

更多示例请参考: Azure监控RESTAPI演练

使用C# SDK获取监控信息

目前关于Monitor的sdk还在Preview阶段，最新版本的sdk还无法使用VS安装。

可以安装预览版本：0.18.1-preview进行测试，(Install-Package Microsoft.Azure.Management.Monitor -Version 0.18.1-preview)

安装参考链接：Microsoft.Azure.Management.Monitor

其它包的安装

Install-Package Microsoft.Rest.ClientRuntime.Azure.Authentication -Version 2.3.4

Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 3.19.8

下面的测试Code是在Net Core环境下进行的测试。



using System;

using System.Collections.Generic;

using Microsoft.Azure.Management.Monitor;

using Microsoft.Azure.Management.Monitor.Models;

using Microsoft.IdentityModel.Clients.ActiveDirectory;

using Microsoft.Rest.Azure.Authentication;

namespace GetAzureVmMonitor

{

    namespace Vmtest

    {

        class Program

        {

            //对应虚拟机属性信息

            private const string ResourceUri = "/subscriptions/ecf1d1be-9348-434c-86ef-f903f7bb7001/resourceGroups/yuvmtest2/providers/Microsoft.Compute/virtualMachines/yuvmtest2";

            static void Main(string[] args)

            {

                //AD APPlication 信息

                string domain = "b388b808-0ec9-4a09-a414-a7cbbd811e9b";

                string clientId = "42c02c81-eff8-4df6-8884-4e43b6e11a6f";

                string clientSecret = "123456";

                //使用AD获取认证

                var credentials = ApplicationTokenProvider.LoginSilentAsync(domain, new ClientCredential(clientId, clientSecret), ActiveDirectoryServiceSettings.AzureChina).Result;

                //创建Monitor client对象

                MonitorClient monitorClient = new MonitorClient(new Uri("https://management.chinacloudapi.cn"), credentials);

                var actualMetrics = monitorClient.Metrics.List(resourceUri: ResourceUri,

                                                                metric: "Percentage CPU",

                                                                resultType: ResultType.Data

                                                                );

                IEnumerable<Metric> value = actualMetrics.Value;

                EnumerateMetrics(value);

                Console.ReadKey(true);

            }

            /// <summary>

            /// 打印输出部分结果

            /// </summary>

            /// <param name="metrics"></param>

            /// <param name="maxRecords"></param>

            private static void EnumerateMetrics(IEnumerable<Metric> metrics, int maxRecords = 5)

            {

                foreach (var metric in metrics)

                {

                    Console.WriteLine(metric.Id);

                    foreach (var test in metric.Timeseries)

                    {

                        foreach (var data in test.Data)

                        {

                            Console.WriteLine(data.TimeStamp + " : " + data.Average);

                        }

                        Console.WriteLine("----------");

                    }

                }

            }

        }

    }

}

ResourceUri 对应管理门户虚拟机的Properties -> RESOURCE ID。

参考链接

Azure 监控器文档

使用 REST 接口获取订阅下虚拟机信息

巴特西

Azure 服务监控API调用

概述

获取认证Authorization(三种方式)

1、通过浏览器快速获取

2、通过AD认证信息获取

3、通过账户名和秘钥获取

获取虚拟机CPU Rest请求示例

使用C# SDK获取监控信息

参考链接

最新文章

热门文章