Incident Metrics - Team Dimension

Developing

POST/insight/incident/metrics/team

Request

start_time

integer

Start time

required

Timestamp in seconds, incident trigger time must be greater than this

end_time

integer

End time

required

Timestamp in seconds, incident trigger time must be less than or equal to this. Maximum time span is 6 months, if aggregate_unit is day, maximum time span is 31 days.

team_ids

array[integer]

Team ID list

optional

channel_ids

array[integer]

Channel ID list

optional

severities

array[string]

Severity

optional

Allowed values:

InfoWarningCritical

time_zone

string

Timezone

optional

Default timezone Asia/Shanghai, used for results and grouping timezone. Must be in tzdata format. Please refer to this list for acceptable values.

order_by

enum<string>

Sort field

optional

Sort field, continuously adding

Allowed values:

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_closemean_noise_reduction_pctmean_acknowledgement_pct

asc

boolean

Ascending order

optional

Result sort order; true means ascending, false means descending, default is descending.

aggregate_unit

enum<string> | enum<null>

Data granularity

optional

Time unit for aggregating metrics. If no value provided, metrics will be aggregated for the entire period.

Allowed values:

dayweekmonth

split_hours

string

Whether to distinguish time

optional

If yes, metrics will be aggregated by work time, rest time and sleep time

{
  "start_time": 0,
  "end_time": 0,
  "team_ids": [
    0
  ],
  "channel_ids": [
    0
  ],
  "severities": [
    "Info"
  ],
  "time_zone": "string",
  "order_by": "total_incident_cnt",
  "asc": true,
  "aggregate_unit": "day",
  "split_hours": "string"
}

Request samples

Responses

成功(200)

HTTP Code: 200

Content Type : JSONapplication/json

error

object (DutyError)

optional

code

enum<string>

Error code

required

Allowed values:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

Error description

required

data

array [object {29}]

optional

total_engaged_seconds

integer

Total responder response time

optional

Total time spent by responders participating in incident processing. One person's processing time is the time difference from acknowledgment to incident closure (close_time-ack_time), may include snooze time. If no one acknowledges, this value is 0.

total_incident_cnt

integer

Triggered incident count

optional

Triggered incident count

total_incidents_acknowledged

integer

Acknowledged incident count

optional

Acknowledged incident count

total_incidents_closed

integer

Closed incident count

optional

Closed incident count

total_incidents_auto_closed

integer

Auto-recovered incident count

optional

Auto-recovered incident count

total_incidents_manually_closed

integer

Manually closed incident count

optional

Manually closed incident count

total_incidents_timeout_closed

integer

Timeout closed incident count

optional

Timeout closed incident count

total_incidents_escalated

integer

Escalated incident count

optional

Escalated incident count

total_incidents_manually_escalated

integer

Manually escalated incident count

optional

Manually escalated incident count

total_incidents_timeout_escalated

integer

Timeout escalated incident count

optional

Timeout escalated incident count

total_incidents_reassigned

integer

Reassigned incident count

optional

Reassigned incident count

mean_seconds_to_engage

number

Average processing time

optional

Average processing time, one person's processing time is the time difference from acknowledgment to incident closure (close_time-ack_time), may include snooze time. If no one acknowledges, this value is 0.

mean_seconds_to_first_acknowledge

number

Average acknowledgment time

optional

Average first acknowledgment time (ack_time-start_time)

mean_seconds_to_close

number

Average closure time

optional

Average closure time (close_time-start_time)

mean_noise_reduction_pct

number

Noise reduction ratio

optional

Noise reduction ratio, 1-(total_incident_cnt/total_alert_event_cnt)

mean_acknowlegement_pct

number

Response ratio

optional

Response ratio, 1-(total_incidents_acknowledged/total_incident_cnt)

integer | null

Phase start time

optional

Timestamp in seconds, whether to display depends on if data is aggregated by time granularity. When aggregate_unit is day, this value will be set to timestamp of day start (00:00) according to time_zone

hours

enum<string> | enum<null>

Time type

optional

Define each hour as one of work time, rest time or sleep time. To distinguish metric differences between different time periods. When not filtering by time period, this field is not displayed. An incident's time type is only determined by its occurrence time, even if the incident spans multiple time types, it will not be split.

Allowed values:

workoffsleep

channel_id

integer | null

Channel ID

optional

Channel ID, grouping data, may or may not exist depending on grouping situation

channel_name

string | null

Channel name

optional

Channel name, grouping data, may or may not exist depending on grouping situation

team_id

integer | null

Team ID

optional

Team ID, grouping data, may or may not exist depending on grouping situation

team_name

string | null

Team name

optional

Team name, grouping data, may or may not exist depending on grouping situation

total_alert_cnt

integer

Triggered alert count

optional

Triggered alert count

total_alert_event_cnt

integer

Triggered alert event count

optional

Triggered alert event count

total_incident_sms_notifications

integer

Incident SMS notification count

optional

Incident SMS notification count

total_incident_email_notifications

integer

Incident email notification count

optional

Incident email notification count

total_incident_voice_notifications

integer

Incident voice notification count

optional

Incident voice notification count

total_schdule_shift_sms_notifications

integer

On-call SMS notification count

optional

On-call SMS notification count

total_schdule_shift_email_notifications

integer

On-call email notification count

optional

On-call email notification count

Not configured

Last modified: 2 个月前