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