diff --git a/monitoring/librato_annotation b/monitoring/librato_annotation new file mode 100644 index 00000000000..2dc1ea7f002 --- /dev/null +++ b/monitoring/librato_annotation @@ -0,0 +1,171 @@ +#!/usr/bin/python + +import base64 + +DOCUMENTATION = ''' +--- +module: librato_annotation +short_description: create an annotation in librato +description: + - Create an annotation event on the given annotation stream :name. If the annotation stream does not exist, it will be created automatically +version_added: "1.6" +author: Seth Edwards +requirements: + - urllib2 + - base64 +options: + user: + description: + - Librato account username + required: true + default: null + aliases: [] + api_key: + description: + - Librato account api key + required: true + default: null + aliases: [] + name: + description: + - The annotation stream name + - If the annotation stream does not exist, it will be created automatically + required: false + default: null + aliases: [] + title: + description: + - 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 + required: true + default: null + aliases: [] + source: + description: + - A string which describes the originating source of an annotation when that annotation is tracked across multiple members of a population + required: false + default: null + aliases: [] + description: + description: + - The description contains extra meta-data about a particular annotation + - The description should contain specifics on the individual annotation e.g. Deployed 9b562b2: shipped new feature foo! + required: false + default: null + aliases: [] + start_time: + description: + - The unix timestamp indicating the the time at which the event referenced by this annotation started + required: false + default: "the current time" + aliases: [] + end_time: + description: + - The unix timestamp indicating the 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 + required: false + default: null + aliases: [] + links: + description: + - Words go here + - that describe + - this option + required: true or false + default: a string or the word null + aliases: [] + + +''' + +EXAMPLES = ''' +# Create a simple annotation event with a source +- librato_annotation: + user: user@example.com + api_key: XXXXXXXXXXXXXXXXX + title: 'App Config Change' + source: 'foo.bar' + description: 'This is a detailed description of the config change' + +# Create an annotation that includes a link +- librato_annotation: + user: user@example.com + 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' } + +# Create an annotation with a start_time and end_time +- librato_annotation: + user: user@example.com + api_key: XXXXXXXXXXXXXXXXXX + name: 'maintenance' + title: 'Maintenance window' + description: 'This is a detailed description of maintenance' + start_time: 1395940006 + end_time: 1395954406 +''' + + +try: + import urllib2 + HAS_URLLIB2 = True +except ImportError: + HAS_URLLIB2 = False + +def post_annotation(module): + user = module.params['user'] + api_key = module.params['api_key'] + name = module.params['name'] + title = module.params['title'] + + url = 'https://metrics-api.librato.com/v1/annotations/%s' % name + params = {} + params['title'] = title + + if module.params['source'] != None: + params['source'] = module.params['source'] + if module.params['description'] != None: + params['description'] = module.params['description'] + if module.params['start_time'] != None: + params['start_time'] = module.params['start_time'] + if module.params['end_time'] != None: + params['end_time'] = module.params['end_time'] + if module.params['links'] != None: + params['links'] = module.params['links'] + + json_body = module.jsonify(params) + + headers = {} + headers['Content-Type'] = 'application/json' + headers['Authorization'] = b"Basic " + base64.b64encode(user + b":" + api_key).strip() + req = urllib2.Request(url, json_body, headers) + try: + response = urllib2.urlopen(req) + except urllib2.HTTPError as e: + module.fail_json(msg="Request Failed", reason=e.reason) + response = response.read() + module.exit_json(changed=True, annotation=response) + +def main(): + + module = AnsibleModule( + argument_spec = dict( + user = dict(required=True), + api_key = dict(required=True), + name = dict(required=False), + title = dict(required=True), + source = dict(required=False), + description = dict(required=False), + start_time = dict(required=False, default=None, type='int'), + end_time = dict(require=False, default=None, type='int'), + links = dict(type='list') + ) + ) + + post_annotation(module) + +from ansible.module_utils.basic import * +main()