租户端 大数据 大数据处理套件（TBDS） 信息查询相关接口 获取某组件某角色下所有可视化展示的监控数据

获取某组件某角色下所有可视化展示的监控数据

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

1. 接口描述

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

获取某组件某角色下所有可视化展示的监控指标曲线图中的采样点数据

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

接口更新时间：2025-09-16 22:30:18。

接口既验签名又鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeEmrMetricData
Version 是 否 String 公共参数，本接口取值：2019-01-03
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Start 否 否 Int64 起始时间戳（精确到秒）
示例值： 1748247929
End 是 否 Int64 终止时间戳（精确到秒）
示例值： 1748251529
Downsample 是 否 String 下采样参数
示例值： 30s-max
Metric 是 否 String 指标名
示例值： EMR.78000005.NODE.CPU
Host 否 否 String 主机Ip
示例值： 172.16.0.89
Aggregator 否 否 String 聚合方法,eg: "sum/avg/min/max"
示例值： 1
Tags 否 否 String 过滤维度配置，支持多个维度json格式化的字符串
  {
  "env": "production",
  "service": "web",
  "queue": "queueName",
  "type": "*"
}
示例值： 1
Visualization 否 否 String 视图展现格式：Graph-曲线，Text-文本，PieChart-饼图
示例值： 1
Filters 否 否 Array of OpenTsdbFilter opentsdb请求的filter参数[  {    "Filter": "NumDeadDataNodes",    "GroupBy": false,    "Tagk": "type",    "Type": "iliteral_or"  }]
示例值：查看

3. 输出参数

参数名称 类型 描述
Result String 结果
示例值： 1
Visualization String 展现格式
示例值： 1
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码 描述
ResourceNotFound.ClusterNotFound 无法找到该实例。

5. 示例

示例1 拉取文本数据

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=1583842423
&Downsample=30s-max
&Metric=EMR.3903.HDFS.NN.STATE.FAKE
&Host=
&Aggregator=
&Tags=
&Visualization=
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "c3bdec76-a12d-4943-8c80-bcb0b0c36471",
        "Result": "WyLkuLs6IDkuNzEuMTQxLjE4Iiwi5aSHOiA5LjcxLjE0MS42OSJd",
        "Visualization": "Text"
    }
}

示例2 拉取概览页监控数据

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=1583842423
&Downsample=30s-max
&Metric=EMR.3903.YARN.RM.NUMS
&Host=
&Aggregator=
&Tags=
&Visualization=
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "4df83b10-c2f1-4949-b4c5-a6a04cdb9e2f",
        "Result": "W3siTWV0cmljIjoiRU1SLjM5MDMuWUFSTi5STS5OVU1TIiwiVGFncyI6eyJ0eXBlIjoiTnVtQWN0aXZlTk1zIn0sIkFnZ3JlZ2F0ZVRhZ3MiOlsiaG9zdCJdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlszLDMsMywzLDMsMywzLDIsMiwyLDEsMSwzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMiwyLDIsMiwyLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsMywzLDMsM119LHsiTWV0cmljIjoiRU1SLjM5MDMuWUFSTi5STS5OVU1TIiwiVGFncyI6eyJ0eXBlIjoiTnVtRGVjb21taXNzaW9uZWROTXMifSwiQWdncmVnYXRlVGFncyI6WyJob3N0Il0sIkZpcnN0IjoxNTgzODM4ODQwLCJMYXN0IjoxNTgzODQyNDEwLCJJbnRlcnZhbCI6MzAsIkRwcyI6WzAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwXX0seyJNZXRyaWMiOiJFTVIuMzkwMy5ZQVJOLlJNLk5VTVMiLCJUYWdzIjp7InR5cGUiOiJOdW1Mb3N0Tk1zIn0sIkFnZ3JlZ2F0ZVRhZ3MiOlsiaG9zdCJdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlswLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMF19LHsiTWV0cmljIjoiRU1SLjM5MDMuWUFSTi5STS5OVU1TIiwiVGFncyI6eyJ0eXBlIjoiTnVtVW5oZWFsdGh5Tk1zIn0sIkFnZ3JlZ2F0ZVRhZ3MiOlsiaG9zdCJdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlswLDAsMCwwLDAsMCwwLDEsMSwxLDIsMiwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMSwxLDEsMSwxLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMF19XQ==",
        "Visualization": "Graph"
    }
}

