如何在Azure虚拟机指标API调用中按LUN拆分数据磁盘队列深度？

问题描述 #

我正遵循Azure官方文档从Azure导出指标，目前编写的PowerShell代码可以正常获取所有指标，代码如下：

$uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($resourceGroup)/providers/Microsoft.Compute/virtualMachines/$($vmname)/providers/microsoft.insights/metrics?api-version=2024-02-01&metricnames=$($metricName)&interval=PT5M"
$data = Invoke-RestMethod -Method GET -Uri $uri -Headers $header 

但我需要按LUN拆分数据磁盘队列深度（Data Disk Queue Depth）指标。文档显示该指标支持维度，但仅说明“维度 - 指标可用的维度”，相关维度文档只解释了概念，没说明如何通过API调用实现筛选/拆分。请问如何在API调用中按维度进行拆分/筛选？

解决方案 #

要实现按LUN维度拆分或筛选数据磁盘队列深度指标，只需在API请求URL中添加对应的参数即可，具体步骤如下：

1. 必须添加aggregation参数 #

维度拆分依赖明确的指标聚合方式，对于磁盘队列深度，常用的聚合类型包括Average（平均值）、Maximum（最大值）或Minimum（最小值），根据需求选择即可。

2. 可选：添加filter参数筛选特定LUN #

如果只需要获取某个特定LUN的指标数据，使用filter参数指定LUN编号，格式为filter=LUN eq '<LUN编号>'。

3. 可选：添加timespan参数指定时间范围 #

若需要限定指标的时间区间，添加timespan=开始时间/结束时间，时间格式需遵循ISO 8601标准，例如2024-05-01T00:00:00Z/2024-05-01T01:00:00Z。

示例代码 #

筛选特定LUN的指标数据

# 配置参数
$lunNumber = "0"
$aggregation = "Average"
$timespan = "2024-05-01T00:00:00Z/2024-05-01T01:00:00Z"

# 构造请求URL
$uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($resourceGroup)/providers/Microsoft.Compute/virtualMachines/$($vmname)/providers/microsoft.insights/metrics?api-version=2024-02-01&metricnames=DataDiskQueueDepth&interval=PT5M&aggregation=$($aggregation)&filter=LUN eq '$($lunNumber)'&timespan=$($timespan)"

# 发起请求
$data = Invoke-RestMethod -Method GET -Uri $uri -Headers $header 

获取所有LUN的拆分数据

如果需要获取所有LUN的指标数据，去掉filter参数即可，API会返回每个LUN对应的独立指标序列：

# 配置参数
$aggregation = "Average"

# 构造请求URL
$uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($resourceGroup)/providers/Microsoft.Compute/virtualMachines/$($vmname)/providers/microsoft.insights/metrics?api-version=2024-02-01&metricnames=DataDiskQueueDepth&interval=PT5M&aggregation=$($aggregation)"

# 发起请求
$data = Invoke-RestMethod -Method GET -Uri $uri -Headers $header 

返回结果中，$data.value[0].timeseries数组的每个元素对应一个LUN的指标数据，可通过metadata字段查看对应的LUN编号。

内容的提问来源于stack exchange，提问作者MHU