获取不同级别监控的监控维度值

最近更新时间: 2026-09-17 00:05:46

1. 接口描述

接口请求域名： tbdsnew.api3.fincloud.tencent.cn。

集群服务中hbase组件，hbase表分析，可以获取hbase表监控维度、集群主机维度、不同节点类型主机维度等不同维度的监控维度数据

默认接口请求频率限制：20次/秒。

接口更新时间：2024-11-29 09:12:04。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeMetricsDimension
Version 是 否 String 公共参数，本接口取值：2019-01-03
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Metric 否 否 String 指标名称，eg："EMR.78000004.HBASE.REGIONSERVER.TABLE.REQCOUNT"
示例值： 1
InstanceId 是 否 String 实例Id
示例值： tbds-1vzudj86
DimName 是 否 String 维度名称，eg："host"
示例值： host
Table 否 否 String Hbase表，用于获取hbase表的分布节点列表信息
示例值： hbase_meta
NodeType 否 否 String 节点类型，Zookeeper，NameNode，NodeManager等等
示例值： 1

3. 输出参数

参数名称 类型 描述
DimValue Array of String 维度值
注意：此字段可能返回 null，表示取不到有效值。
示例值： 1
TotalCnt Int64 维度值的数量
示例值： 1
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InternalError.OpenTSDBHttpReturnCodeNotOK 请求OpenTSDB失败。
InvalidParameter.InvalidNodeType 无效的NodeType。
ResourceNotFound.HardwareInfoNotFound 无法找到硬件信息。
InvalidParameter 参数错误。
InvalidParameter.InvalidAppId 无效参数，AppId。
ResourceNotFound.ClusterNotFound 无法找到该实例。
ResourceNotFound.ServiceNodeNotFound 服务节点没有找到。
InternalError 内部错误。

5. 示例

示例1 获取HBase选择表的host分布

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeMetricsDimension
&Metric=
&InstanceId=emr-111df6u6
&DimName=host
&Table=default_tsdb-uid
&NodeType=
&<公共请求参数>

输出示例

{
    "Response": {
        "DimValue": [
            "9.71.141.251",
            "9.71.141.4"
        ],
        "RequestId": "e3744669-c2fd-44ad-9ddb-8e007ff43a2f",
        "TotalCnt": 2
    }
}

示例2 获取监控维度

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeMetricsDimension
&Metric=
&InstanceId=emr-1rmnepqv
&DimName=host
&Table=
&NodeType=NodeManager
&<公共请求参数>

输出示例

{
    "Response": {
        "DimValue": [],
        "RequestId": "59f9ffb2-9b42-437a-b203-d828cf88346b",
        "TotalCnt": 0
    }
}

示例3 获取集群所有机器列表

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeMetricsDimension
&Metric=
&InstanceId=emr-4782e204
&DimName=host
&Table=
&NodeType=
&<公共请求参数>

输出示例

{
  "retcode": 0,
  "errmsg": "",
  "data": {
    "DimValue": [
      "10.0.0.65",
      "10.0.0.116",
      "10.0.0.114"
    ],
    "RequestId": "0f23dac9-a442-4108-8512-cb5488e6b43a",
    "TotalCnt": 3
  }
}