pagerduty_alert – Вызов, подтверждение или разрешение инцидентов PagerDuty
Новое в версии 1.9.
Описание
- Этот модуль позволяет вызывать, подтверждать или разрешать инцидент PagerDuty, отправляя события
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Доступ к API PagerDuty
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_key - / обязательно | Ключ API PagerDuty (только для чтения), сгенерированный на сайте PagerDuty. | |
| client - | Имя клиента мониторинга, вызывающего это событие. | |
| client_url - | URL клиента мониторинга, вызывающего это событие. | |
| desc - | По умолчанию: "Создано через Ansible" | Для triggered состояния - Обязательно. Краткое описание проблемы, которая привела к этому вызову. Это поле (или его усеченная версия) будет использоваться при создании телефонных звонков, SMS-сообщений и электронных писем об уведомлениях. Оно также будет отображаться в таблицах инцидентов в пользовательском интерфейсе PagerDuty. Максимальная длина составляет 1024 символа.Для acknowledged или resolved состояния - Текст, который будет отображаться в журнале инцидента, связанном с этим событием. |
| incident_key - добавлен в 2.7 | Идентифицирует инцидент, к которому должно быть применено данное состояние. Для triggered состояния - Если нет открытого (т.е. неразрешенного) инцидента с этим ключом, будет создан новый. Если уже существует открытый инцидент с совпадающим ключом, это событие будет добавлено в журнал этого инцидента. Ключ события позволяет легко "устранить дублирование" отчетов о проблемах.Для acknowledged или resolved состояния - Это должен быть incident_key, полученный при первом открытии инцидента событием-вызовом. События подтверждения, ссылающиеся на разрешенные или несуществующие инциденты, будут отброшены. | |
| integration_key - / обязательно добавлен в 2.7 | GUID одной из ваших служб "Generic API". Это "ключ интеграции", указанный на вкладке "Интеграции" в службе PagerDuty. | |
| name - | Уникальное доменное имя PagerDuty. Устарело. Оно не используется с API PagerDuty REST v2. | |
| service_id - / обязательно добавлен в 2.7 | ID службы PagerDuty, при возникновении, подтверждении или разрешении инцидентов. | |
| service_key - | GUID одной из ваших служб "Generic API". Устарело. Пожалуйста, используйте integration_key. | |
| state - / обязательно |
| Тип события, которое нужно отправить. |
Примеры
# Trigger an incident with just the basic options
- pagerduty_alert:
name: companyabc
integration_key: xxx
api_key: yourapikey
service_id: PDservice
state: triggered
desc: problem that led to this trigger
# Trigger an incident with more options
- pagerduty_alert:
integration_key: xxx
api_key: yourapikey
service_id: PDservice
state: triggered
desc: problem that led to this trigger
incident_key: somekey
client: Sample Monitoring Service
client_url: http://service.example.com
# Acknowledge an incident based on incident_key
- pagerduty_alert:
integration_key: xxx
api_key: yourapikey
service_id: PDservice
state: acknowledged
incident_key: somekey
desc: "some text for incident's log"
# Resolve an incident based on incident_key
- pagerduty_alert:
integration_key: xxx
api_key: yourapikey
service_id: PDservice
state: resolved
incident_key: somekey
desc: "some text for incident's log"
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Amanpreet Singh (@ApsOps)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/pagerduty_alert_module.html
