dora_failures

Creates, updates, deletes, gets or lists a dora_failures resource.

Overview

Name	dora_failures
Type	Resource
Id	datadog.software_delivery.dora_failures

Fields

The following fields are returned by SELECT queries:

get_dorafailure

Name	Datatype	Description
id	string	The ID of the event.
attributes	object	The attributes of the event.
type	string	The type of the event.

list_dorafailures

Name	Datatype	Description
data	array	The list of DORA events.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_dorafailure	select	failure_id, region		Use this API endpoint to get a failure event.
list_dorafailures	select	region		Use this API endpoint to get a list of failure events.
create_dorafailure	insert	region, data__data		Use this API endpoint to provide failure data for DORA metrics. This is necessary for: - Change Failure Rate - Time to Restore

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
failure_id	string	The ID of the failure event.
region	string	(default: datadoghq.com)

SELECT examples

get_dorafailure

Use this API endpoint to get a failure event.

SELECT
id,
attributes,
type
FROM datadog.software_delivery.dora_failures
WHERE failure_id = '{{ failure_id }}' -- required
AND region = '{{ region }}' -- required
;

list_dorafailures

Use this API endpoint to get a list of failure events.

SELECT
data
FROM datadog.software_delivery.dora_failures
WHERE region = '{{ region }}' -- required
;

INSERT examples

create_dorafailure

Use this API endpoint to provide failure data for DORA metrics.

This is necessary for:
- Change Failure Rate
- Time to Restore

INSERT INTO datadog.software_delivery.dora_failures (
data__data,
region
)
SELECT 
'{{ data }}' /* required */,
'{{ region }}'
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: dora_failures
  props:
    - name: region
      value: string
      description: Required parameter for the dora_failures resource.
    - name: data
      value: object
      description: |
        The JSON:API data.