故障指标-空间维度

开发中

POST/insight/incident/metrics/channel

最后修改时间： 15 小时前

按照空间聚合计算故障数据：

如果设置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

orderby

enum<string>

排序字段

可选

排序字段，持续补充

枚举值:

total_incident_cnttotal_engaged_secondstotal_incidents_acknowledgedtotal_incidents_closedtotal_incidents_auto_closedtotal_incidents_timeout_closedtotal_incidents_escalatedtotal_incidents_manually_escalatedtotal_incidents_timeout_escalatedtotal_incidents_reassignedmean_seconds_to_engagemean_seconds_to_first_acknowledgemean_seconds_to_close

asc

boolean

是否升序

可选

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

aggregate_unit

enum<string> | enum<null>

数据粒度

可选

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

枚举值:

dayweekmonth

split_hours

string

是否区分时间

可选

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

{
  "start_time": 1234567890,
  "end_time": 1234567890,
  "team_ids": [
    123,
    456
  ],
  "channel_ids": [
    1,
    2,
    3
  ],
  "severities": [
    "Warning"
  ],
  "order_by": "total_incident_cnt",
  "asc": true
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

error

object

可选

code

string

必需

message

string

必需

data

array [object {29}]

可选

total_engaged_seconds

integer

处理人员总响应耗时

可选

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

total_incident_cnt

integer

触发故障数量

可选

触发故障数量

total_incidents_acknowledged

integer

认领故障数量

可选

认领故障数量

total_incidents_closed

integer

关闭故障数量

可选

关闭故障数量

total_incidents_auto_closed

integer

自动恢复故障数量

可选

自动恢复故障数量

total_incidents_manually_closed

integer

手动关闭故障数量

可选

手动关闭故障数量

total_incidents_timeout_closed

integer

超时关闭故障数量

可选

超时关闭故障数量

total_incidents_escalated

integer

升级故障数量

可选

升级故障数量

total_incidents_manually_escalated

integer

手动升级故障数量

可选

手动升级故障数量

total_incidents_timeout_escalated

integer

超时升级故障数量

可选

超时升级故障数量

total_incidents_reassigned

integer

重新分派故障数量

可选

重新分派故障数量

mean_seconds_to_engage

number

平均处理耗时

可选

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

mean_seconds_to_first_acknowledge

number

平均认领耗时

可选

平均首次认领耗时（ack_time-start_time）

mean_seconds_to_close

number

平均关闭耗时

可选

平均关闭耗时（close_time-start_time）

mean_noise_reduction_pct

number

降噪比例

可选

降噪比例，100.0-(total_incident_cnt/total_alert_event_cnt)*100.0

mean_acknowlegement_pct

number

响应比例

可选

响应比例，(total_incidents_acknowledged/total_incident_cnt)*100.0

integer | null

阶段开始时间

可选

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

hours

enum<string> | enum<null>

时间类型

可选

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

枚举值:

workoffsleep

channel_id

integer | null

协作空间ID

可选

协作空间ID，分组数据，根据分组情况可有可无

channel_name

string | null

协作空间名称

可选

协作空间名称，分组数据，根据分组情况可有可无

team_id

integer | null

团队ID

可选

团队ID，分组数据，根据分组情况可有可无

team_name

string | null

团队名称

可选

团队名称，分组数据，根据分组情况可有可无

total_alert_cnt

integer

触发告警数量

可选

触发告警数量

total_alert_event_cnt

integer

触发告警事件数量

可选

触发告警事件数量

total_incident_sms_notifications

integer

故障短信通知数量

可选

故障短信通知数量

total_incident_email_notifications

integer

故障邮件通知数量

可选

故障邮件通知数量

total_incident_voice_notifications

integer

故障语音通知数量

可选

故障语音通知数量

total_schdule_shift_sms_notifications

integer

值班短信通知数量

可选

值班短信通知数量

total_schdule_shift_email_notifications

integer

值班邮件通知数量

可选

值班邮件通知数量

未设置

最后修改时间： 15 小时前