This action enables the integration of Victorops into stackstorm. It is capable of performing the following actions
- Launch an incident by giving
severity ('INFO', 'WARNING', 'CRITICAL')
,entity
and amessage
- Send acknowledgment of any incident using its
entity
id and amessage
indicating acknowledgment - Recover an incident by giving
entity
id and amessage
indicating how the incident was recovered
Copy the example configuration in victorops.yaml.example
to /opt/stackstorm/configs/victorops.yaml
and edit as required.
It must contain:
- `api_key`` - API token for Victorops integration - see below
routing_key
- An API token generated in the admin interface
You can also use dynamic values from the datastore. See the docs for more info.
Once you sign in to your Victorops account go to the settings tab and click in Integrations button. A table will come at the right side, click on REST endpoint, It will spit out a Post URL, you just need to copy the part after generic
becuase the first part is same for all. Copy and paste that part of API key in the config.yaml file.
Routing key routes the incident information to the team that you mention. If there is one team/group you can mention it in config file otherwise you can pass an optional parameter of notify_group
when opening an incident to notify any other team/group for any incident. Mention one routing key in config file so that if you dont want to pass parameter again and again it will be picked up by default from config file. The process of adding routing key is described below:
Now to get the routing key you need to scroll down and you will see Incident Routing
section. Click on Add Rule
, then add the name of routing key and select the team to which you want to route the incident to. Once thats done copy the name that you just gave in routing key and paste it into the config.yaml
file. The following images illustrate the steps.
ack_incident
- Acknowledge a triggered event on victoropsopen_incident
- Triggers the event on VictorOps with the given parametersrecover_incident
- Recover a triggered event on victorops