Datadog Events

List events

Query and filter the event stream by time, priority, sources and tags. Returns up to 1000 events.

Inputs

Field

Type

Description

time [required]

The time period range used to filter the event stream

priority

enum

Priority of your events, either low or normal. Allowed enum values: normal,low

sources

string

A comma separated string of sources.

tags

A list indicating what tags, if any, should be used to filter the list of monitors by scope.

unaggregated

boolean

Set unaggregated to true to return all events within the specified [start,end] timeframe.

exclude_aggregate

boolean

Set exclude_aggregate to true to only return unaggregated events where is_aggregate=false in the response.

Outputs

Expand All

Field

Type

Description

events

[object]

An array of events.

id

string

Integer ID of the event.

url

string

URL of the event.

payload

string

Payload of the event.

title

string

The event title.

text

string

The body of the event.

date_happened

number

POSIX timestamp of the event.

priority

enum

The priority of the event. Allowed enum values: normal,low

host

string

Host name to associate with the event.

tags

[string]

A list of tags to apply to the event.

alert_type

enum

If an alert event is enabled, set its type. Allowed enum values: error,warning,info,success,user_update,recommendation,snapshot

source_type_name

string

The type of event being posted.

device_name

string

A device name.

status

string

A status.