Search Incidents
Search for incidents matching a certain query.
External Documentation
To learn more, visit the Datadog documentation.
Basic Parameters
Parameter | Description |
---|---|
Query | Specifies which incidents should be returned. The query can contain any number of incident facets joined by ANDs, along with multiple values for each of those facets joined by ORs, for instance - "state:active AND severity:(SEV-2 OR SEV-1)". For more information about the query syntax, visit the [Query Syntax page] (https://docs.datadoghq.com/tracing/trace_explorer/query_syntax/). |
Advanced Parameters
Parameter | Description |
---|---|
Include | Specifies which types of related objects should be included in the response. |
Sort | Specifies the order of returned incidents (created - ascending, -created - descending). |
Example Output
{
"data": {
"type": "incidents_search_results",
"attributes": {
"total": 1,
"facets": {
"time_to_repair": [
{
"name": "time_to_repair",
"aggregates": {
"min": null,
"max": null
}
}
],
"impact": [
{
"name": "None",
"count": 1
}
],
"time_to_resolve": [
{
"name": "time_to_resolve",
"aggregates": {
"min": null,
"max": null
}
}
],
"fields": [
{
"name": "detection_method",
"facets": [
{
"name": "unknown",
"count": 2
},
{
"name": "customer",
"count": 0
},
{
"name": "employee",
"count": 0
},
{
"name": "monitor",
"count": 0
},
{
"name": "other",
"count": 0
}
]
}
]
},
"incidents": [
{
"type": "incidents",
"attributes": {
"resolved": null,
"fields": {
"severity": {
"type": "dropdown",
"value": "UNKNOWN"
},
"root_cause": {
"type": "textbox",
"value": null
},
"teams": {
"type": "autocomplete",
"value": null
},
"state": {
"type": "dropdown",
"value": "active"
},
"services": {
"type": "autocomplete",
"value": null
},
"detection_method": {
"type": "dropdown",
"value": "unknown"
},
"summary": {
"type": "textbox",
"value": null
}
},
"created": "2023-01-15T12:58:22+00:00",
"customer_impact_scope": "",
"last_modified_by_uuid": null,
"time_to_detect": 0,
"customer_impact_duration": 0,
"time_to_resolve": 0,
"customer_impacted": false,
"title": "something happend",
"time_to_internal_response": 0,
"visibility": "organization",
"commander": {
"data": {
"type": "users",
"attributes": {
"name": "John Doe",
"uuid": "d4170d4a-94c7-11ed-bf65-7630e111ac00",
"handle": "johndoe@gmail.com,",
"icon": "https://secure.gravatar.com/avatar/d5977080980b9212b5ff014e1cd1641c?s=48&d=retro",
"email": "johndoe@gmail.com,"
},
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"non_datadog_creator": null,
"created_by_uuid": null,
"customer_impact_end": null,
"created_by": {
"data": {
"type": "users",
"attributes": {
"name": "John Doe",
"uuid": "d4170d4a-94c7-11ed-bf65-7630e111ac00",
"handle": "johndoe@gmail.com,",
"icon": "https://secure.gravatar.com/avatar/d5977080980b9212b5ff014e1cd1641c?s=48&d=retro",
"email": "johndoe@gmail.com,"
},
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"last_modified_by": {
"data": {
"type": "users",
"attributes": {
"name": "John Doe",
"uuid": "d4170d4a-94c7-11ed-bf65-7630e111ac00",
"handle": "johndoe@gmail.com,",
"icon": "https://secure.gravatar.com/avatar/d5977080980b9212b5ff014e1cd1641c?s=48&d=retro",
"email": "johndoe@gmail.com,"
},
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"field_analytics": {
"state": {
"active": {
"duration": 0,
"spans": [
{
"start": 1673787502,
"end": null
}
]
}
}
},
"time_to_repair": 0,
"modified": "2023-01-15T12:58:22+00:00",
"detected": "2023-01-15T12:58:22+00:00",
"severity": "UNKNOWN",
"creation_idempotency_key": null,
"notification_handles": [
{
"display_name": "John Doe",
"handle": "johndoe@gmail.com,",
"created_at": "2023-01-15T12:58:22.533787+00:00"
}
],
"state": "active",
"public_id": 1,
"customer_impact_start": null
},
"relationships": {
"commander_user": {
"data": {
"type": "users",
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"created_by_user": {
"data": {
"type": "users",
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"integrations": {
"data": []
},
"last_modified_by_user": {
"data": {
"type": "users",
"id": "d4170d4a-94c7-11ed-bf65-7630e111ac00"
}
},
"responders": {
"data": [
{
"type": "incident_responders",
"id": "241aa212-ffc0-5a0a-ac8a-d1dd10a8b1b9"
}
]
},
"impacts": {
"data": []
},
"user_defined_fields": {
"data": []
},
"attachments": {
"data": []
}
},
"id": "f4f5028c-1409-54f0-ba90-be0a42471b49"
}
]
},
"relationships": {
"incidents_relationship": {
"data": []
}
}
},
"meta": {
"pagination": {
"offset": 0,
"next_offset": 0,
"size": 0
}
}
}
Workflow Library Example
Search Incidents with Datadog and Send Results Via Email