community.general.datadog_event – Posts events to Datadog service

Note

This plugin is part of the community.general collection (version 3.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.datadog_event.

Synopsis

Parameters

Parameter

Comments

aggregation_key

string

An arbitrary string to use for aggregation.

alert_type

string

Type of alert.

Choices:

  • error

  • warning

  • info ← (default)

  • success

api_host

string

added in 3.3.0 of community.general

DataDog API endpoint URL.

api_key

string / required

Your DataDog API key.

app_key

string / required

Your DataDog app key.

date_happened

integer

POSIX timestamp of the event.

Default value is now.

host

string

Host name to associate with the event.

If not specified, it defaults to the remote system’s hostname.

priority

string

The priority of the event.

Choices:

  • normal ← (default)

  • low

tags

list / elements=string

Comma separated list of tags to apply to the event.

text

string / required

The body of the event.

title

string / required

The event title.

validate_certs

boolean

If no, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.

Choices:

  • no

  • yes ← (default)

Examples

- name: Post an event with low priority
  community.general.datadog_event:
    title: Testing from ansible
    text: Test
    priority: low
    api_key: 9775a026f1ca7d1c6c5af9d94d9595a4
    app_key: j4JyCYfefWHhgFgiZUqRm63AXHNZQyPGBfJtAzmN

- name: Post an event with several tags
  community.general.datadog_event:
    title: Testing from ansible
    text: Test
    api_key: 9775a026f1ca7d1c6c5af9d94d9595a4
    app_key: j4JyCYfefWHhgFgiZUqRm63AXHNZQyPGBfJtAzmN
    tags: 'aa,bb,#host:{{ inventory_hostname }}'

- name: Post an event with several tags to another endpoint
  community.general.datadog_event:
    title: Testing from ansible
    text: Test
    api_key: 9775a026f1ca7d1c6c5af9d94d9595a4
    app_key: j4JyCYfefWHhgFgiZUqRm63AXHNZQyPGBfJtAzmN
    api_host: 'https://example.datadoghq.eu'
    tags:
      - aa
      - b
      - '#host:{{ inventory_hostname }}'

Authors

  • Artūras arturaz Šlajus (@arturaz)

  • Naoya Nakazawa (@n0ts)