Use this notification plugin to send alert events to your OpsGenie 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.id}
: Job ID.${job.status}
: Job execution status (eg, FAILED, SUCCESS).${job.project}
: Job project name.${job.name}
: Job name.${job.group}
: Job group name.${job.username}
: User that executed the job.${job.user.email}
: Email address of user that executed the job.${job.execid}
: Job execution ID.${job.retryAttempt}
: Retry attempt number.${job.wasRetry}
: True if execution is retry.
Installation
Copy the groovy script to the plugins directory:
cp src/OpsGenieNotification.groovy to $RDECK_BASE/libext
and start using it!
Configuration
The plugin only requires the 'api_key' configuration entry. There are also a few optional configurations.
- api_key: This is the API Key to your service.
Configure the api_key in your project configuration by adding an entry like so: $RDECK_BASE/projects/{project}/etc/project.properties
project.plugin.Notification.OpsGenieNotification.api_key=xx123049e89dd45f28ce35467a08577yz
Or configure it at the instance level: $RDECK_BASE/etc/framework.properties
framework.plugin.Notification.OpsGenieNotification.api_key=xx123049e89dd45f28ce35467a08577yz
All options
Option | Scope | Default | Required | Description |
---|---|---|---|---|
api_key |
Any | None | Yes | Integration API Key |
message |
Any | ${job.status} [${job.project}] \"${job.name}\" |
Yes | Message template. |
description |
Any | ${job.status} [${job.project}] \"${job.name}\" run by ${job.user} (#${job.execid}) [${job.href}] |
No | Description template. |
alias |
Any | ${job.id} |
No | alias template. |
source |
Any | ${job.href} |
No | Source template. |
proxy_host |
Project | None | Yes | Your egress proxy host. |
proxy_port |
Project | None | If proxy_host is set |
the port the network egress proxy accepts traffic on. |