获取metric的标签值(GetMetricLabelValue)
多数Metric包含一个或多个标签用于描述该metric的元数据。例如namespace
ZStack/Host的metric
CPUIdleUtilization包含HostUuid和CPUNum用于描述CPU的Idle值是属于哪个物理机的哪个CPU。
用户可以通过GetMetricLabelValue获得某个metric的标签的可能值。例如系统中由两个物理机,则HostUuid的可能值有两个分别为这两个物理机的UUID。GetMetricLabelValue namespace=ZStack/Host metricName=CPUIdleUtilization labelNames=CPUNum,HostUuid参数(Parameters)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| namespace | 名字空间名称 | 2.3 | ||
| metricName | 2.3 | |||
| labelNames | 要获取值得标签名列表 | 2.3 | ||
| filterLabels | 标签过滤器列表,例如可以指定标签HostUuid=e47f7145f4cd4fca8e2856038ecdf3e1来选择特定物理主机的,labelNames中指定标签的值 | 是 | 2.3 | |
| userTags | 用户标签,请参见 创建用户标签(CreateUserTag) | 是 | 2.3 | |
| systemTags | 系统标签,请参见 创建系统标签(CreateSystemTag) | 是 | 2.3 | |
| timeout | 是 |
返回:
{
"labels": [
{
"CPUNum": "0",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "1",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "2",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "3",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "4",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "5",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "6",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
},
{
"CPUNum": "7",
"HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11"
}
],
"success": true
}-
用户可以用
filterLabels指定过滤条件,例如只返回HostUuid=a133cbcfdc1d462c9b51d7bce6ac6b11所有CPUNum的可能值:GetMetricLabelValue namespace=ZStack/Host metricName=CPUIdleUtilization labelNames=CPUNum filterLabels=HostUuid=a133cbcfdc1d462c9b51d7bce6ac6b11 filterLabels可以指定多个。GetMetricLabelValue namespace=ZStack/Host metricName=CPUIdleUtilization labelNames=CPUNum filterLabels=HostUuid=a133cbcfdc1d462c9b51d7bce6ac6b11,CPUNum=1{ "labels": [ { "CPUNum": "1", "HostUuid": "a133cbcfdc1d462c9b51d7bce6ac6b11" } ], "success": true }