调用Draw接口查询指标的详细信息。 ## **请求参数** 下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，请参见[公共参数](https://www.volcengine.com/docs/6431/160131)。 |**字段** |**位置** |**类型** |**是否必填** |**说明** | |---|---|---|---|---| |Action |Query |String |是 |要执行的操作，取值：Draw。 | |Version |Query |String |是 |请求版本。取值：2022\-11\-09。 | |Graph |Body |Query |是 |详情请参见[Graph](https://www.volcengine.com/docs/6431/169877)。 | |CurrentVaribaleValues |Body |Array[Varable] |是 |传入空数组。 | |StartTime |Body |Int64 |是 |开始时间。 | |EndTime |Body |Int64 |是 |结束时间。 | |GranularityUnit |Body |String |是 |间隔时间周期。 | |Granularity |Body |Int64 |是 |间隔值。 | **Graph** |**参数** |**类型** |**是否必填** |**说明** | |---|---|---|---| |Id |String |是 |前端传入任意值。 | |GraphType |String |是 |看板类型。

* time_series：时序图

* table：表格

* single_value：值 | |Name |String |是 |前端传入任意值。 | |TimeSeriesConf |TimeSeriesGraphConfig |否 |看板类型为time_series时使用。详情请参见**TimeSeriesGraphConfig**。 | |TableConf |TableGraphConfig |否 |看板类型为table时使用。详情请参见**TableGraphConfig**。 | |SingleValueConf |SingleValueGraphConfig |否 |看板类型为single_value时使用。详情请参见**SingleValueGraphConfig**。 | **TimeSeriesGraphConfig** |**参数** |**类型** |**是否必填** |**说明** | |---|---|---|---| |SimpleQueries |Array[TimeSeriesQuery] |是 |简单查询。详情请参见**TimeSeriesQuery**。 | |FormulaQueries |Array[FormulaQuery] |是 |公式查询。详情请参见**FormulaQuery**。 | |Precision |Int32 |是 |精度，小数点后位数。 | |Marker |Array[Marker] |是 |标记，传入空数组。 | |ShowLegend |Boolean |是 |是否显示图例。 | |Legend |Array[String] |是 |图列列表。 | **TimeSeriesQuery** |**名称** |**类型** |**是否必填** |**描述** | |---|---|---|---| |Id |String |是 |查询名称，前端自定义。 | |Ispromql |Boolean |是 |是否为PromQL指标。 | |Promql |String |否 |promsql查询。 | |Metric |String |是 |指标名称。 | |Unit |String |是 |单位。 | |Alphabet |String |是 |计算复合指标公式使用的符号。 | |Alias |String |是 |别名。 | |MetricCategory |String |是 |Metric类型。

* host

* process

* container

* custom_metric | |MetricSource |String |是 |指标类型。

* prometheus

* influxdb | |GroupByFields |Array[String] |是 |分组。

说明

若 ArkClaw 实例存在自定义标签，GroupByFields 中可使用此标签进行分组查询。

说明

若 ArkClaw 实例存在自定义标签，Filters 中可使用此标签进行数据筛选。

| |Hide |Boolean |是 |是否隐藏。 | |CounterAs |String |否 |Counter类型。

* count

* rate | **TableQuery** |**名称** |**类型** |**是否必填** |**描述** | |---|---|---|---| |Id |String |是 |查询名称，前端自定义。 | |Ispromql |Boolean |是 |是否为PromQL指标。 | |Promql |String |否 |promsql查询。 | |Metric |String |是 |指标名称。 | |Unit |String |是 |单位。 | |Alphabet |String |是 |计算复合指标公式使用的符号。 | |Alias |String |是 |别名。 | |MetricCategory |String |是 |Metric类型。

* host

* process

* container

* custom_metric | |MetricSource |String |是 |指标类型。

* prometheus

* influxdb | |GroupByFields |Array[String] |是 |分组。

说明

若 ArkClaw 实例存在自定义标签，GroupByFields 中可使用此标签进行分组查询。

说明

若 ArkClaw 实例存在自定义标签，Filters 中可使用此标签进行数据筛选。

| |Hide |Boolean |是 |是否显示。 | |CounterAs |String |否 |Counter类型。

* count

* rate | |RollupTimeframeByAggregator |String |否 |时间窗口聚合方式。

* AVG

* SUM

* LAST

* COUNT

* MAX

* MIN | **SingleValueQuery** |**名称** |**类型** |**是否必填** |**描述** | |---|---|---|---| |Id |String |是 |查询名称，前端自定义。 | |Ispromql |Boolean |是 |是否为PromQL指标。 | |Promql |String |否 |promsql查询。 | |Metric |String |是 |指标名称。 | |Unit |String |是 |单位。 | |Alphabet |String |是 |计算复合指标公式使用的符号。 | |Alias |String |是 |别名。 | |MetricCategory |String |是 |Metric类型。

