Google Stackdriver delivers software for monitoring and managing networks and systems. When events meet predetermined criteria, this integration with xMatters relays critical Stackdriver insight data to the correct people and systems to help them coordinate and resolve incidents faster.
To install this integration in xMatters, simply go to the Integration Directory (Developer > Integrations), click the Available tab and start typing the name of the integration. Once you find the integration, click its tile and then click Create Configuration. Check out the Integration Directory to learn more.
How to set up this integration
After you give your configuration a name and description, type a name to use when sending alerts (so you can easily tell which configuration or integration the alerts are from).
Set the priority you want to assign to events generated by this configuration. You can create multiple configurations if you want to assign different priorities to events coming from Stackdriver.
Choose what xMatters should do when it receives an incident with a 'closed' state from Stackdriver:
- Terminate events for closed incidents: This terminates an existing event in xMatters when the incident is closed in Stackdriver.
- Ignore all closed incidents: xMatters ignores incidents coming from Stackdriver with a closed state. No existing events are terminated and no new event is created.
Select the Include documentation in notifications checkbox if you want to include the information in the Documentation section of the Stackdriver Alerting Policy in the notifications sent by xMatters.
After you save the configuration, xMatters displays the URL that you use for the webhook in Stackdriver – just click Copy and you're ready to head over to Stackdriver.
- Go to Notifications in your Stackdriver account settings.
- Select the Webhooks tab then click Add Webhook.
- Paste the URL you copied from xMatters in the Endpoint URL field and give your webhook a name.
- Click Test Connection.
- This sends a test message to xMatters – this doesn't cause any notifications to be sent, but you can check the Activity Stream to see if the message came through.
- Click Save.
- Go to the settings for the Alerting Policy you want to trigger notifications (or create a new one), and add the xMatters webhook as the notification channel under Notifications.
- You can also add information in the Documentation section — if you selected above to include documentation, this information is sent out with the xMatters notification.
Your integration is now complete!
Use your integration
When Alert Policy thresholds are breached, the integration sends a notification to xMatters, which notifies the appropriate users or on-call resources on their preferred device.
- Create a condition that triggers the Alerting Policy.
- An event is created in xMatters and a notification is sent to the recipients you set up in the configuration.
- Select a response option. The xMatters event is updated, along with any comments added.
After you send the response, you're given the option to open up the Stackdriver incident:
Selecting a response option only updates the event in xMatters. Stackdriver doesn't yet give us the option of changing the state of the Stackdriver incident.