bits_ai_investigations

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

Overview

Name	bits_ai_investigations
Type	Resource
Id	datadog.service_management.bits_ai_investigations

Fields

The following fields are returned by SELECT queries:

get_investigation

Name	Datatype	Description
id	string	The unique identifier of the investigation. (example: a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d)
attributes	object	Attributes of the investigation.
type	string	The resource type for investigations. (investigation) (example: investigation)

list_investigations

Name	Datatype	Description
id	string	The unique identifier of the investigation. (example: a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d)
attributes	object	Attributes of an investigation list item.
type	string	The resource type for investigations. (investigation) (example: investigation)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_investigation	select	id		Get a specific Bits AI investigation by ID.
list_investigations	select		page[offset], page[limit], filter[monitor_id]	List all Bits AI investigations for the organization.
trigger_investigation	insert	data		Trigger a new Bits AI investigation based on a monitor alert.

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
id	string	The ID of the investigation. (example: a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d)
site	string	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.
filter[monitor_id]	integer (int64)	Filter investigations by monitor ID. (example: 12345678)
page[limit]	integer (int64)	Maximum number of investigations to return. (example: 25)
page[offset]	integer (int64)	Offset for pagination. (example: 0)

SELECT examples

get_investigation

Get a specific Bits AI investigation by ID.

SELECT
id,
attributes,
type
FROM datadog.service_management.bits_ai_investigations
WHERE id = '{{ id }}' -- required
;

list_investigations

List all Bits AI investigations for the organization.

SELECT
id,
attributes,
type
FROM datadog.service_management.bits_ai_investigations
WHERE page[offset] = '{{ page[offset] }}'
AND page[limit] = '{{ page[limit] }}'
AND filter[monitor_id] = '{{ filter[monitor_id] }}'
;

INSERT examples

trigger_investigation

Trigger a new Bits AI investigation based on a monitor alert.

INSERT INTO datadog.service_management.bits_ai_investigations (
data
)
SELECT 
'{{ data }}' /* required */
RETURNING
data
;

Manifest

# Description fields are for documentation purposes
- name: bits_ai_investigations
props:
  - name: data
    description: |
      Data for the trigger investigation request.
    value:
      attributes:
        trigger:
          monitor_alert_trigger:
            event_id: "{{ event_id }}"
            event_ts: {{ event_ts }}
            monitor_id: {{ monitor_id }}
          type: "{{ type }}"
      type: "{{ type }}"