示例3 获取HBase region监控数据

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=0
&Downsample=30s-max
&Metric=EMR.3903.SYSTEM.FUNCTION,,1575533246481.dd02c26fd0c84b1aabee752c6f042cc8..HBASE.REGION.STAT
&Host=
&Aggregator=
&Tags=
&Visualization=
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "beffea54-8dc1-46c7-91e1-d1a1853ad288",
        "Result": "W3siTWV0cmljIjoiRU1SLjM5MDMuU1lTVEVNLkZVTkNUSU9OLCwxNTc1NTMzMjQ2NDgxLmRkMDJjMjZmZDBjODRiMWFhYmVlNzUyYzZmMDQyY2M4Li5IQkFTRS5SRUdJT04uU1RBVCIsIlRhZ3MiOnsidHlwZSI6IlJlYWRSZXF1ZXN0Q291bnQifSwiQWdncmVnYXRlVGFncyI6W10sIkZpcnN0IjoxNTgzODM4OTAwLCJMYXN0IjoxNTgzODQzNzAwLCJJbnRlcnZhbCI6MzAwLCJEcHMiOlswLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLG51bGxdfSx7Ik1ldHJpYyI6IkVNUi4zOTAzLlNZU1RFTS5GVU5DVElPTiwsMTU3NTUzMzI0NjQ4MS5kZDAyYzI2ZmQwYzg0YjFhYWJlZTc1MmM2ZjA0MmNjOC4uSEJBU0UuUkVHSU9OLlNUQVQiLCJUYWdzIjp7InR5cGUiOiJXcml0ZVJlcXVlc3RDb3VudCJ9LCJBZ2dyZWdhdGVUYWdzIjpbXSwiRmlyc3QiOjE1ODM4Mzg5MDAsIkxhc3QiOjE1ODM4NDM3MDAsIkludGVydmFsIjozMDAsIkRwcyI6WzAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsbnVsbF19XQ==",
        "Visualization": "Graph"
    }
}

示例4 拉取节点监控数据

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=1583842423
&Downsample=30s-max
&Metric=EMR.3903.HDFS.NN.STATE
&Host=9.71.141.18
&Aggregator=
&Tags=
&Visualization=
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "2422f8a3-13d4-4c49-8c83-62eb392f651c",
        "Result": "W3siTWV0cmljIjoiRU1SLjM5MDMuSERGUy5OTi5TVEFURSIsIlRhZ3MiOnsiaG9zdCI6IjkuNzEuMTQxLjE4IiwidHlwZSI6IlN0YXRlIn0sIkFnZ3JlZ2F0ZVRhZ3MiOltdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlsxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMV19XQ==",
        "Visualization": "Graph"
    }
}

示例5 获取饼图数据

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=1583842423
&Downsample=30s-max
&Metric=EMR.3903.HBASE.REGIONSERVER.SERVER.HFILES.PERCENT
&Host=
&Aggregator=
&Tags=
&Visualization=
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "f32a2bc9-f753-43da-a503-dc2b7d4127c5",
        "Result": "W3siVGFnIjoi5YW25LuWIiwiVmFsdWUiOjEwMCwiUGVyY2VudGFnZSI6MTAwfSx7IlRhZyI6IuWNoOavlCIsIlZhbHVlIjowLCJQZXJjZW50YWdlIjowfV0=",
        "Visualization": "PieChart"
    }
}

示例6 文本数据查看趋势

输入示例

https://emr.api3.{{conf.domain_main}}/?Action=DescribeEmrMetricData
&Start=1583838819
&End=1583842423
&Downsample=30s-max
&Metric=EMR.3903.HDFS.NN.STATE.FAKE
&Host=
&Aggregator=
&Tags=
&Visualization=Graph
&<公共请求参数>

输出示例

{
    "Response": {
        "RequestId": "f01d6411-34c1-4294-b8ff-cc40dd7bff96",
        "Result": "W3siTWV0cmljIjoiRU1SLjM5MDMuSERGUy5OTi5TVEFURSIsIlRhZ3MiOnsiaG9zdCI6IjkuNzEuMTQxLjE4IiwidHlwZSI6IlN0YXRlIn0sIkFnZ3JlZ2F0ZVRhZ3MiOltdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlsxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMSwxLDEsMV19LHsiTWV0cmljIjoiRU1SLjM5MDMuSERGUy5OTi5TVEFURSIsIlRhZ3MiOnsiaG9zdCI6IjkuNzEuMTQxLjY5IiwidHlwZSI6IlN0YXRlIn0sIkFnZ3JlZ2F0ZVRhZ3MiOltdLCJGaXJzdCI6MTU4MzgzODg0MCwiTGFzdCI6MTU4Mzg0MjQxMCwiSW50ZXJ2YWwiOjMwLCJEcHMiOlswLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMCwwLDAsMF19XQ==",
        "Visualization": "Graph"
    }
}