* host

* process

* container

* custom_metric | |MetricSource |String |是 |指标类型。

* prometheus

* influxdb | |GroupByFields |Array[String] |是 |分组。

说明

若 ArkClaw 实例存在自定义标签，GroupByFields 中可使用此标签进行分组查询。

说明

若 ArkClaw 实例存在自定义标签，Filters 中可使用此标签进行数据筛选。

| |Hide |Boolean |是 |是否隐藏。 | |CounterAs |String |否 |Counter类型。

* count

* rate | |RollupTimeframeByAggregator |String |是 |时间窗口聚合方式。

* AVG

* SUM

* LAST

* COUNT

* MAX

* MIN | **FormulaQuery** |**字段** |**类型** |**是否必填** |**说明** | |---|---|---|---| |Formula |String |是 |复合指标计算公式。 | |Alias |String |否 |展示名称。 | |Unit |String |否 |单位。 | |Alphabet |String |否 |计算公式使用的符号。 | ## **返回参数** Result字段包含以下参数： |**字段** |**类型** |**说明** | |---|---|---| |SingleValue |SingleValueData |数值看板。详情请参见**SingleValueData**。 | |Table |TableData |表格看板。详情请参见**TableData**。 | |TimeSeries |Array[TimeSeriesData] |时序数据看板。详情请参见**TimeSeriesData**。 | **SingleValueData** |**字段** |**类型** |**示例值** |**说明** | |---|---|---|---| |Value |String |100 |数值。 | |Unit |String |s |单位。 | **TableData** |**字段** |**类型** |**说明** | |---|---|---| |Columns |Array[String] |列名。 | |Units |Array[String] |单位，与列名对应。 | |Rows |Array[Array[String]] |数值。 | **TimeSeriesData** |**字段** |**类型** |**说明** | |---|---|---| |QueryId |String |请求ID，与request中的ID一致。 | |Title |String |标题，与request中Alias一致。 | |Unit |String |单位。 | |Legend |Legend |图例。 | |Points |Array[SeriesPoint] |时序数据点。 | |Tagkvs |Array[Tagkv] |标签。 | **Legend** |**字段** |**类型** |**说明** | |---|---|---| |Max |Float |最大值。 | |Min |Float |最小值。 | |Avg |Float |平均值。 | |Current |Float |当前值。 | **SeriesPoint** |**字段** |**类型** |**说明** | |---|---|---| |Timestamp |String |数据时间戳。 | |Value |String |时序时间点值。 | |EndTimestamp |String |结束时间戳，用来处理多点合并。 | **TagKV** |**字段** |**类型** |**说明** | |---|---|---| |Key |String |标记。 | |Lable |String |标签。 | |Value |String |标记值。 | ## **请求示例** ```json POST https://open.volcengineapi.com?Action=Draw&Version=2022-11-09 &<公共请求参数> ``` ## **返回示例** ```json { "ResponseMetadata": { "RequestId": "", "Action": "Draw", "Version": "2022-11-09", "Service": "apmplus_server", "Region": "cn-beijing" }, "Result": { "SingleValue": { "Unit": "", "Value": "" }, "Table": { "Columns": [], "Rows": [], "Units": [] }, "TimeSeries": [ { "Legend": { "Avg": 199291.5994444445, "Current": 210846.96666666667, "Max": 211086.86666666667, "Min": 190502.8 }, "Points": [ { "Timestamp": "1668135210", "Value": 190875.13333333333 }, { "Timestamp": "1668135240", "Value": 190982.33333333334 }, { "Timestamp": "1668135270", "Value": 190502.8 }, { "Timestamp": "1668135300", "Value": 191046.43333333332 }, { "Timestamp": "1668135330", "Value": 190787.73333333334 }, { "Timestamp": "1668135360", "Value": 191358.9 }, { "Timestamp": "1668135390", "Value": 191692.96666666667 }, { "Timestamp": "1668135420", "Value": 191917.03333333333 }, { "Timestamp": "1668135450", "Value": 191739.16666666666 }, { "Timestamp": "1668135480", "Value": 191995.73333333334 }, { "Timestamp": "1668135510", "Value": 192374.5 }, { "Timestamp": "1668135540", "Value": 192149 }, { "Timestamp": "1668135570", "Value": 192211.73333333334 }, { "Timestamp": "1668135600", "Value": 193150.93333333332 }, { "Timestamp": "1668135630", "Value": 194578.9 }, { "Timestamp": "1668135660", "Value": 195246.33333333334 }, { "Timestamp": "1668135690", "Value": 195474.8 }, { "Timestamp": "1668135720", "Value": 194953.9 } ], "QueryId": "5387660146-1657110201438", "Tagkvs": [], "Title": "a : RTA_Product.call_user_interested", "Unit": "" } ] } } ```

应用性能监控全链路版