Connect your observability stack to our platform
Integrations
tab and click on the `Create New Integration button.
Webhook
Integration.
Edit
tab of the integration details page. Here, you can make some important high-level adjustments.
Snooze Settings
for the integration.
Include Snoozed
filter in the incident overview.Maintenance Windows
for the integration.
Webhook
, you can send HTTP requests to the integration’s URL. Every request sent to this address will show up as a new payload in the Payload Mapping
tab (see below), from which we’ll extract attributes and map these to incidents. Moreover, you can adjust the authentication setting for your URL.
Payload Mapping
tab.json-edit-react
component for better visability and usability.cURL
command to send a form post to a webhook integration. The payload will show up under the field Latest Payloads
. Please note that you need to adjust the URL to your unique integration’s URL.
attribute
in attributes
we will evaluate all mappings from the first to the last element. The result of a mapping will be passed on to the next mapping element as an input. The last result will be the attribute’s value. In this example, the attribute Status
is first mapped by a jsonPath and then by a map evaluation. See below for more about our evaluation types and mapping variables.$.query.utm
contains the value Medium
or High
to define the Severity.allquiet_integration_mapping
resources.
Property | Description | Allowed Values |
---|---|---|
CorrelationId | Optional | Use this attribute to uniquely identify and correlate your incidents. If omitted, a hash of all attributes is used to uniquely identify the incident. |
Status | Required | Open , Resolved |
Severity | Required | Minor , Warning , Critical |
Title | Optional | If omitted, defaults to your integration’s name |
Type | Description | Values | |
---|---|---|---|
Image | Optional | Boolean | If your payload includes a URL, you can use this as an additional specification of an object to show the image in All Quiet |
Hide in Previews | Optional | Boolean | When activated for attributes, these will not be shown in incident email and on the incident overview in Web and App, but only in the incident details. |
Grouping | Optional | Boolean | When setting Grouping = true for certain attributes, incidents that have the same values for these attributes will be grouped as long as one of these incidents is open and not resolved. If you set isGroupingKey = true for more than one attribute, incidents will only be grouped if the values for all attributes match. By including “groupingWindowInSeconds” in your mapping, any new incidents that match the grouping criteria will only create incidents within the group within the grouping window that is defined by seconds since last update of any incident in the group. After the grouping window is over, new incidents will create new incident groups and alert your on-call colleagues. |
Type | Description |
---|---|
jsonPath | A JSONPath expression to map JSON (goessner.net/articles/JsonPath) |
xPath | A XPath expression to map HTML or XML. ( w3schools) |
regex | A regular expression to extract parts of text. The regex is evaluated with the .NET/C# flavor. If groups are matched, the named group “result” is returned. If no group is named “result” the last group is returned. If no groups are found the whole match is returned. ( regex101.com) |
map | A simple map expression mapping values from A to B. The expression A->1,B->2,->3 will map the value “A” to “1” and “B” to “2” and fallback to “3” if no match is found. You can also omit the fallback. The result will then evaluate to the original value. |
static | A static string. The result will always be this string. |
{{ previousIncident.status }}
. Variables are evaluated once all mappings within an attribute have been evaluated. The names are case-insensitive.
You can reference the current incident with {{ currentIncident.someAttributeName }}
and the previous incident with {{ previousIncident.someAttributeName }}
.
$.headers[?(@.field=='Return-Path')].value
for the following JSON:
//table/tr[td='Server']/td[2]
for the following HTML:
[: ](?[^: ]*)$
for the following text: