Skip to main content

issues

Creates, updates, deletes, gets or lists an issues resource.

Overview

Nameissues
TypeResource
Iddatadog.service_management.issues

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringIssue identifier. (example: c1726a66-1f64-11ee-b338-da7ad0900002)
attributesobjectObject containing the information of an issue.
relationshipsobjectRelationship between the issue and an assignee, case and/or teams.
typestringType of the object. (example: issue)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_issueselectissue_id, regionincludeRetrieve the full details for a specific error tracking issue, including attributes and relationships.
search_issuesinsertregion, data__dataincludeSearch issues endpoint allows you to programmatically search for issues within your organization. This endpoint returns a list of issues that match a given search query, following the event search syntax. The search results are limited to a maximum of 100 issues per request.
update_issue_assigneeexecissue_id, region, dataUpdate the assignee of an issue by issue_id.
update_issue_stateexecissue_id, region, dataUpdate the state of an issue by issue_id. Use this endpoint to move an issue between states such as OPEN, RESOLVED, or IGNORED.

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.

NameDatatypeDescription
issue_idstringThe identifier of the issue. (example: c1726a66-1f64-11ee-b338-da7ad0900002)
regionstring(default: datadoghq.com)
includearrayComma-separated list of relationship objects that should be included in the response.

SELECT examples

Retrieve the full details for a specific error tracking issue, including attributes and relationships.

SELECT
id,
attributes,
relationships,
type
FROM datadog.service_management.issues
WHERE issue_id = '{{ issue_id }}' -- required
AND region = '{{ region }}' -- required
AND include = '{{ include }}'
;

INSERT examples

Search issues endpoint allows you to programmatically search for issues within your organization. This endpoint returns a list of issues that match a given search query, following the event search syntax. The search results are limited to a maximum of 100 issues per request.

INSERT INTO datadog.service_management.issues (
data__data,
region,
include
)
SELECT
'{{ data }}' /* required */,
'{{ region }}',
'{{ include }}'
RETURNING
data,
included
;

Lifecycle Methods

Update the assignee of an issue by issue_id.

EXEC datadog.service_management.issues.update_issue_assignee 
@issue_id='{{ issue_id }}' --required,
@region='{{ region }}' --required
@@json=
'{
"data": "{{ data }}"
}'
;