events

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

Overview

Name	events
Type	Resource
Id	datadog.service_management.events

Fields

The following fields are returned by SELECT queries:

get_event

Name	Datatype	Description
id	string	The event's ID. (example: )
attributes	object	Event attributes.
type	string	Entity type. (example: event)

list_events

Name	Datatype	Description
id	string	the unique ID of the event. (example: AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA)
attributes	object	The object description of an event response attribute.
type	string	Type of the event. (default: event, example: event)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_event	select	event_id, region		Get the details of an event by event_id.
list_events	select	region	filter[query], filter[from], filter[to], sort, page[cursor], page[limit]	List endpoint returns events that match an events search query. Results are paginated similarly to logs. Use this endpoint to see your latest events.
create_event	insert	region, data__data		This endpoint allows you to publish events. Note: To utilize this endpoint with our client libraries, please ensure you are using the latest version released on or after July 1, 2025. Earlier versions do not support this functionality. ✅ Only events with the change or alert category are in General Availability. For change events, see Change Tracking for more details. ❌ For use cases involving other event categories, use the V1 endpoint or reach out to support. ❌ Notifications are not yet supported for events sent to this endpoint. Use the V1 endpoint for notification functionality.
search_events	insert	region		List endpoint returns events that match an events search query. Results are paginated similarly to logs. Use this endpoint to build complex events filtering and search.

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
event_id	string	The UID of the event.
region	string	(default: datadoghq.com)
filter[from]	string	Minimum timestamp for requested events, in milliseconds.
filter[query]	string	Search query following events syntax.
filter[to]	string	Maximum timestamp for requested events, in milliseconds.
page[cursor]	string	List following results with a cursor provided in the previous query. (example: eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==)
page[limit]	integer (int32)	Maximum number of events in the response. (example: 25)
sort	string	Order of events in results.

SELECT examples

get_event

Get the details of an event by event_id.

SELECT
id,
attributes,
type
FROM datadog.service_management.events
WHERE event_id = '{{ event_id }}' -- required
AND region = '{{ region }}' -- required
;

list_events

List endpoint returns events that match an events search query.
Results are paginated similarly to logs.

Use this endpoint to see your latest events.

SELECT
id,
attributes,
type
FROM datadog.service_management.events
WHERE region = '{{ region }}' -- required
AND filter[query] = '{{ filter[query] }}'
AND filter[from] = '{{ filter[from] }}'
AND filter[to] = '{{ filter[to] }}'
AND sort = '{{ sort }}'
AND page[cursor] = '{{ page[cursor] }}'
AND page[limit] = '{{ page[limit] }}'
;

INSERT examples

create_event

This endpoint allows you to publish events.

Note: To utilize this endpoint with our client libraries, please ensure you are using the latest version released on or after July 1, 2025. Earlier versions do not support this functionality.

✅ Only events with the change or alert category are in General Availability. For change events, see Change Tracking for more details.

❌ For use cases involving other event categories, use the V1 endpoint or reach out to support.

❌ Notifications are not yet supported for events sent to this endpoint. Use the V1 endpoint for notification functionality.

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

search_events

List endpoint returns events that match an events search query.
Results are paginated similarly to logs.

Use this endpoint to build complex events filtering and search.

INSERT INTO datadog.service_management.events (
data__filter,
data__options,
data__page,
data__sort,
region
)
SELECT 
'{{ filter }}',
'{{ options }}',
'{{ page }}',
'{{ sort }}',
'{{ region }}'
RETURNING
data,
links,
meta
;

Manifest

# Description fields are for documentation purposes
- name: events
  props:
    - name: region
      value: string
      description: Required parameter for the events resource.
    - name: data
      value: object
      description: |
        An event object.
    - name: filter
      value: object
      description: |
        The search and filter query settings.
    - name: options
      value: object
      description: |
        The global query options that are used. Either provide a timezone or a time offset but not both,
        otherwise the query fails.
    - name: page
      value: object
      description: |
        Pagination settings.
    - name: sort
      value: string
      description: |
        The sort parameters when querying events.
      valid_values: ['timestamp', '-timestamp']