Skip to content

datadog post-event

post events to the stream

Description

post events to the stream

Synopsis

datadog post-event
    [--site <site>]
    [--aggregation_key <aggregation_key>]
    [--alert_type <alert_type>]
    [--date_happened <date_happened>]
    [--device <device>]
    [--host <host>]
    [--priority <priority>]
    [--related_event <related_event>]
    [--source_type <source_type>]
    [--tags <tags>]
    --text <text>
    --title <title>

Arguments

site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default: input.site      Attributes: optional

aggregation_key - (string)

     An arbitrary string to use for aggregation
     Example: --aggregation_key "aggregation_key-1"
     Default: _None_      Attributes: optional

     Validation:
         max length: 100

alert_type - (string)

     If an alert event is enabled, set its type
     Example: --alert_type "error"
     Default: _None_      Attributes: optional

     Validation:
         allowed values: error, warning, info, success, user_update, recommendation, snapshot

date_happened - (int)

     POSIX timestamp of the event. Limited to events no older than 18 hours
     Example: --date_happened 1
     Default: _None_      Attributes: optional

device - (string)

     A device name.
     Example: --device "device-1"
     Default: _None_      Attributes: optional

host - (string)

     Host name to associate with the event. Any tags associated with the host are also applied to this event
     Example: --host "host-1"
     Default: _None_      Attributes: optional

priority - (string)

     The priority of the event
     Example: --priority "normal"
     Default: _None_      Attributes: optional

     Validation:
         allowed values: normal, low

     ID of the parent event
     Example: --related_event 1
     Default: _None_      Attributes: optional

source_type - (string)

     The type of event being posted
     Example: --source_type "source_type-1"
     Default: _None_      Attributes: optional

tags - (string)

     Tags to apply to the event
     Example: --tags "tags-1"
     Default: _None_      Attributes: optional, multiple allowed

text - (string)

     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 %%%
     Example: --text "text-1"
     Default: _None_      Attributes: required

title - (string)

     The event title
     Example: --title "title-1"
     Default: _None_      Attributes: required

Examples

Input: 

!datadog post-event --title "testTitle" --text "testtext"
Output: 
ID                  TITLE       DESCRIPTION PRIORITY    TAGS    OCCURED-ON  PARENT
6873692775913593094 testTitle   testtext    null        null    1673966882  null

Access Control

To use this command, you need access to the following:

Field Value
Action "create"
Service Type "datadog"
Service Instance
Namespace
Object Type "event"
Object ID

Please see Access Control for details.