W3cubDocs

/Ansible

circonus_annotation - create an annotation in circonus

New in version 2.0.

Synopsis

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

Requirements (on host that executes module)

  • urllib3
  • requests
  • time

Options

parameter required default choices comments
api_key
yes
Circonus API key
category
yes
Annotation Category
description
yes
Description of annotation
duration
no
Duration in seconds of annotation, defaults to 0
start
no
Unix timestamp of event start, defaults to now
stop
no
Unix timestamp of event end, defaults to now + duration
title
yes
Title of annotation

Examples

# Create a simple annotation event with a source, defaults to start and end time of now
- 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'
# Create an annotation with a duration of 5 minutes and a default start time of now
- 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
# Create an annotation with a start_time and end_time
- 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

This is an Extras Module

For more information on what this means please read Extras Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/circonus_annotation_module.html