Use this notification plugin to send trigger events to your PagerDuty service.
The plugin requires one parameter:
- subject: This string will be set as the description for the generated incident.
Context variables usable in the subject line:
${job.status}: Job execution status (eg, FAILED, SUCCESS).${job.project}: Job project name.${job.name}: Job name.${job.group}: Job group name.${job.user}: User that executed the job.${job.execid}: Job execution ID.
Installation
Generate jar file using:
./gradlew build
Copy the jar file to the plugins directory:
cp build/libs/pagerduty-notification-X.Y.Z.jar to $RDECK_BASE/libext
and start using it!
Configuration
The plugin only requires the 'service_key' configuration entry. There are two optional configurations if you send requests through an egress proxy.
- service_key: This is the API Key to your service.
Configure the service_key in your project configuration by adding an entry like so: $RDECK_BASE/projects/{project}/etc/project.properties
project.plugin.Notification.PagerDutyNotification.service_key=xx123049e89dd45f28ce35467a08577yz
Or configure it at the instance level: $RDECK_BASE/etc/framework.properties
framework.plugin.Notification.PagerDutyNotification.service_key=xx123049e89dd45f28ce35467a08577yz
- proxy_host (optional): Your egress proxy host.
- proxy_port: Required if proxy_host is set. The port the network egress proxy accepts traffic on.
These can be configured at the project level. Most likely this needs to be configured at the instance level: $RDECK_BASE/etc/framework.properties
framework.plugin.Notification.PagerDutyNotification.proxy_host=foo.example.net
framework.plugin.Notification.PagerDutyNotification.proxy_port=3128
