circonus_annotation — создание аннотации в circonus
Новое в версии 2.0.
Обзор
- Создайте событие аннотации с заданной категорией, заголовком и описанием. Дополнительно можно указать время начала, окончания или продолжительность.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- requests (либо >= 2.0.0 для Python 3, либо >= 1.0.0 для Python 2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key обязательно | Ключ API Circonus | |
| category обязательно | Категория аннотации | |
| description обязательно | Описание аннотации | |
| duration | По умолчанию: 0 | Продолжительность аннотации в секундах |
| start | По умолчанию: "I(now)" | Маркер времени начала события в формате Unix |
| stop | По умолчанию: "I(now) + I(duration)" | Маркер времени окончания события в формате Unix |
| title обязательно | Заголовок аннотации |
Примечания
Примечание
- Режим проверки (check mode) не поддерживается.
Примеры
# 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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| annotation сложное | успех | детали созданной аннотации | |
| _cid строка | успех | идентификатор аннотации Пример: /annotation/100000 | |
| _created целое число | успех | маркер времени создания Пример: 1502236928 | |
| _last_modified целое число | успех | маркер времени последнего изменения Пример: 1502236928 | |
| _last_modified_by строка | успех | пользователь, выполнивший последнее изменение Пример: /user/1000 | |
| category строка | успех | категория созданной аннотации Пример: alerts | |
| title строка | успех | заголовок созданной аннотации Пример: WARNING | |
| description строка | успех | описание созданной аннотации Пример: Хост не работает. | |
| start целое число | успех | метка времени, с которой применяется аннотация Пример: Хост не работает. | |
| stop строка | успех | метка времени, с которой аннотация прекращает действовать Пример: Хост не работает. | |
| rel_metrics список | успех | Массив метрик, связанных с этой аннотацией, каждая метрика — строка. Пример: ['54321_kbps'] | |
Статус
Этот модуль помечен как превью, что означает отсутствие гарантии обратной совместимости интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Ник Харринг (@NickatEpic)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/circonus_annotation_module.html
