故障指标-个人维度

开发中

POST/insight/incident/metrics/responder

最后修改时间： 14 小时前

按照个人聚合计算故障数据：

如果设置aggregate_unit，则再按照unit进行拆分展示；
如果设置split_hours，则再按照时段进行拆分展示；
以上二者都不设置，则只按照个人进行拆分展示。

请求参数

Authorization: API Key

在 query 添加参数

app_key

示例

app_key: 2f68dbbf-519d-4f01-9636-e2421b68f379

start_time

integer

开始时间

必需

秒时间戳，故障的触发时间需大于此时间

end_time

integer

结束时间

必需

秒时间戳，故障的触发时间需小于等于此时间。最大时间跨度6个月，若aggregate_unit聚合粒度为day，则最大时间跨度31天。

team_ids

array[integer]

团队ID列表

可选

channel_ids

array[integer]

协作空间ID列表

可选

severities

array[string]

严重程度

可选

枚举值:

InfoWarningCritical

time_zone

string

时区

可选

默认时区 Asia/Shanghai，用于结果和分组的时区。必须是 tzdata 格式。请参阅此处可接受的值列表。

默认值:

Asia/Shanghai

responder_ids

array[string]

成员ID列表

可选

成员ID列表

orderby

enum<string>

排序字段

可选

排序字段，持续补充

枚举值:

total_incident_cnttotal_engaged_secondstotal_incidents_acknowledgedtotal_incidents_reassignedmean_seconds_to_engagemean_seconds_to_acknowledge

asc

boolean

是否升序

可选

结果的排序顺序； true 表示升序，false 表示降序，默认是降序。

aggregate_unit

enum<string> | enum<null>

数据粒度

可选

聚合指标的时间单位。如果未提供值，则将聚合整个期间的指标。

枚举值:

dayweekmonth

split_hours

boolean

是否区分时间

可选

如果是，将按照工作时间，休息时间以及睡眠时间来进行指标聚合

{
  "start_time": 0,
  "end_time": 0,
  "team_ids": [
    0
  ],
  "channel_ids": [
    0
  ],
  "severities": [
    "Info"
  ],
  "time_zone": "Asia/Shanghai",
  "responder_ids": [
    "string"
  ],
  "orderby": "total_incident_cnt",
  "asc": true,
  "aggregate_unit": "day",
  "split_hours": true
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

array [object {11}]

必需

total_engaged_seconds

integer

整体处理耗时时间

可选

处理人员参与故障处理的耗时总和。一个人的处理耗时为该人员从认领到故障被关闭的时间差（close_time-ack_time），可能会包含暂缓时间。如果无人认领，该值为0。

total_incident_cnt

integer

触发故障数量

可选

触发故障数量

total_incidents_acknowledged

integer

认领故障数量

可选

认领故障数量

total_incidents_reassigned

integer

重新分派故障数量

可选

重新分派故障数量

mean_seconds_to_engage

number

平均处理耗时

可选

平均处理耗时。一个人的处理耗时为该人员从认领到故障被关闭的时间差（close_time-ack_time），可能会包含暂缓时间。如果无人认领，该值为0。

mean_seconds_to_acknowledge

number

平均认领耗时

可选

平均认领耗时（ack_time-start_time）。

integer | null

时间段开始时间

可选

秒时间戳，根据是否是时间粒度汇聚数据决定是否展示。如aggregate_unit为day时，此值将根据time_zone确定为当天零点的时间戳

hours

enum<string> | enum<null>

时间类型

可选

将每一小时定义为工作时间、休息时间和睡眠时间中的任一种。来区分不同时间段下的指标差异。当不进行时间段筛选时，不展示此字段。一个故障的时间类型仅取决于其发生时间，即使该故障存活时间跨越多个时间类型，也不会进行拆分。

枚举值:

workoffsleep

responder_id

integer

成员ID

可选

成员ID

responder_name

string

成员名称

可选

成员名称

total_interruptions

integer

中断次数

可选

同一次分派多次电话或短信都算一次

未设置

最后修改时间： 14 小时前