你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 Azure Monitor CLI 获取负载均衡器指标
在本文中，你将了解一些使用 Azure Monitor CLI 列出负载均衡器指标的示例。
az monitor metrics 参考中提供了使用 Azure Monitor CLI 检索指标的完整参考文档和其他示例。
通过 CLI 列出指标名称表
使用 CLI 时，负载均衡器指标可能为 CLI 参数值使用不同的指标名称。 通过 --metric dimension 参数指定指标名称时，请改用 CLI 指标名称。 例如，可以通过指定 --metric VipAvaialbility 参数来使用指标数据路径可用性。
下面是常见负载均衡器指标、CLI 指标名称以及查询的建议聚合值表格：
| 指标 | CLI 指标名称 | 建议的聚合 |
|---|---|---|
| 数据路径可用性 | VipAvailability | 平均值 |
| 运行状况探测状态 | DipAvailability | 平均值 |
| SYN（同步）计数 | SYNCount | 平均值 |
| SNAT 连接计数 | SnatConnectionCount | SUM |
| 已分配的 SNAT 端口数 | AllocatedSnatPorts | 平均值 |
| 已用 SNAT 端口数 | UsedSnatPorts | 平均值 |
| 字节计数 | ByteCount | SUM |
| 数据包计数 | PacketCount | Sum |
有关指标定义和其他详细信息，请参阅监视负载均衡器数据参考。
负载均衡器指标的 CLI 示例
az monitor metrics 命令用于查看 Azure 资源指标。 若要查看可用于标准负载均衡器的指标定义，请运行 az monitor metrics list-definitions 命令。
# Display available metric definitions for a Standard Load Balancer resource
az monitor metrics list-definitions --resource <resource_id>
注意
在以下所有示例中，请将 <resource_id> 替换为标准负载均衡器的唯一资源 ID。
若要检索资源的标准负载均衡器指标，可以使用 az monitor metrics list 命令。 例如，使用 --metric DipAvailability 选项从标准负载均衡器收集运行状况探测状态指标。
# List the Health Probe Status metric from a Standard Load Balancer
az monitor metrics list --resource <resource_id> --metric DipAvailability
运行上述命令时，运行状况探测状态的输出将类似于：
user@Azure:~$ az monitor metrics list --resource <resource_id> --metric DipAvailability
{
"cost": 59,
"interval": "0:01:00",
"namespace": "Microsoft.Network/loadBalancers",
"resourceregion": "eastus2",
"timespan": "2022-06-30T15:22:39Z/2022-06-30T16:22:39Z",
"value": [
{
"displayDescription": "Average Load Balancer health probe status per time duration",
"errorCode": "Success",
"errorMessage": null,
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
"name": {
"localizedValue": "Health Probe Status",
"value": "DipAvailability"
},
"resourceGroup": "myResourceGroup",
"timeseries": [],
"type": "Microsoft.Insights/metrics",
"unit": "Count"
}
]
}
...
可以使用 –-aggregation 参数指定指标的聚合类型。 有关建议的聚合，请参阅“监视负载均衡器数据参考”](./monitor-load-balancer-reference.md)。
# List the average Health Probe Status metric from a Standard Load Balancer
az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average
若要指定指标的间隔，请使用 --interval 参数并以 ##h##m 格式指定值。 默认间隔为 1 分钟。
# List the average List the average Health Probe Status metric from a Standard Load Balancer in 5 minute intervals
az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average --interval 5m
默认情况下，az monitor metrics list 返回过去一小时的资源聚合指标。 可以使用 --start-time 和 --end-time 查询一段时间内的指标数据，格式为日期 (yyyy-mm-dd) 时间 (hh:mm:ss.xxxxx) 时区 (+/-hh:mm)。 若要列出从 2022 年 5 月 5 日到 2022 年 5 月 10 日每天的运行状况探测状态的聚合平均值，请使用以下命令：
# List average Health Probe Status metric aggregated per day from May 5, 2022 and May 10, 2022.
az monitor metrics list --resource <resource_id> --metric DipAvailability --start-time 2022-05-01T00:00:00Z --end-time 2022-05-10T00:00:00Z --interval PT24H --aggregation Average
注意
开始和结束时间使用 yyyy-mm-dd 格式表示。 例如，从 2022 年 5 月 5 日到 2022 年 5 月 10 日的每一天将表示为 2022-05-01 和 2022-05-10。
若要按维度（例如“BackendIPAddress”）拆分指标，请在 --filter 标志中指定维度。 指标维度是包含更多数据来描述指标值的名称/值对。 若要详细了解每个指标支持哪些维度，请参阅监视负载均衡器数据参考。
# List average Health Probe Status metric and filter for all BackendIPAddress dimensions
az monitor metrics list --resource $res --metric DipAvailability --filter "BackendIPAddress eq '*'" --aggregation Average
还可以指定特定的维度值。
# List average Health Probe Status metric and filter for the 10.1.0.4 BackendIPAddress dimension
az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '10.1.0.4'" --aggregation Average
如果需要按多个维度值进行筛选，请指定 --filter 并在值之间使用 and。
# List average Health Probe Status metric and filter for all BackendIPAddress and BackendPort dimensions
az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '*' and BackendPort eq '*'" --aggregation Average
后续步骤
- 查看指标定义以更好地了解每个定义的生成方式
- 为负载均衡器创建连接监视器
- 创建自己的工作簿，你可以通过在详细指标仪表板中单击“编辑”按钮来汲取灵感