获取TBDS-YARN-APP监控数据

最近更新时间: 2026-10-11 00:13:51

1. 接口描述

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

集群服务中yarn组件作业查询的作业列表中更多操作应用对比功能，获取YARNAPP监控数据

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

接口更新时间：2024-11-30 03:54:15。

接口既验签名又鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeEmrApplicationMetricData
Version	是	否	String	公共参数，本接口取值：2019-01-03
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Start	否	否	Int64	起始时间戳（精确到秒）示例值： 1748243007
End	是	否	Int64	终止时间戳（精确到秒）示例值： 1748243098
Downsample	是	否	String	数据聚合(粒度), 可选枚举值：eg.60s-avg,1m-max,5m-max,1h-max,1d-max 示例值： 30s-max
Metric	是	否	String	指标名，拼接规则EMR.${clusterid}.${metricname} ， clusterid来源DescribeInstances接口，metricname来源DescribeEmrMetricMeta接口示例值： EMR.78000005.SPARKAPP.MEMORY_SECONDS
Hosts	否	否	Array of String	主机Ip 示例值： 1
Aggregator	否	否	String	聚合方法,eg:"none"/"sum"/"avg" 示例值： 1
AppType	否	否	String	采样APP类型,eg:"SPARK" 示例值： SPARK
ApplicationId	否	否	Array of String	应用ID 示例值： ['application_1747968624851_0120']

3. 输出参数

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

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 【监控】拉取EMR YARNAPP监控数据

输入示例

POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: DescribeEmrApplicationMetricData
<公共请求参数>

{
  "Start": 1748243007,
  "End": 1748243098,
  "Metric": "EMR.78000005.SPARKAPP.MEMORY_SECONDS",
  "Downsample": "30s-max",
  "AppType": "SPARK",
  "ApplicationId": [
    "application_1747968624851_0120"
  ]
}

输出示例

{
  "Response": {
    "RequestId": "2bc03a21-29a8-4b55-93f6-2540cec97391",
    "Result": "W3siTWV0cmljIjoiRU1SLjc4MDAwMDA1LlNQQVJLQVBQLk1FTU9SWV9TRUNPTkRTIiwiVGFncyI6eyJhcHBsaWNhdGlvbklkIjoiYXBwbGljYXRpb25fMTc0Nzk2ODYyNDg1MV8wMTIwIiwidHlwZSI6Im1lbW9yeXNlY29uZHMifSwiQWdncmVnYXRlVGFncyI6W10sIkZpcnN0IjoxNzQ4MjQzMTkwLCJMYXN0IjoxNzQ4MjQzMTkwLCJJbnRlcnZhbCI6MzAsIkRwcyI6WzkwMjQ1XX1d",
    "Visualization": "Histogram"
  }
}