Created Notify_opsgenie (markdown)

master
Chris Caron 2020-12-30 16:19:43 -05:00
parent ddc42c7e28
commit 9ac6fe2858
1 changed files with 50 additions and 0 deletions

50
Notify_opsgenie.md Normal file

@ -0,0 +1,50 @@
## Opsgenie Notifications
* **Source**: https://www.opsgenie.com
* **Icon Support**: No
* **Message Format**: Text
* **Message Limit**: 15000 Characters per Message
### Account Setup
1. Visit https://www.opsgenie.com to create your account.
2. [Generate your Integration API Key](https://app.opsgenie.com/settings/integration/add/API/)
### Syntax
The syntax is as follows:
- `opsgenie://{apikey}/`
- `opsgenie://{apikey}/@{user}`
- `opsgenie://{apikey}/@{user1}/@{user2}/@{userN}`
- `opsgenie://{apikey}/*{schedule}`
- `opsgenie://{apikey}/*{schedule1}}/*{schedule2}`}/*{scheduleN}``
- `opsgenie://{apikey}/^{escalation}`
- `opsgenie://{apikey}/^{escalation1}/^{escalation2}/^{escalationN}`
- `opsgenie://{apikey}/#{team}`
- `opsgenie://{apikey}/#{team1}/#{team2}/#{teamN}`
**Note:** If no prefix character is specified, then the target is presumed to be a user (an `@` symbol is presumed to be in front of it).
You can also mix/match the targets:
- `opsgenie://{apikey}/@{user}/#{team}/*{schedule}/^{escalation}`
### Parameter Breakdown
| Variable | Required | Description
| ----------- | -------- | -----------
| apikey | Yes | This is the API Key associated with your Opsgenie account.
| user | No | The user you wish to notify; this can be a `username`, `email`, or `uuid4`. This is the assumed default target type to notify, but it is advised you prefix all users with a `@` symbol to eliminate any ambiguity.
| team | No | The team you wish to notify; this can be the team name itself, or or `uuid4` associated with it. <br>**Note:** Teams must be prefixed with a `#` symbol.
| schedule | No | The schedule you wish to notify; this can be the schedule name itself, or or `uuid4` associated with it. <br>**Note:** Schedules must be prefixed with a `*` symbol.
| escalation | No | The escalation you wish to notify; this can be the escalation name itself, or or `uuid4` associated with it. <br>**Note:**Escalations must be prefixed with a `^` symbol.
| region | No | The 2 character region code. By default this is set to `us` if not specified. Europeans must set this to `eu` to work correctly.
| batch | No | Set it to **Yes** if you want all identified targets to be notified notified in batches (instead of individually). By default this is set to **No**.
| tags | No | A comma separated list of tags you can associate with your Opsgenie message
| priority | No | The priority to associate with the message. It is on a scale between 1 and 5. The default value is `3` if not specified.
| alias | No | The alias to associate with the message.
| entity | No | The entity to associate with the message.
#### Example
Send a Opsgenie notification to all devices associated with a project:
```bash
# Assume:
# - our {apikey} is a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty
apprise -vv -t "Test Message Title" -b "Test Message Body" \
onesignal://a6k4ABnck26hDh8AA3EDHoOVdDEUlw3nty
```