salt.modules.pagerduty

Module for Firing Events via PagerDuty

New in version 2014.1.0: (Hydrogen)

depends:
  • pygerduty python module
configuration:

This module can be used by either passing a jid and password directly to send_message, or by specifying the name of a configuration profile in the minion config, minion pillar, or master config.

For example:

my-pagerduty-account:
    pagerduty.api_key: F3Rbyjbve43rfFWf2214
    pagerduty.subdomain: mysubdomain
salt.modules.pagerduty.create_event(service_key, description, details, incident_key=None, profile=None)

Create an event in PagerDuty. Designed for use in states.

CLI Example:

pagerduty.create_event <service_key> <description> <details> profile=my-pagerduty-account

The following parameters are required:

service_key
This key can be found by using pagerduty.list_services.
description
This is a short description of the event.
details
This can be a more detailed description of the event.
profile
This refers to the configuration profile to use to connect to the PagerDuty service.
salt.modules.pagerduty.list_incidents(profile)

List services belonging to this account

CLI Example:

pagerduty.list_incidents my-pagerduty-account
salt.modules.pagerduty.list_services(profile)

List services belonging to this account

CLI Example:

pagerduty.list_services my-pagerduty-account

Current Salt release: 2014.1.6

Docs for previous releases on salt.rtfd.org.

Previous topic

salt.modules.pacman

Next topic

salt.modules.pam

Upcoming SaltStack Events