인시던트 이벤트 목록 가져오기
POST
https://api.datadoghq.com/api/v2/dora/failureshttps://api.us3.datadoghq.com/api/v2/dora/failureshttps://api.us5.datadoghq.com/api/v2/dora/failureshttps://api.datadoghq.eu/api/v2/dora/failureshttps://api.ap1.datadoghq.com/api/v2/dora/failureshttps://api.ap2.datadoghq.com/api/v2/dora/failureshttps://api.uk1.datadoghq.com/api/v2/dora/failureshttps://api.ddog-gov.com/api/v2/dora/failureshttps://api.us2.ddog-gov.com/api/v2/dora/failures개요
이 API 엔드포인트를 사용하여 인시던트 이벤트 목록을 가져옵니다.
요청
Body Data (required)
항목
유형
설명
data [required]object
인시던트 목록을 가져오기 위한 요청입니다.
attributes [required]object
Attributes to get a list of incidents.
fromdate-time
Minimum timestamp for requested events.
limitint32
Maximum number of events in the response.
10querystring
Search query with event platform syntax.
sortstring
Sort order (prefixed with - for descending).
todate-time
Maximum timestamp for requested events.
typeenum
The definition of DORAListFailuresRequestDataType object.
dora_failures_list_requestAllowed enum values:
dora_failures_list_request{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 500,
"query": "severity:(SEV-1 OR SEV-2) env:(production OR staging) service:(shopist OR api-service OR payment-service) team:(backend OR platform OR payments)",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}응답
OK
Response for the list incidents endpoint.
항목
유형
설명
data[object]
The list of DORA incident events.
attributesobject
The attributes of the incident event.
custom_tags[string]
A list of user-defined tags. The tags must follow the key:value pattern. Up to 100 may be added per event.
envstring
Environment name that was impacted by the incident.
finished_atdate-time
The time when the incident finished.
gitobject
Git info for DORA Metrics events.
commit_sha [required]string
Git Commit SHA.
repository_url [required]string
Git Repository URL
namestring
Incident name.
services[string]
Service names impacted by the incident.
severitystring
Incident severity.
started_atdate-time
The time when the incident started.
teamstring
Name of the team owning the services impacted.
versionstring
Version to correlate with APM Deployment Tracking.
idstring
The ID of the incident event.
typeenum
JSON:API type for DORA incident events.
dora_failureAllowed enum values:
dora_failure{
"data": [
{
"attributes": {
"custom_tags": [
"incident_type:database",
"department:engineering"
],
"env": "production",
"finished_at": "2023-08-31T14:31:14Z",
"name": "Database outage",
"services": [
"shopist"
],
"severity": "SEV-1",
"started_at": "2023-08-31T14:29:34Z",
"team": "backend"
},
"id": "4242fcdd31586085",
"type": "dora_incident"
},
{
"attributes": {
"custom_tags": [
"incident_type:service_down",
"department:platform"
],
"env": "production",
"finished_at": "2023-08-31T14:34:34Z",
"name": "API service outage",
"services": [
"api-service",
"payment-service"
],
"severity": "SEV-2",
"started_at": "2023-08-31T14:32:54Z",
"team": "backend"
},
"id": "4242fcdd31586086",
"type": "dora_incident"
}
]
}Bad Request
API error response.
항목
유형
설명
errors [required][object]
A list of errors.
detailstring
A human-readable explanation specific to this occurrence of the error.
metaobject
Non-standard meta-information about the error
sourceobject
References to the source of the error.
headerstring
A string indicating the name of a single request header which caused the error.
parameterstring
A string indicating which URI query parameter caused the error.
pointerstring
A JSON pointer to the value in the request document that caused the error.
statusstring
Status code of the response.
titlestring
Short human-readable summary of the error.
{
"errors": [
{
"detail": "Missing required attribute in body",
"meta": {},
"source": {
"header": "Authorization",
"parameter": "limit",
"pointer": "/data/attributes/title"
},
"status": "400",
"title": "Bad Request"
}
]
}Not Authorized
API error response.
항목
유형
설명
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Too many requests
API error response.
항목
유형
설명
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}코드 예시
인시던트 이벤트 목록 가져오기
# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
curl -X POST "https://api.${DD_SITE}/api/v2/dora/failures" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"from": "2025-01-01T00:00:00Z",
"limit": 100,
"query": "severity:(SEV-1 OR SEV-2) env:production team:backend",
"sort": "-started_at",
"to": "2025-01-31T23:59:59Z"
},
"type": "dora_failures_list_request"
}
}
EOF