community.general.librato_annotation module – Create an annotation in librato
Note
This module is part of the community.general collection (version 8.6.4).
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.librato_annotation
.
Synopsis
Create an annotation event on the given annotation stream :name. If the annotation stream does not exist, it will be created automatically
Aliases: monitoring.librato_annotation
Parameters
Parameter |
Comments |
---|---|
Librato account api key |
|
The description contains extra metadata about a particular annotation The description should contain specifics on the individual annotation e.g. Deployed 9b562b2 shipped new feature foo! |
|
The unix timestamp indicating the time at which the event referenced by this annotation ended For events that have a duration, this is a useful way to annotate the duration of the event |
|
See examples |
|
The annotation stream name If the annotation stream does not exist, it will be created automatically |
|
A string which describes the originating source of an annotation when that annotation is tracked across multiple members of a population |
|
The unix timestamp indicating the time at which the event referenced by this annotation started |
|
The title of an annotation is a string and may contain spaces The title should be a short, high-level summary of the annotation e.g. v45 Deployment |
|
Librato account username |
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: none |
Can run in |
|
Support: none |
Will return details on what has changed (or possibly needs changing in |
Examples
- name: Create a simple annotation event with a source
community.general.librato_annotation:
user: [email protected]
api_key: XXXXXXXXXXXXXXXXX
title: App Config Change
source: foo.bar
description: This is a detailed description of the config change
- name: Create an annotation that includes a link
community.general.librato_annotation:
user: [email protected]
api_key: XXXXXXXXXXXXXXXXXX
name: code.deploy
title: app code deploy
description: this is a detailed description of a deployment
links:
- rel: example
href: http://www.example.com/deploy
- name: Create an annotation with a start_time and end_time
community.general.librato_annotation:
user: [email protected]
api_key: XXXXXXXXXXXXXXXXXX
name: maintenance
title: Maintenance window
description: This is a detailed description of maintenance
start_time: 1395940006
end_time: 1395954406