查询impala-query节点指标
最近更新时间: 2026-09-17 00:05:46
1. 接口描述
接口请求域名： tbdsnew.api3.fincloud.tencent.cn。
在impala组件的角色管理下，查询impala query 节点的基本信息及其状态信息
默认接口请求频率限制：20次/秒。
接口更新时间：2024-11-01 12:21:18。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeImpalaQueryNodeMetrics |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-01-03 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | 集群实例ID 示例值： tbds-1vzudj86 |
| QueryId | 是 | 否 | String | 查询sql Id 示例值： 0a4fd351ce2eac59:b74ab71900000000 |
| Sort | 是 | 否 | Int64 | 0-top 1-bottom 示例值： 0 |
| Number | 是 | 否 | Int64 | 个数 示例值： 5 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| NodeMetrics | Array of NodeMetric | 节点指标描述 注意：此字段可能返回 null，表示取不到有效值。 示例值：查看 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InternalError.EMRCCException | EMRCC异常。 |
| InvalidParameter.ImpalaQueryException | impala查询参数异常。 |
| ResourceNotFound.MetricsMetaNotFound | 无法找到监控元数据。 |
| ResourceNotFound.ClusterNotFound | 无法找到该实例。 |
5. 示例
示例1 查询impala query 节点指标
输入示例
POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: DescribeImpalaQueryNodeMetrics
<公共请求参数>
{
"InstanceId": "tbds-1vzudj86",
"QueryId": "0a4fd351ce2eac59:b74ab71900000000",
"Sort": 0,
"Number": 5
}
输出示例
{
"Response": {
"NodeMetrics": [
{
"Title": "MinMemoryReservation",
"MetricValues": [
{
"Host": "tbds-172-16-0-117",
"Value": 781312,
"ValueDesc": "763.00 MB"
},
{
"Host": "tbds-172-16-0-121",
"Value": 778496,
"ValueDesc": "760.25 MB"
},
{
"Host": "tbds-172-16-0-112",
"Value": 777605.12,
"ValueDesc": "759.38 MB"
},
{
"Host": "tbds-172-16-0-109",
"Value": 777216,
"ValueDesc": "759.00 MB"
},
{
"Host": "tbds-172-16-0-44",
"Value": 777216,
"ValueDesc": "759.00 MB"
}
],
"Unit": "byte"
},
{
"Title": "FragmentInstancesNum",
"MetricValues": [
{
"Host": "tbds-172-16-0-121",
"Value": 101,
"ValueDesc": "101"
},
{
"Host": "tbds-172-16-0-112",
"Value": 100,
"ValueDesc": "100"
},
{
"Host": "tbds-172-16-0-117",
"Value": 100,
"ValueDesc": "100"
},
{
"Host": "tbds-172-16-0-109",
"Value": 99,
"ValueDesc": "99"
},
{
"Host": "tbds-172-16-0-44",
"Value": 99,
"ValueDesc": "99"
}
],
"Unit": "count"
},
{
"Title": "PeakMemoryUsage",
"MetricValues": [
{
"Host": "tbds-172-16-0-117",
"Value": 836669.44,
"ValueDesc": "817.06 MB"
},
{
"Host": "tbds-172-16-0-121",
"Value": 834897.92,
"ValueDesc": "815.33 MB"
},
{
"Host": "tbds-172-16-0-112",
"Value": 832778.24,
"ValueDesc": "813.26 MB"
},
{
"Host": "tbds-172-16-0-109",
"Value": 832645.12,
"ValueDesc": "813.13 MB"
},
{
"Host": "tbds-172-16-0-44",
"Value": 831836.16,
"ValueDesc": "812.34 MB"
}
],
"Unit": "KB"
},
{
"Title": "BytesRead",
"MetricValues": [
{
"Host": "tbds-172-16-0-117",
"Value": 11489.28,
"ValueDesc": "11.22 MB"
},
{
"Host": "tbds-172-16-0-109",
"Value": 11489.28,
"ValueDesc": "11.22 MB"
},
{
"Host": "tbds-172-16-0-44",
"Value": 11468.8,
"ValueDesc": "11.20 MB"
},
{
"Host": "tbds-172-16-0-112",
"Value": 11438.08,
"ValueDesc": "11.17 MB"
},
{
"Host": "tbds-172-16-0-121",
"Value": 11427.84,
"ValueDesc": "11.16 MB"
}
],
"Unit": "byte"
},
{
"Title": "UserTime",
"MetricValues": [
{
"Host": "tbds-172-16-0-44",
"Value": 2547,
"ValueDesc": "2s547ms"
},
{
"Host": "tbds-172-16-0-121",
"Value": 2530,
"ValueDesc": "2s530ms"
},
{
"Host": "tbds-172-16-0-112",
"Value": 2528,
"ValueDesc": "2s528ms"
},
{
"Host": "tbds-172-16-0-117",
"Value": 2515,
"ValueDesc": "2s515ms"
},
{
"Host": "tbds-172-16-0-109",
"Value": 2389,
"ValueDesc": "2s389ms"
}
],
"Unit": "ms"
},
{
"Title": "SystemTime",
"MetricValues": [
{
"Host": "tbds-172-16-0-117",
"Value": 53.049,
"ValueDesc": "53.049ms"
},
{
"Host": "tbds-172-16-0-112",
"Value": 46.377,
"ValueDesc": "46.377ms"
},
{
"Host": "tbds-172-16-0-109",
"Value": 42.859,
"ValueDesc": "42.859ms"
},
{
"Host": "tbds-172-16-0-121",
"Value": 42.753,
"ValueDesc": "42.753ms"
},
{
"Host": "tbds-172-16-0-44",
"Value": 34.27,
"ValueDesc": "34.270ms"
}
],
"Unit": "ms"
}
],
"RequestId": "abe44e6e-850a-40da-84da-6791bc3a2878"
}
}