community.general.circonus_annotation module – Create an annotation in circonus

Note

This module is part of the community.general collection (version 8.6.8).

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. You need further requirements to be able to use this module, see Requirements for details.

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

Synopsis

  • Create an annotation event with a given category, title and description. Optionally start, end or durations can be provided

Aliases: monitoring.circonus_annotation

Requirements

The below requirements are needed on the host that executes this module.

  • requests (either >= 2.0.0 for Python 3, or >= 1.0.0 for Python 2)

Parameters

Parameter

Comments

api_key

string / required

Circonus API key

category

string / required

Annotation Category

description

string / required

Description of annotation

duration

integer

Duration in seconds of annotation

Default: 0

start

integer

Unix timestamp of event start

If not specified, it defaults to “now”.

stop

integer

Unix timestamp of event end

If not specified, it defaults to “now” + duration.

title

string / required

Title of annotation

Attributes

Attribute

Support

Description

check_mode

Support: none

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • Check mode isn’t supported.

Examples

- name: Create a simple annotation event with a source, defaults to start and end time of now
  community.general.circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations

- name: Create an annotation with a duration of 5 minutes and a default start time of now
  community.general.circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations
    duration: 300

- name: Create an annotation with a start_time and end_time
  community.general.circonus_annotation:
    api_key: XXXXXXXXXXXXXXXXX
    title: App Config Change
    description: This is a detailed description of the config change
    category: This category groups like annotations
    start_time: 1395940006
    end_time: 1395954407

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

annotation

complex

details about the created annotation

Returned: success

_cid

string

annotation identifier

Returned: success

Sample: "/annotation/100000"

_created

integer

creation timestamp

Returned: success

Sample: 1502236928

_last_modified

integer

last modification timestamp

Returned: success

Sample: 1502236928

_last_modified_by

string

last modified by

Returned: success

Sample: "/user/1000"

category

string

category of the created annotation

Returned: success

Sample: "alerts"

description

string

description of the created annotation

Returned: success

Sample: "Host is down."

rel_metrics

list / elements=string

Array of metrics related to this annotation, each metrics is a string.

Returned: success

Sample: ["54321_kbps"]

start

integer

timestamp, since annotation applies

Returned: success

Sample: "Host is down."

stop

string

timestamp, since annotation ends

Returned: success

Sample: "Host is down."

title

string

title of the created annotation

Returned: success

Sample: "WARNING"

Authors

  • Nick Harring (@NickatEpic)