获取应用的分析结果

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

1. 接口描述

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

集群服务中yarn组件作业查询中的作业列表选择spark 作业，更多操作的应用洞察。获取分析结果

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

接口更新时间：2024-11-01 11:56:01。

接口既验签名又鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeAppAnalysisResults
Version 是 否 String 公共参数，本接口取值：2019-01-03
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
YarnAppId 是 否 String yarn应用id
示例值： application_1747999311100_0005
InstanceId 是 否 String emr集群id
示例值： tbds-2fifau5y
StartTime 否 否 Int64 应用开始执行时间
示例值： 1748240835
FinishTime 否 否 Int64 应用结束执行时间
示例值： 1748241280
YarnAppType 是 否 String yarn应用type
示例值： SPARK

3. 输出参数

参数名称 类型 描述
AppAnalysisResults Array of AppAnalysisResult 分析结果数组
注意：此字段可能返回 null，表示取不到有效值。
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码 描述
FailedOperation.GetMonitorInfoFailed 监控信息异常。
FailedOperation 操作失败。
InvalidParameter.ImpalaQueryException impala查询参数异常。
ResourceNotFound.ClusterNotFound 无法找到该实例。

5. 示例

示例1 获取应用的分析结果

输入示例

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

{
  "InstanceId": "tbds-2fifau5y",
  "YarnAppId": "application_1747999311100_0005",
  "YarnAppType": "SPARK",
  "StartTime": 1748240835,
  "FinishTime": 1748241280
}

输出示例

{
  "Response": {
    "AppAnalysisResults": [
      {
        "Name": "ExecutorGC",
        "Severity": 2,
        "Explain": "Executor的GC时间占比超过20%",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "Memory资源浪费",
        "Severity": 1,
        "Explain": "空闲的内存资源 占 Executor申请的内存资源 超过 20%",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "ScheduleOverhead",
        "Severity": 3,
        "Explain": "花费过多的时间用于调度Task",
        "Suggestion": "适当合并小文件，从而降低Task数量",
        "Details": [
          "stageId: 1 花费过多时间在调度上\n平均task处理时间 0.02秒, 平均task处理数据 0KB, stage执行时间 2秒\nstageId: 1 花费过多时间在调度上\n平均task处理时间 0.01秒, 平均task处理数据 0KB, stage执行时间 1秒\n"
        ]
      },
      {
        "Name": "StageScheduleDelay",
        "Severity": 2,
        "Explain": "stage 延迟调度",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "Task输入数据过小",
        "Severity": 3,
        "Explain": "大量Task输入数据过小",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "全局排序",
        "Severity": 3,
        "Explain": "单Task读取巨量数据全局排序",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "峰值内存超限",
        "Severity": 1,
        "Explain": "Driver/Executor实际峰值内存超过了申请的内存",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "慢Task",
        "Severity": 2,
        "Explain": "Task处理时间大于所有Task平均处理时间的2倍",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "扫描大量数据",
        "Severity": 3,
        "Explain": "扫描大量数据",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "数据倾斜",
        "Severity": 3,
        "Explain": "Task处理的数据大于所有Task平均处理数据的2倍",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "调度倾斜",
        "Severity": 3,
        "Explain": "Task调度倾斜，某些Executor执行了过多的Tasks",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "输入小文件过多",
        "Severity": 3,
        "Explain": "输入小文件过多",
        "Suggestion": "",
        "Details": null
      },
      {
        "Name": "输出小文件过多",
        "Severity": 3,
        "Explain": "输出小文件过多",
        "Suggestion": "",
        "Details": null
      }
    ],
    "RequestId": "3860cd4e-a862-4e50-b337-b757ae04f22b"
  }
}