获取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 }