团队维度指标 - Flashcat API

按照团队聚合计算故障数据：

如果设置aggregate_unit，则再按照unit进行拆分展示；

如果设置split_hours，则再按照时段进行拆分展示；

以上二者都不设置，则只按照团队进行拆分展示。

curl --location --request POST 'https://api.flashcat.cloud/insight/team?app_key' \ --header 'Content-Type: application/json' \ --data-raw '{ "start_time": 0, "end_time": 0, "team_ids": [ 0 ], "is_my_team": true, "channel_ids": [ 0 ], "severities": [ "Info" ], "time_zone": "Asia/Shanghai", "aggregate_unit": "day", "split_hours": true }'

{ "error": { "code": "InvalidParameter", "message": "string" }, "data": { "items": [ { "total_engaged_seconds": 0, "total_incident_cnt": 0, "total_incidents_acknowledged": 0, "total_incidents_closed": 0, "total_incidents_auto_closed": 0, "total_incidents_manually_closed": 0, "total_incidents_timeout_closed": 0, "total_incidents_escalated": 0, "total_incidents_manually_escalated": 0, "total_incidents_timeout_escalated": 0, "total_incidents_reassigned": 0, "total_notifications": 0, "total_interruptions": 0, "mean_seconds_to_ack": 0, "mean_seconds_to_close": 0, "noise_reduction_pct": 0, "acknowlegement_pct": 0, "ts": 0, "hours": "work", "channel_id": 0, "channel_name": "string", "team_id": 0, "team_name": "string", "total_alert_cnt": 0, "total_alert_event_cnt": 0 } ] } }

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Body 参数application/json

start_time

integer

开始时间

必需

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

end_time

integer

结束时间

必需

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

team_ids

array[integer]

团队列表

可选

团队列表，与is_my_team同时传入时，取交集。

is_my_team

boolean

我的团队

可选

与team_ids同时传入时，取交集。

channel_ids

array[integer]

协作空间列表

可选

空间列表，仅可选择您可见的空间

severities

array[string]

严重程度

可选

严重程度

枚举值:

InfoWarningCritical

time_zone

string

时区

可选

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

默认值:

Asia/Shanghai

aggregate_unit

enum<string>

聚合粒度

可选

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

枚举值:

dayweekmonth

split_hours

boolean

是否区分时间段

可选

是否按照工作时间，休息时间以及睡眠时间来进行指标聚合，常用于对不同时间段有不同响应SLA要求的场景

示例

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

items

array [object {25}]

必需