Email integration with Incident Response
Integrate Incident Response with any service capable of sending email alerts. Incident Response opens and triggers an alert when it receives an email to this integration email address. Events and alerts from monitoring tools can also be sent as emails after making sure that the payload is mapped correctly.
Before you begin
Role required: Responder, Manager, or Administrator
- Log in to Incident Response.
On the navigation pane, click Integrations.
- Click the Email integration card.
On the form, fill the fields.
Field Description Name Name of the integration. Status Status of the integration such as enabled or disabled.Note: You can modify this field only after the webhook is generated. Description Brief summary about the services of the integration. Integration URL The URL of the home page of the monitoring tool that sends alerts. Tags Tags that can help users search for the integration. Service Name of the service that you want to associate with the integration.
A service represents a functional outcome like networking, payments, or HR services, that is owned by one team. You might need multiple tool integrations to monitor each technical service and receive events from those tools.
Click Generate email.
An email address is generated. Incident Response creates an alert for each email that is sent to the generated email address.Copy the following items. You need it when configuring email alerts:
The sample payload format is as follows:
- webhook by clicking the copy icon ().
- payload by clicking Copy payload to clipboard.
severity: $SEVERITY description: $DESCRIPTION source: $SOURCE source_id: $SOURCE_ID event_time: $EVENT_TIME resource_name: $RESOURCE_NAME type: $EVENT_TYPE metric_name: $METRIC_NAME state:$STATE other_info: $OTHER_INFONote:
- You must populate the
- If incorrect value is provided for severity, then alert will be created with a severity of 4.
event_time, any UNIX epoch value is acceptable.
- Click Save.