Create Event

This endpoint allows you to post events to the stream. Tag them, set priority and event aggregate them with other events.

caution

This action does not support OAuth connections.

External Documentation

To learn more, visit the Datadog documentation.

Basic Parameters

Parameter	Description
Alert Type	If an alert event is enabled, set its type. For example, error, warning, info, success, user_update, recommendation, and snapshot.
Date Happened	POSIX timestamp of the event. Must be sent as an integer (i.e. no quotes). Limited to events no older than 7 days.
Priority	The priority of the event. For example, normal or low.
Text	The body of the event. Limited to 4000 characters. The text supports markdown. To use markdown in the event text, start the text block with %%% \n and end the text block with \n %%%. Use msg_text with the Datadog Ruby library.
Title	The event title. Limited to 100 characters. Use msg_title with the Datadog Ruby library.

Advanced Parameters

Parameter	Description
Aggregation Key	An arbitrary string to use for aggregation. Limited to 100 characters. If you specify a key, all events using that key are grouped together in the Event Stream.
Device Name	A device name.
Host	Host name to associate with the event. Any tags associated with the host are also applied to this event.
ID	Integer ID of the event.
Payload	Payload of the event.
Related Event ID	ID of the parent event. Must be sent as an integer (i.e. no quotes).
Source Type Name	The type of event being posted. Option examples include nagios, hudson, jenkins, my_apps, chef, puppet, git, bitbucket, etc. A complete list of source attribute values available here.
Tags	A list of tags to apply to the event.
URL	URL of the event.

Example Output

{
    "alert_type": "info",
    "date_happened": 0,
    "device_name": "device_name",
    "host": "host",
    "id": 6,
    "payload": "{}",
    "priority": "normal",
    "related_event_id": 1,
    "source_type_name": "source_type_name",
    "status": "status",
    "tags": [
        "environment:test"
    ],
    "text": "Oh boy!",
    "title": "Did you hear the news today?",
    "url": "url"
}

Workflow Library Example

Create Event with Datadog and Send Results Via Email

Preview this Workflow on desktop