ansible / ansible.builtin / v2.6.0 / module / pagerduty_alert Trigger, acknowledge or resolve PagerDuty incidents | "added in version" 1.9 of ansible.builtin" Authors: Amanpreet Singh (@ApsOps) preview | supported by communityansible.builtin.pagerduty_alert (v2.6.0) — module
pip
Install with pip install ansible==2.6.0
This module will let you trigger, acknowledge or resolve a PagerDuty incident by sending events
# Trigger an incident with just the basic options - pagerduty_alert: name: companyabc service_key: xxx api_key: yourapikey state: triggered desc: problem that led to this trigger
# Trigger an incident with more options - pagerduty_alert: service_key: xxx api_key: yourapikey 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: service_key: xxx api_key: yourapikey state: acknowledged incident_key: somekey desc: "some text for incident's log"
# Resolve an incident based on incident_key - pagerduty_alert: service_key: xxx api_key: yourapikey state: resolved incident_key: somekey desc: "some text for incident's log"
desc: default: Created via Ansible description: - For C(triggered) I(state) - Required. Short description of the problem that led to this trigger. This field (or a truncated version) will be used when generating phone calls, SMS messages and alert emails. It will also appear on the incidents tables in the PagerDuty UI. The maximum length is 1024 characters. - For C(acknowledged) or C(resolved) I(state) - Text that will appear in the incident's log associated with this event. required: false name: description: - PagerDuty unique subdomain. required: true state: choices: - triggered - acknowledged - resolved description: - Type of event to be sent. required: true client: description: - The name of the monitoring client that is triggering this event. required: false api_key: description: - The pagerduty API key (readonly access), generated on the pagerduty site. required: true client_url: description: - The URL of the monitoring client that is triggering this event. required: false service_key: description: - The GUID of one of your "Generic API" services. - This is the "service key" listed on a Generic API's service detail page. required: true incident_key: description: - Identifies the incident to which this I(state) should be applied. - For C(triggered) I(state) - If there's no open (i.e. unresolved) incident with this key, a new one will be created. If there's already an open incident with a matching key, this event will be appended to that incident's log. The event key provides an easy way to "de-dup" problem reports. - For C(acknowledged) or C(resolved) I(state) - This should be the incident_key you received back when the incident was first opened by a trigger event. Acknowledge events referencing resolved or nonexistent incidents will be discarded. required: false