文档首页/ 云客服/ API参考/ 质检/监控/统计类/ 监控/统计/ 历史数据查询类接口/ 获取技能维度的历史监控指标
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

获取技能维度的历史监控指标

场景描述

获取技能维度的历史监控指标，默认从5min结算表中获取数据，不查实时缓存数据，如果要查询实时缓存数据，可以修改数据库中如下表字段(t_cms_sysparam表中history_monitor_indicator/history_monitor_indicator_agent)的值修改为：true，由于接口结算实时缓存数据有一定的性能瓶颈，打开前请和维护人员如实评估。

接口方法

设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。

请求URL

https://ip:port/rest/cmsapp/v1/openapi/hisindex/skill

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。
表2 请求消息体参数说明

参数名

数据类型

是否必选

说明

ccId

int

False

呼叫中心编号，取值范围：1～65535。

  • 集成环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > CMS系统配置”查看的呼叫中心编号。若该配置为空，取值数据库t_cms_sysparam表中的sys_key="default_cc_id",sys_type="cms_system_config"对应的数据。
  • 独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。

vdn

int

True

虚拟呼叫中心编号，取值范围：1～5000。

timeGrain

String

False

该入参可按分钟粒度进行历史监控指标统计，可选值为（"15MIN"，"30MIN"，"60MIN"），如果不传则统计当天（VDN所在时区）数据。

skillIds

List<Integer>

True

技能队列编号的数组，数组长度最大1000。技能队列为int型。

indexIds

List<String>

True

指标的数组。指标为String型。数组最大长度为技能历史监控指标的个数。

具体指标请参见表1

mediaType

int

False

呼叫媒体类型，具体请参见表1。

subMediaType

int

False

子媒体类型，具体请参见表3。

enableOffset

String

False

可选值为（"Y"，"N"），传"Y"则查询前一天的数据，传"N"则查询当天的数据，不传默认为"N"。

响应消息

表3 响应消息体参数说明

参数名

数据类型

说明

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultCode

String

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

resultDatas

List< JSONObject>

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

resultDesc

List< JSONObject>

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。
表4 resultDesc/resultDatas对象参数说明

参数名

数据类型

说明

id

String

技能队列编号。

idxs

List< JSONObject>

指标结果集。

该对象的参数说明请参见表1。
表5 idx对象参数说明

参数名

数据类型

说明

id

String

指标ID。

val

Object

按分钟粒度统计的指标结果，时间为零时区时间。

参数格式为"时间":"指标结果"，表示当前时间起一段时间间隔中统计的指标结果数量，时间间隔长度由请求参数中的timeGrain参数决定。

例如"2020-11-11 09:15:00.0": "1"，表示09:15~09:30时指标结果为1，此时请求参数中timeGrain的值为15。

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
   "ccId":1,
   "vdn":1,
   "skillIds":[11,24],
   "timeGrain":"15MIN",
   "indexIds":["IDX_COUNT_SKILL_REQUEST","IDX_COUNT_SKILL_CONNECTED"],
   "mediaType":53,
   "subMediaType":3
}
  • 响应参数： 
    {
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_SKILL_REQUEST"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "6",
                        "2020-08-24 10:45:00.0": "4"
                    },
                    "id": "IDX_COUNT_SKILL_CONNECTED"
                }
            ],
            "id": "12"
        },
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:00:00.0": "16",
                        "2020-08-24 10:15:00.0": "14"
                    },
                    "id": "IDX_COUNT_SKILL_REQUEST"
                },
                {
                    "val": {
                        "2020-08-24 10:00:00.0": "5",
                        "2020-08-24 10:15:00.0": "4"
                    },
                    "id": "IDX_COUNT_SKILL_CONNECTED"
                }
            ],
            "id": "13"
        }
    ],
    "resultDesc": [
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "15",
                        "2020-08-24 10:45:00.0": "19"
                    },
                    "id": "IDX_COUNT_SKILL_REQUEST"
                },
                {
                    "val": {
                        "2020-08-24 10:30:00.0": "6",
                        "2020-08-24 10:45:00.0": "4"
                    },
                    "id": "IDX_COUNT_SKILL_CONNECTED"
                }
            ],
            "id": "12"
        },
        {
            "idxs": [
                {
                    "val": {
                        "2020-08-24 10:00:00.0": "16",
                        "2020-08-24 10:15:00.0": "14"
                    },
                    "id": "IDX_COUNT_SKILL_REQUEST"
                },
                {
                    "val": {
                        "2020-08-24 10:00:00.0": "5",
                        "2020-08-24 10:15:00.0": "4"
                    },
                    "id": "IDX_COUNT_SKILL_CONNECTED"
                }
            ],
            "id": "13"
        }
    ]
}

相关文档