获取metric的标签值(GetMetricLabelValue)

多数Metric包含一个或多个标签用于描述该metric的元数据。例如namespace ZStack/Host的metric CPUIdleUtilization包含HostUuidCPUNum用于描述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
    }